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 this article

In the event that your IdP is unavailable, you can use a recovery code to sign in and access your enterprise on GitHub. 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.

Downloading codes for an enterprise with personal accounts

  1. In the top-right corner of GitHub, click your profile photo.

  2. Click Your enterprises, then click the enterprise you want to view.

  3. On the left side of the page, in the enterprise account sidebar, click Settings.

  4. Under Settings, click Authentication security.

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

    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.

Downloading codes for an enterprise with Enterprise Managed Users

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

  2. On the left side of the page, in the enterprise account sidebar, click Identity provider.

  3. Under Identity Provider, click Single sign-on configuration.

  4. Under either "SAML single sign-on" or "OIDC single sign-on", click Save your recovery codes.

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