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:

• Server settings
• Jira server permissions
• Advanced settings

 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: 

   Error rendering macro 'include'

   com.atlassian.renderer.v2.macro.MacroException: No page title provided.

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

Jira server permissions

Advanced settings