Plugins You can find out about all the publicly available Grails plugins.

Bitbucket for Spring Security Oauth Plugin

  • Tags: /
  • Latest: 1.0.1
  • Last Updated: 06 December 2015
  • Grails version: 2.0 > *
0 vote
compile "org.grails.plugins:spring-security-oauth-bitbucket:1.0.1"

 Documentation  Source  Issues



Register application in Bitbucket

You need to register your application in Bitbucket. Currently it is done under "Manage account" -> OAuth -> Add consumer.
  • Name: Name of your application. Does not need to match anything in the config, but it will be shown too your users on theit first login.
  • Callback URL: Needs to match "callback" in the config below.
  • Permissions: You need "Email" and "Read" under "Account" to be able to login users. More permissions will be needed if you plan to call other Bitbucket API:s.


When you have registered your application in Bitbucket, then add these settings to your Config.groovy:

oauth {
    providers {
        bitbucket {
            callback = 'http://servername/oauth/bitbucket/callback'
            key = 'key_provided_by_bitbucket'
            secret = 'secret_provided_by_bitbucket'

Login link

To create a login link for Bitbucket, you could use the "connect" tag from the "oauth" taglib:

<oauth:connect provider="bitbucket">Login with Bitbucket</oauth:connect>

Further configuration

For more configuration instructions, see


This plugin adds Bitbucket support to the Grails Spring Security OAuth plugin. It makes it possible for your users to associate their Bitbucket logins to their Grails accounts.