External Authentication Settings

GitHub Authentication

To set up GitHub as an authentication provider:

1. Visit your GitHub Developer Settings under your profile.
2. Select OAuth Apps and create a new OAuth app.
3. Enter the following details (replacing https://hostname:90 with your actual Signotaur URL):
   • Application Name: e.g., "Signotaur"
   • Homepage URL: e.g., https://hostname:90.
   • Authorization Callback URL: e.g., https://hostname:90/oauth-github.
4. Click Register Application and make a copy of the Client ID.
5. Click Generate a new client secret and make a copy of the Client Secret.
6. Click Enable on the GitHub Authentication form in Signotaur, and copy the Client ID and Client Secret from GitHub and paste them into the corresponding fields.
7. Click Update to save the GitHub authentication settings.

Google Authentication

To set up Google as an authentication provider:

1. Go to the Google APIs Console.
2. Create or select a Google APIs project, then navigate to Credentials.
3. Click Create Credentials and select OAuth client ID.
4. For Application type, choose "Web application" and enter the following (replacing https://hostname:90 with your actual Signotaur URL):
   • Name: e.g., "Signotaur Server".
   • Authorized JavaScript Origins: e.g., https://hostname:90.
   • Authorized Redirect URIs: e.g., https://hostname:90/oauth-google.
5. Click Create and make a copy of the Client ID and Client Secret.
6. Click Enable on the Google Authentication form in Signotaur, and copy the Client ID and Client Secret from Google and paste them into the corresponding fields.
7. Click Update to save the Google authentication settings.

Note: Changes to external authentication require restarting the Signotaur service to take effect.