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

  3. For Authorization callback URL, enter https://your-tonic-url/sso/callback. Replace your-tonic-url with the URL of your Structural instance.

Create a client secret

After you create the application, to create a new secret, click Generate a new client secret.

You use the Client ID and the Client secret in the Structural configuration.

Structural configuration

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


  • TONIC_SSO_CLIENT_ID: <GitHub Client ID>

  • TONIC_SSO_CLIENT_SECRET: <GitHub Client Secret>

Last updated