Skip to main content

Overview

Let’s break down how each of these work.

Email address and password

This is the only authentication mechanism where PlanetScale maintains user credentials. Additionally, users can opt to configure two-factor authentication (2FA). This asks for your password and something you have: an authenticator app, a passkey, or a hardware security key. If your passkey confirms it’s you with Face ID, Touch ID, or a PIN, it can also sign you in without a password. Recovery codes are a backup if you lose access to your authenticator app or keys.

Single sign-on

Users can authenticate with their chosen corporate identity provider (i.e. Okta) instead of maintaining passwords with PlanetScale. Once SSO is enabled for an organization, all members are redirected through that identity provider’s authentication flow. Moving forward, they must pass through SSO to access their PlanetScale account.

OAuth via GitHub

Users can authenticate with PlanetScale using their GitHub account.
PlanetScale doesn’t maintain the passwords for these accounts. Losing access to your GitHub account prevents accessing your PlanetScale account.
Enabling SSO removes OAuth access for all members of your organization, meaning they will no longer be able to sign in with their GitHub credentials.

Switch to email and password

You can stop signing in with GitHub and sign in with your email address and a password instead.
2
In the Sign in with GitHub section, click “Disconnect GitHub”.
3
Click “Confirm on GitHub” and approve the sign-in on GitHub.
4
Enter and confirm a new password, then click “Disconnect GitHub”.
Signing in with GitHub stops working for your account, and you are signed out of PlanetScale in your other browsers. Your account then works like any other email and password account, including multi-factor authentication.
Accounts that belong to an organization using SSO can’t disconnect GitHub.

Revoke all sessions

If you lose a device, or think someone else might be signed in to your account, you can revoke all of your sessions. This:
  • Signs you out of PlanetScale in every other browser. The browser you use to revoke your sessions stays signed in.
  • Revokes your pscale CLI logins.
  • Revokes the OAuth applications you authorized, such as MCP clients.
It also cancels any CLI login or application authorization you approved that hasn’t finished yet. Organization service tokens aren’t affected, because they belong to the organization.
2
In the Revoke all sessions section, click “Revoke all sessions”.
3
If you’re asked to confirm access to your account, confirm it.
4
Select the checkbox to confirm that your other browsers, CLI logins, and applications will need to sign in again, then click “Revoke all sessions”.
To keep using the CLI, run pscale auth login. Reauthorize any applications you still use. The event is recorded in your security log.

Need help?

Get help from the PlanetScale Support team, or join our Discord community to see how others are using PlanetScale.