Skip to main content

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

Organization administrators 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 such as LastPass or 1Password.

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Next to the organization, click Settings. The settings button

  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. Link to view and save your recovery codes

  5. Save your recovery codes by clicking Download, Print, or Copy. Buttons to download, print, or copy your recovery codes

    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