How to configure GitHub SSO for access to Aidbox UI
This guide shows how to set-up GitHub identity provider with Aidbox
Register an OAuth application on GitHub
Open your organization's page on GitHub then Settings > Developer Settings > OAuth Apps > New Org OAuth App.

GitHub registration OAuth app form
Generate a new secret

OAuth application settings
Create an IdentityProvider in Aidbox
Using REST Console create an IdentityProvider config.
PUT /IdentityProvider/github?_format=yaml&_pretty=true
content-type: text/yaml
type: github
active: true
system: https://github.com
scopes:
- profile
- openid
- read:org
- user
organizations:
- <your-github-organization-name>
client:
id: <client-id>
secret: <client-secret>
Login into Aidbox with GitHub
Go to your Aidbox base URL, you will be redirected to the login page - you should see "Sign in with <provider.title or .type>" button. Press this button and log in with GitHub user into aidbox.

Aidbox login page
This user will be logged into Aidbox Console, but without any permissions. Read more in Access Control Section about permissions.
Last updated 2025-08-07T12:18:32Z