GitHub

Use these instructions to set up GitHub as your SSO provider for Tonic Structural.

The Structural 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. For Application Name, enter Tonic.

2. For Homepage URL, enter https://tonic.ai.

3. For Authorization callback URL, enter https://your-tonic-url/sso/callback. Replace your-tonic-url with the URL of your Structural 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 Structural configuration.

Client ID and client secret values

Structural configuration

In the Structural web server container, set the following Structural environment settings :

• TONIC_SSO_PROVIDER: GitHub

• TONIC_SSO_CLIENT_ID: <GitHub Client ID>

• TONIC_SSO_CLIENT_SECRET: <GitHub Client Secret>