| Gerrit OAuth2 authentication provider |
| ===================================== |
| |
| [](https://travis-ci.org/davido/gerrit-oauth-provider) |
| |
| |
| With this plugin Gerrit can use OAuth2 protocol for authentication. |
| Supported OAuth providers: |
| |
| * [Bitbucket](https://confluence.atlassian.com/bitbucket/oauth-on-bitbucket-cloud-238027431.html) |
| * [CAS](https://www.apereo.org/projects/cas) |
| * [GitHub](https://developer.github.com/v3/oauth/) |
| * [Google](https://developers.google.com/identity/protocols/OAuth2) |
| |
| See the [Wiki](https://github.com/davido/gerrit-oauth-provider/wiki) what it can do for you. |
| |
| Prebuilt artifacts |
| ------------------ |
| |
| Prebuilt binary artifacts are available on [release page](https://github.com/davido/gerrit-oauth-provider/releases). Make sure to pick the right JAR for your Gerrit version. |
| |
| Build |
| ----- |
| |
| To build the plugin, install [Buck](http://facebook.github.io/buck/setup/install.html) |
| and run the following: |
| |
| ``` |
| git clone --recursive https://github.com/davido/gerrit-oauth-provider.git |
| cd gerrit-oauth-provider && buck build plugin |
| ``` |
| |
| Install |
| ------- |
| |
| Copy the `buck-out/gen/gerrit-oauth-provider.jar` 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](https://github.com/davido/gerrit-oauth-provider/wiki/FAQ) before reporting issues. |
| |
| License |
| ------- |
| |
| Apache License 2.0 |
