Use these instructions to set up GitHub as your SSO provider for Tonic.
The Tonic GitHub SSO integration does not support GitHub group membership.

GitHub configuration

Create an OAuth application

In GitHub, navigate to Settings -> Developer Settings -> OAuth Apps, then create a new application.
  1. 1.
    For Application Name, enter Tonic.
  2. 2.
    For Homepage URL, enter
  3. 3.
    For Authorization callback URL, enter https://your-tonic-url/sso/callback. Replace your-tonic-url with the URL of your Tonic instance.
OAuth application creation panel in GitHub

Create a client secret

After you create the application, to create a new secret, click Generate a new client secret.
Option to generate a new client secret
You use the Client ID and the Client secret in the Tonic configuration.
Client ID and client secret values

Tonic configuration

In the Tonic web server container, set the following Tonic environment settings :
  • TONIC_SSO_CLIENT_ID: <GitHub Client ID>
  • TONIC_SSO_CLIENT_SECRET: <GitHub Client Secret>
Last modified 4mo ago