Connecting Bitbucket Server to JIRA for user management

(warning)  This page does not apply to JIRA Software Cloud; you can't use JIRA Software Cloud to manage your Bitbucket Server users.

You can connect Bitbucket Server to an existing Atlassian JIRA Software instance to delegate Bitbucket Server user and group management, and authentication. Bitbucket Server provides a "read-only" connection to JIRA Software for user management. This means that users and groups, fetched from JIRA Software, can only be modified or updated in that JIRA Software server, rather than in Bitbucket Server.

Choose this option, as an alternative to Atlassian Crowd, for simple configurations with a limited number of users. Note that Bitbucket Server can only connect to an instance running JIRA Software 4.3 or later.

Connecting Bitbucket Server and JIRA Software is a 3-step process:

1. Set up JIRA Software to allow connections from Bitbucket Server

2. Set up Bitbucket Server to connect to JIRA Software

3. Set up Bitbucket Server users and groups in JIRA Software

Also on this page:


(warning) You need to be an administrator in JIRA Software and a system administrator in Bitbucket Server to perform the following tasks.

Managing 500+ users across Atlassian products?
Find out how easy, scalable and effective it can be with Crowd!
See centralized user management.


1. Setup JIRA Software to allow connections from Bitbucket Server

  1. Log in as a user with the 'JIRA Software Administrators' global permission.
  2. For JIRA 4.3.x, select Other Application from the 'Users, Groups & Roles' section of the 'Administration' menu.
    For later versions, choose Administration > Users > JIRA User Server.
  3. Click Add Application.
  4. Enter the application name (case-sensitive) and password that Bitbucket Server will use when accessing JIRA Software.
  5. Enter the IP address of your Bitbucket Server instance. Valid values are:

    Error rendering macro 'includeplus'

    The content can't be resolved. The space USERMAN is not available in your include library.
  6. Click Save.
  7. Define the directory order, on the 'User Directories' screen, by clicking the blue up- and down-arrows next to each directory. The directory order has the following effects:
    • The order of the directories is the order in which they will be searched for users and groups.
    • Changes to users and groups will be made only in the first directory where the application has permission to make changes.

2. Setup Bitbucket Server to connect to JIRA Software

  1. Log in to Bitbucket Server as a user with 'Admin' permission.
  2. In the Bitbucket Server administration area click User Directories (under 'Accounts').
  3. Click Add Directory and select Atlassian JIRA.
  4. Enter settings, as described below.
  5. Test and save the directory settings.
  6. Define the directory order, on the 'User Directories' screen, by clicking the arrows for each directory. The directory order has the following effects:
    • The order of the directories is the order in which they will be searched for users and groups.
    • Changes to users and groups will be made only in the first directory where the application has permission to make changes.

3. Set up Bitbucket Server users and groups in JIRA Software

In order to use Bitbucket Server, users must be a member of the Bitbucket Server-users group or have Bitbucket Server global permissions. Follow these steps to configure your Bitbucket Server groups in JIRA Software:

  1. Add the bitbucket-users and bitbucket-administrators groups in JIRA Software.
  2. Add your own username as a member of both of the above groups.
  3. Choose one of the following methods to give your existing JIRA Software users access to Bitbucket Server:
    • Option 1: In JIRA Software, find the groups that the relevant users belong to. Add those groups as members of one or both of the above Bitbucket Server groups.
    • Option 2: Log in to Bitbucket Server using your JIRA Software account and go to the administration area. Click Global permissions (under 'Accounts'). Assign the appropriate permissions to the relevant JIRA Software groups. See Global permissions.

Connecting Atlassian Bitbucket Server to JIRA Software for user management is not sufficient, by itself, to allow your users to log in to Bitbucket Server. You must also grant them access to Bitbucket Server by using one of the above 2 options.

We recommend that you use groups instead of individual accounts when granting permissions. However, be careful not to add more users to those groups that your Bitbucket Server license allows. If the license limit is exceeded, your develope rs will not be able to push commits to repositories, and Bitbucket Server will display a warning banner. See this FAQ.

See also this  information about deleting users and groups  in Bitbucket Server.

Server settings

Error rendering macro 'includeplus'

The content can't be resolved. The space USERMAN is not available in your include library.

JIRA Software server permissions

Error rendering macro 'includeplus'

The content can't be resolved. The space USERMAN is not available in your include library.

Advanced settings

Error rendering macro 'includeplus'

The content can't be resolved. The space USERMAN is not available in your include library.

Last modified on Jan 16, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.