SSO - GitHub

Allow Foxpass users to log in to Github via SSO

📘

Note: SAML logins with GitHub only work with a GitHub Enterprise account

You must upgrade your organization's account if you are on the Team or Free plan tier.

SSO Configuration

Configuring GitHub as a service provider

  1. Click the 'enable' button for GitHub the SSO - Service Providers page. Optionally select any specific Users or Groups to be allowed for SSO and then click the Save button.
  2. Click on the 'IDP Certificate' button to download the Foxpass IDP Certificate file.
  3. Configure the GitHub service provider in Foxpass with the following custom fields:
key: orgName
value: <your GitHub organization's name>
GitHub configurationGitHub configuration

GitHub configuration

  1. Log in to your GitHub organization's account page.
  2. Navigate to Organization security > SAML single sign-on.
  3. Check the Enable SAML authentication box and set up the IDP using the following settings:
Sign on URL: https://console.foxpass.com/settings/sso/login/
Issuer: foxpass.com

Upload the certificate from step 2 in the Public certificate box.

GitHub IDP settingsGitHub IDP settings

GitHub IDP settings

  1. Click the Test SAML configuration button to authenticate via Foxpass. If you do not have an active Foxpass session, you will be redirected to log into Foxpass using your email, password, and MFA code.
  2. You will then be redirected back to GitHub and given the option to save the configuration if the SAML request was successful. If there are any errors, GitHub will display them.

Do not hesitate to reach out to us if you have any feedback or issues.