Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

You can allow other applications to connect to your JIRA server for management of users and groups, and for authentication (verification of a user's login). Examples of such applications: Atlassian Confluence, FishEye/Crucible, Bamboo, or another JIRA server.

On this page:

(warning) The information on this page does not apply to JIRA OnDemand.

Allowing an Application to Connect to JIRA for User Management

Subject to certain limitations, you can connect a number of Atlassian web applications to a single JIRA server for centralised user management.

When to use this option: You can only connect to a server running JIRA 4.3 or later. Choose this option as an alternative to Atlassian Crowd, for simple configurations with a limited number of users.

To configure an application to connect to JIRA as a user server:

  1. Add the application in JIRA:
    1. Log in to JIRA as a user with the 'JIRA Administrators' global permission.
    2. Select 'Administration' > 'Users' > 'JIRA User Server'.
      (tick) Keyboard shortcut: 'g' + 'g' + start typing 'jira user'.
    3. Add an application.
    4. Enter the application name and password that the application will use when accessing your JIRA server.
    5. Enter the IP address or addresses of the application. Valid values are:
      • A full IP address, e.g.
      • A wildcard IP range, using CIDR notation, e.g. For more information, see the introduction to CIDR notation on Wikipedia and RFC 4632.
    6. Save the new application.
  2. Set up the JIRA user directory in the application:
    For example, see Connecting Confluence to JIRA for User Management or Connecting JIRA to Another JIRA Server:
    1. Log in to the application that is going to connect to JIRA for user management.
    2. Go to the application's 'User Directories' administration area.
    3. Add a new directory of type 'Atlassian JIRA'.
    4. Define the directory order (see Managing Multiple Directories).
  3. Create any groups in JIRA that are required by the application. For example, see Connecting Confluence to JIRA for User Management.

Diagrams of Some Possible Configurations

Gliffy Zoom Zoom

Diagram above: Confluence connecting to JIRA for user management.

Gliffy Zoom Zoom

Diagram above: One JIRA site connecting to another for user management. JIRA site 2 does the user management, storing the user data in its internal directory.


Configuring User Directories