This functionality is available starting from version 0.0.39. Make sure to upgrade before you use this.
To enable Github OAuth2 you must register your application with Github. Github will generate a client ID and secret key for you to use.
First, you need to create a Github OAuth Application. Follow these instructions:
- Go to https://github.com/
- In the upper-right corner of any page, click your profile photo, then click "Settings".
- In the left sidebar, click "Developer settings".
- In the left sidebar, click "OAuth Apps".
- Click "New OAuth App".
- In "Application name", type "Pyroscope".
- In "Homepage URL", type the full URL to your app's website.
- Optionally, in "Application description", type a description of your app that users will see.
- In "Authorization callback URL", type https://pyroscope.mycompany.com/auth/github/callback. Make sure to replace https://pyroscope.mycompany.com with the URL of your Pyroscope instance.
- Click "Register application".
- Go to https://console.cloud.github.com/apis/credentials.
- Click "Create Credentials", then click "OAuth Client ID" in the drop-down menu.
For the most recent version of these instructions visit Github's documentation.
Specify the Client ID and Secret in the Pyroscope configuration file. For example:
auth: # Specifies which role will be granted to a newly signed up user. # Supported roles: Admin, ReadOnly. Defaults to ReadOnly. # The parameter affects all authentication providers. signup-default-role: Admin github: enabled: true client-id: CLIENT_ID client-secret: CLIENT_SECRET allowed-organizations: - mycompany - myorganization
If you decided to enable the internal authentication provider and allow users to signup via the
auth.internal.signup-enabled option, we strongly recommend you to set
ReadOnly (the default value).
See the server configuration page for more details on the Pyroscope configuration file.
Restart the Pyroscope server. You should now see a Github login button on the login page. You can now login with your Github accounts.