OAuth2 provider plugin. Multiple providers are currently supported: * AirVantage * Bitbucket * CAS * CoreOS Dex * Facebook * GitHub * GitLab * Google * Keycloak * Office365

Clone this repo:
  1. 491388d Merge branch 'stable-2.16' by Marco Miller · 6 days ago master
  2. 5e9de87 Merge branch 'stable-2.15' into stable-2.16 by Marco Miller · 6 days ago stable-2.16
  3. dd26438 Merge branch 'stable-2.14' into stable-2.15 by Marco Miller · 6 days ago stable-2.15
  4. 64ad652 Extend ServletModule instead of HttpPluginModule by David Pursehouse · 6 days ago stable-2.14
  5. 20d5626 Merge branch 'stable-2.16' by Marco Miller · 8 days ago

Gerrit OAuth2 authentication provider

Build Status

With this plugin Gerrit can use OAuth2 protocol for authentication. Supported OAuth providers:

See the Wiki what it can do for you.

Prebuilt artifacts

Prebuilt binary artifacts are available on release page. Make sure to pick the right JAR for your Gerrit version.


To build the plugin with Bazel, install Bazel and run the following:

  git clone https://gerrit.googlesource.com/plugins/oauth
  cd oauth && bazel build oauth


Copy the bazel-genfiles/oauth.jar to $gerrit_site/plugins and re-run init to configure it:

  java -jar gerrit.war init -d <site>
  *** OAuth Authentication Provider
  Use Bitbucket OAuth provider for Gerrit login ? [Y/n]? n
  Use Google OAuth provider for Gerrit login ? [Y/n]?
  Application client id          : <client-id>
  Application client secret      : 
                confirm password : 
  Link to OpenID accounts? [true]: 
  Use GitHub OAuth provider for Gerrit login ? [Y/n]? n

Reporting bugs

Make sure to read the FAQ before reporting issues.


Apache License 2.0