Single Sign-On with GitHub

Installation

To use GitHub as a single sign-in provider for your Tideways organization, first connect your organization to a GitHub organization, by clicking "Connect GitHub" on the integrations screen of your organization settings:

connect github

This will take you to the installation screen of github, where you can select which organization you want to install this on:

github installation

Then you can select a GitHub Team for SSO and Synchronization by clicking on the button "Select GitHub Team fro SSO and Synchronization" in the organizations "SSO & User Synchronization" settings screen:

synchronize github team

You can then select the GitHub teams you would like to synchronize:

create team from github organization team

  • In the first step, if you did not connect a github organization to your organization, you will be redirected to do that.

  • In the second step, you can select the team you want to import from the selected organization.

  • In the third step, you see all the members of the selected team for verification.

  • In the last step, you can choose a team to synchronize your user into and can confirm the import.

After verification, the synchronization will be created and synchronization of users is started in the background. If the GitHub user has made their e-mail address public, they will get an invitation e-mail. If their email is not public, they cannot be notified of this invitation and you need to make sure they "Login with GitHub" on https://app.tideways.io/login, to get access to the organization.

User Provisioning

Users in the selected GitHub Team are automatically provisioned into Tideways using the GitHub API. This synchronization happens once every day and also disables GitHub users that do not have access to the connected GitHub organization and team anymore.

Still need help? Email [email protected]