Skip to main content

Downloading your enterprise account's single sign-on recovery codes

To ensure that you can access GitHub Enterprise Cloud if your identity provider (IdP) is unavailable, you should download your enterprise account's single sign-on (SSO) recovery codes.

Who can use this feature?

Enterprise owners can download the SSO recovery codes for the enterprise account.

In the event that your IdP is unavailable, you can use a recovery code to sign in and access your enterprise on GitHub.com. For more information, see "Accessing your enterprise account if your identity provider is unavailable."

If you did not save your recovery codes when you configured SSO, you can still access the codes from your enterprise's settings.

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises.

  2. In the list of enterprises, click the enterprise you want to view.

  3. In the enterprise account sidebar, click Settings.

  4. Under Settings, click Authentication security.

  5. Under either "Require SAML authentication" or "Require OIDC authentication", click Save your recovery codes.

    Note: OIDC SSO is only available for Enterprise Managed Users. For more information, see "About Enterprise Managed Users."

    Screenshot of the "Authentication security" screen. The "Save your recovery codes" hyperlink is highlighted with an orange outline.

  6. To save your recovery codes, click Download, Print, or Copy.