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. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  2. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  3. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  4. In the left sidebar, click Authentication security. Security tab in the enterprise account settings sidebar

  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 button to test SAML configuration before enforcing

  6. To save your recovery codes, click Download, Print, or Copy. Screenshot of the buttons to download, print, or copy your recovery codes