Skip to main content

Configure GitHub

Set up GitHub as your identity provider.

Before you start, find your callback URL on the Configure SSO page: {gatewayUrl}/api/auth/callback/github.

Create an OAuth App in GitHub​

  1. Go to GitHub → Settings → Developer settings → OAuth Apps → New OAuth App
  2. Set Authorization callback URL to {gatewayUrl}/api/auth/callback/github
  3. Set Homepage URL to your Willow instance URL
  4. Select Register application
  5. Copy the Client ID and generate a Client Secret

For more details, see GitHub's guide to creating an OAuth app.

Finish in Willow​

  1. Go to Admin → Settings → Authentication Settings
  2. On the SSO Provider card, select Edit
  3. Select Provider: GitHub
  4. Paste the Client ID and Client Secret
  5. Select Save
SSO Provider dialog in Willow with GitHub selected, showing the Client ID, Client Secret, and Callback URL fields
On this page