OAuth2

OAuth2 allows users of your MergeBoard workspace to login via a third-party provider, such as Gitlab, GitHub, or Bitbucket.

OAuth2 Provider List

In the OAuth2 menu you can see which third party providers are configured.

../_images/oauth2_list.png

List of OAuth2 providers.

Name

Name used to display the provider in the login dialog. Useful if you want to distinguish multiple OAuth2 providers of the same type.

Type

Type of the OAuth2 provider.

Connections

How many users are using the corresponding provider (Connections). Be careful when disabling a provider that is still in use, your users might no longer be able to login!

Adding a new Provider

Adding a new OAuth2 provider consists of three steps:

  1. You first need to create a new provider entry in MergeBoard. MergeBoard will then generate and display a redirect URL.

  2. Go to the third-party provider and register a new OAuth2 application. You will have to enter the redirect URL. When completing the registration, you get a client ID and client secret.

  3. Go back to MergeBoard and enter the client ID and client secret. Depending on the provider, there can be additional fields to fill out (e.g., to restrict login based on group membership).

For more details, please refer to the provider-specific step-by-step instructions.