Torii integrates with GitHub Enterprise and syncs the user list into Torii.
Requirements:
-
A GitHub Enterprise Cloud account
-
Users are authenticated using SAML single sign-on.
-
Users are provisioned by an Identity Provider using SCIM.
Instructions:
-
Create a personal access token on GitHub with the
admin:org
scope. -
Authorize the personal access token for use with SAML single sign-on.
-
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)