Skip to main content

GitHub SSO

Set up GitHub as your identity provider for Webrix.

What you'll enter in Webrix​

  • Client ID
  • Client Secret
  • Callback URL (read‑only): {gatewayUrl}/api/auth/callback/github

Steps in GitHub​

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

Finish in Webrix​

  1. In Admin → Settings → Authentication, choose Provider: GitHub.
  2. Paste the Client ID and Client Secret.
  3. Click Save.

Docs: https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app