Doc downloads (PDF, HTML & XML)
[FishEye Knowledge Base]
You can connect FishEye to external user directories. This allows you to use existing users and groups stored in an enterprise directory, and to manage those users and groups in one place.
User management functions include:
It is important to understand that these are separate components of a user management system. You could use an external directory for any or all of the above tasks.
There are several approaches to consider when using external user directories wth FishEye, described briefly below:
When connecting FishEye to an external directory, be careful not to allow access to FishEye by more users than your FishEye license allows. If the license limit is exceeded, users will not be able to use the application and FishEye will display a warning banner. You can manage which users have access to FishEye, using the global permission screen.
You should consider connecting to an LDAP directory server if your users and groups are stored in an enterprise directory.
There are two common ways of using an external LDAP directory with FishEye:
FishEye is able to connect to the following LDAP directory servers:
You can delegate FishEye user and group management, as well as user authentication, to a JIRA application. This is a good option if you already use a JIRA application in your organization. Note that FishEye can only connect to a JIRA application server running JIRA 4.3 or later.
You should consider using Atlassian Crowd for more complex configurations with a large number of users.
See Connecting to JIRA for user management for configuration instructions.
You can connect FishEye to Atlassian Crowd for user and group management, as well as for user authentication.
Crowd is an application security framework that handles authentication and authorization for your web-based applications. With Crowd you can integrate multiple web applications with multiple user directories, with support for single sign-on (SSO) and centralized identity management. See the Crowd Administration Guide.
You should consider connecting to Crowd if you want to use Crowd to manage existing users and groups in multiple directory types, or if you have users of other web-based applications.
See Connecting to Crowd for configuration instructions.
When FishEye is connected directly to multiple user directories, where duplicate user names and group names are used across those directories, the effective group memberships that FishEye uses for authorization can be determined using either of these two schemes:
See Effective memberships with multiple directories for more information about these two schemes.
Note that:
A FishEye admin can change the membership scheme used by FishEye using the following commands:
To change to aggregating membership, substitute your own values for <username>, <password> and <base-url> in this command:
curl -H 'Content-type: application/json' -X PUT -d '{"membershipAggregationEnabled":true}' -u <username>:<password> <base-url>/rest/crowd/latest/application
To change to non-aggregating membership, substitute your own values for <username>, <password> and <base-url> in this command:
curl -H 'Content-type: application/json' -X PUT -d '{"membershipAggregationEnabled":false}' -u <username>:<password> <base-url>/rest/crowd/latest/application
Note that these operations are different from how you make these changes in Crowd. Note also that changing the aggregation scheme can affect the authorization permissions for your users, and how directory update operations are performed.