Skip to main content

Accessing your enterprise account if your identity provider is unavailable

You can sign into GitHub Enterprise Cloud even if your identity provider is unavailable by bypassing single sign-on (SSO) with a recovery code.

Enterprise owners can use a recovery code to access an enterprise account.

You can use a recovery code to access your enterprise account when a authentication configuration error or an issue with your identity provider (IdP) prevents you from using SSO.

In order to access your enterprise account this way, you must have previously downloaded and stored the recovery codes for your enterprise. For more information, see "Downloading your enterprise account's single sign-on recovery codes."

You can only use recovery codes once and you must use your codes in consecutive order. Recovery codes grant access for 24 hours.

Note: If your enterprises uses Enterprise Managed Users, you must sign in as the setup user to use a recovery code.

  1. At the bottom of the single sign-on dialog, click Use a recovery code to bypass single sign-on.

    Screenshot of the link to enter your recovery code

  2. In the "Recovery Code" field, type your recovery code.

    Screenshot of the field to enter your recovery code

  3. Click Verify.

    Screenshot of the button to verify your recovery code

After you've used a recovery code, make sure to note that the code is no longer valid. You will not be able to reuse the recovery code.