Skip to main content

Downloading your organization's SAML single sign-on recovery codes

Organization owners should download their organization's SAML single sign-on recovery codes to ensure that they can access GitHub Enterprise Cloud even if the identity provider for the organization is unavailable.

Recovery codes should not be shared or distributed. We recommend saving them with a password manager.

  1. In the upper-right corner of GitHub.com, select your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Next to the organization, click Settings.

  3. In the "Security" section of the sidebar, click Authentication security.

  4. Under "SAML single sign-on", in the note about recovery codes, click Save your recovery codes. Screenshot of the "SAML single sign-on" section. A link, labeled "Save your recovery codes," is highlighted with an orange outline.

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

    Note: Your recovery codes will help get you back into GitHub Enterprise Cloud if your IdP is unavailable. If you generate new recovery codes the recovery codes displayed on the "Single sign-on recovery codes" page are automatically updated.

  6. Once you use a recovery code to regain access to GitHub Enterprise Cloud, it cannot be reused. Access to GitHub Enterprise Cloud will only be available for 24 hours before you'll be asked to sign in using single sign-on.

Further reading