Torii integrates with GitHub Enterprise and syncs the user list into Torii.

Requirements:

1. A GitHub Enterprise Cloud account

2. Users are authenticated using SAML single sign-on.

3. Users are provisioned by an Identity Provider using SCIM.

Instructions:

1. Create a personal access token on GitHub with the admin:org scope.

2. Authorize the personal access token for use with SAML single sign-on.

3. Add the access token on the Torii Integrations page.

Why is the admin: org scope required?

GitHub requires the admin:org scope for its SCIM API. Even when using GitHub in read-only mode, the admin:org is required. GitHub does not provide a way to provide a different set of scopes in order to access the required data.

As a technical user of GitHub, how can I verify the integration will work?

This isn't mandatory, but you can verify the access token was created successfully before connecting it out to Torii.

For technical users: verify by trying to access the SCIM API and seeing the list of users on your account:

GET https://api.github.com/scim/v2/organizations/YOUR_ORG_NAME/Users

(replace the YOUR_ORG_NAME with your organization name and use Basic Authentication with the YOUR_ORG_NAME:ACCESS_TOKEN pair)