OAuth2 provider plugin for Bitbucket, CAS, CoreOS Dex, Facebook, GitHub, GitLab, Google, Keycloak and Office365 OAuth2 providers

Clone this repo:
  1. d5d7541 Upgrade bazlets to latest stable-2.16 to build with 2.16 API by David Pursehouse · 3 days ago master
  2. 523fbdd Upgrade bazlets to latest master to build with 2.16-rc3 API by David Pursehouse · 5 days ago
  3. b0e6b95 Merge branch 'stable-2.15' by David Pursehouse · 6 days ago
  4. 97412c6 Merge branch 'stable-2.14' into stable-2.15 by David Pursehouse · 6 days ago stable-2.15
  5. 5ec4033 Upgrade bazlets to latest stable-2.15 to build with 2.15.7 API by David Pursehouse · 6 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