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 even if the identity provider for the organization is unavailable.

SAML single sign-on is available with GitHub Enterprise Cloud. For more information, see "GitHub's products."

Did this doc help you?

Recovery codes should not be shared or distributed. We recommend saving them with a password manager such as LastPass, 1Password, or Keeper.

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

    Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization.

    organization icons

  3. Under your organization name, click Settings.

    Organization settings button

  4. In the left sidebar, click Organization security.

    Organization security settings

  5. Under "SAML single sign-on", in the note about recovery codes, click Save your recovery codes.

    Link to view and save your recovery codes

  6. 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 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.

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

Further reading

Did this doc help you?