JIRA and Crowd Authentication

Integrating FishEye with JIRA for User Management

You can manage your FishEye/Crucible users in JIRA.

This option is available only with JIRA 4.3 and later.

If you want to manage your FishEye users using JIRA, you need to configure a connection in JIRA and then set up the user directory in FishEye. Both steps are described below.

2.1. To configure a new connection for user management in JIRA:

1. Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
2. Click Administration on the JIRA top navigation bar.
   1. Go to the JIRA administration screen for configuring the applications that have been set up to use JIRA for user management:
      • In JIRA 4.3: Click 'Other Applications' in the 'Users, Groups & Roles' section of the JIRA administration screen.
      • In JIRA 4.4: Select 'Administration' > 'Users' > 'JIRA User Server'.
   2. Add an application.
   3. Enter the application name and password that your application will use when accessing JIRA.
   4. Enter the IP address or addresses of your application. Valid values are:
      • 完全な IP アドレス、例: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.
      • Save the new application.

2.2. To set up the JIRA user directory in FishEye:

1. Go to your FishEye administration screen.
   1. Click Authentication (under 'Security Settings').
   2. Click Setup JIRA/Crowd authentication. Note, if LDAP authentication has already been set up, you will need to remove that before connecting to JIRA for user management.

   3. Make the following settings:
      
      

      Authenticate against	Select a JIRA instance
      Application name and password	Enter the values that you defined for your application in the settings on JIRA.
      JIRA URL	The web address of your JIRA server. Examples: http://www.example.com:8080/jira/ http://jira.example.com
      Auto-add	Select Create a FishEye user on successful login so that your JIRA users will be automatically added as a FishEye user when they first log in.
      Periodically synchronise users with JIRA	Select Yes to ensure that JIRA will synchronize all changes in the user information on a regular basis. Change the value for Synchronise Period if required.
      When Synchronisation Happens	Select an option depending on whether you want to allow changes to user attributes from within FishEye.
      Single Sign On	Select Disabled. SSO is not available when using JIRA for user management and if enabled will make the integration fail.

   4. Click Next and select at least one user group to be synchronised from JIRA. If necessary, you could create a new group in JIRA, such as 'fisheye-users', and select this group here.
   5. 保存をクリックします。

For further information, see the JIRA documentation here: Allowing Other Applications to Connect to JIRA for User Management

Integrating FishEye with Crowd

Atlassian's Crowd user management application can be integrated with FishEye.

You set the basic Crowd properties, such as the application name, password and URL, using the FishEye adminstration screens, as described in Integrating Crowd with FishEye in the Crowd Administrator's Guide.

You can also fine tune your Crowd integration by overriding the default Crowd properties, such as the session validation interval and SSO cookie name, by manually editing the config.xml file in your FishEye installation directory. See Integrating Crowd with FishEye for details.