SSO Authentication

This document describes how to log in to the TiDB Cloud console via basic Single Sign-on (SSO) authentication, which is quick and convenient.

TiDB Cloud supports SSO authentication for Google, GitHub, and Microsoft accounts. If you log in to TiDB Cloud via SSO authentication, because your ID and credentials are stored on the third-party Google, GitHub, and Microsoft platforms, you will not be able to modify your account password and enable multi-factor authentication (MFA) using the TiDB console.

Sign in with Google SSO

To sign in with your Google account, take the following steps:

1. Go to the TiDB Cloud login page.

2. Click Sign in with Google. You will be directed to the Google login page.

3. Follow the on-screen instructions to enter your Google username and password.

   If the login is successful, you will be directed to the TiDB Cloud console.

   Note

   • If this is the first time you sign in with Google, you will be asked whether to accept TiDB Cloud terms. After you read and agree with the terms, you will see the TiDB Cloud welcome page and then be directed to the TiDB Cloud console.
   • If you have enabled 2-Step Verification (also called two-factor authentication) for your Google account, you will also need to provide the verification code after entering your username and password.

Sign in with GitHub SSO

To sign in with your GitHub account, take the following steps:

1. Go to the TiDB Cloud login page.

2. Click Sign in with GitHub. You will be directed to the GitHub login page.

3. Follow the on-screen instructions to enter your GitHub username and password.

   If the login is successful, you will be directed to the TiDB Cloud console.

   Note

   • If this is the first time you sign in with GitHub, you will be asked whether to accept TiDB Cloud terms. After you read and agree with the terms, you will see the TiDB Cloud welcome page and then be directed to the TiDB Cloud console.
   • If you have configured two-factor authentication for your GitHub account, you will also need to provide the verification code after entering your username and password.

Sign in with Microsoft SSO

To sign in with your Microsoft account, take the following steps:

1. Go to the TiDB Cloud login page.

2. Click Sign in with Microsoft. You will be directed to the Microsoft login page.

3. Follow the on-screen instructions to enter your Microsoft username and password.

   If the login is successful, you will be directed to the TiDB Cloud console.

   Note

   • If this is the first time you sign in with Microsoft, you will be asked whether to accept TiDB Cloud terms. After you read and agree with the terms, you will see the TiDB Cloud welcome page and then be directed to the TiDB Cloud console.
   • If you have set up two-step verification for your Microsoft account, you will also need to provide the verification code after entering your username and password.