Connecting to Jira for user management

Still need help?

The Atlassian Community is here for you.

Ask the community

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

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

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

Connecting Fisheye and Jira is a 3-step process:

1. Set up Jira to allow connections from Fisheye

2. Set up Fisheye to connect to Jira Software

3. Set up Fisheye users and groups in Jira Software

Also on this page:


(warning) You need to be an administrator in Jira and a system administrator in Fisheye to perform the following tasks.

1. Setup Jira to allow connections from Fisheye 

  1. Log in as a user with the 'Jira 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 > User management > Jira User Server.
  3. Click Add Application.
  4. Enter the application name (case-sensitive) and password that Fisheye will use when accessing Jira Software.
  5. Enter the IP address of your Fisheye instance. Valid values are: 
    • A full IP address, e.g. 192.168.10.12.
    • A wildcard IP range, using CIDR notation, e.g. 192.168.10.1/16. For more information, see the introduction to CIDR notation on Wikipedia and RFC 4632.
  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 Fisheye to connect to Jira

  1. Log in to Fisheye as a user with 'Admin' permission.
  2. In the Fisheye 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 Fisheye users and groups in Jira

In order to use Fisheye, users must be a member of a group that has the 'Access to Fisheye' global permission. Follow these steps to configure your Fisheye groups in Jira:

  1. Add a group for Fisheye users in Jira.
  2. Add your own username as a member of the above group..
  3. Log in to Fisheye using and go to the administration area. Click Global Permissions (under 'Security Settings'). Assign the appropriate permissions to the Jira group. See Global permissions.

Server settings

Setting

Description

Read Only

The users, groups and memberships in this directory are retrieved from the Jira server that is acting as user manager. They can only be modified via that JIRA server.

Jira server permissions

Setting

Description

Read Only

The users, groups and memberships in this directory are retrieved from the Jira server that is acting as user manager. They can only be modified via that JIRA server.

Advanced settings

Setting

Description

Enable Nested Groups

Enable or disable support for nested groups. Before enabling nested groups, please check to see if nested groups are enabled on the JIRA server that is acting as user manager. When nested groups are enabled, you can define a group as a member of another group. If you are using groups to manage permissions, you can create nested groups to allow inheritance of permissions from one group to its sub-groups.

Enable Incremental SynchronizationEnable or disable incremental synchronization. Only changes since the last synchronization will be retrieved when synchronizing a directory.

Synchronization Interval (minutes)

Synchronization is the process by which the application updates its internal store of user data to agree with the data on the directory server. The application will send a request to your directory server every x minutes, where 'x' is the number specified here. The default value is 60 minutes.

Last modified on Sep 23, 2019

Was this helpful?

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