Usage Scenario

Login with GitHub account

How to Set Up

1. Make sure your OneDev instance can be accessed publicly, and configure the public server url in Administration / System Setting

2. At GitHub side, register OneDev as a OAuth application under either a user account or an organization account

3. After registering, GitHub will display client id and secret for the application, which will be used later

4. At OneDev side, add a single sign on provider of type OpenID (GitHub) in Administration / Authentication Source / Single Sign On and fill in client id and secret shown above

5. Save the setting, click the definition to show details, and copy the callback URL

6. Now paste the copied callback URL into OneDev application registered at GitHub side, and save the setting

7. Logout OneDev and you will see a Login with GitHub button at bottom of the login screen. Any GitHub account with a public email will be able to login via this button now