OAuth2 provider plugin for Bitbucket, CAS, Facebook, GitHub, GitLab and Google OAuth2 providers

Clone this repo:
  1. a41d6d6 Merge "Add GitLab oauth provider" by David Ostrovsky · 4 months ago master
  2. 0ec9318 Add GitLab oauth provider by TuvaevAndrey · 5 months ago
  3. a29e972 Expose dummy OAuthLoginProvider implementation by David Ostrovsky · 4 months ago
  4. 6aebd3c Add support for Facebook OAuth login by Boyan Vladinov · 5 months ago
  5. 6663ea4 Prefix user id with oauth provider name by David Ostrovsky · 5 months 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.


The plugin can be bulit with Buck and Bazel. To build the plugin with Buck, install Buck and run the following:

  git clone --recursive https://github.com/davido/gerrit-oauth-provider.git
  cd gerrit-oauth-provider && buck build plugin

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

  bazel build gerrit-oauth-provider


Copy the buck-out/gen/gerrit-oauth-provider.jar wenn built with Buck or bazel-genfiles/gerrit-oauth-provider.jar wenn built with Bazel to $gerit_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