[Other doc versions]
You can connect Stash to an Atlassian JIRA instance to delegate Stash user and group management, and authentication.
Choose this option as an alternative to Atlassian Crowd, for simple configurations with a limited number of users. Note that Stash can only connect to a JIRA server running JIRA 4.3 or later.
Connecting Stash and JIRA is a 3-step process:
You can connect to JIRA either when you first run Stash, using the Setup Wizard, or at any time after setup is complete.
If using the Stash Setup Wizard to configure JIRA integration, we recommend that you make use of the automatic back-linking from JIRA to Stash.
You need to be an administrator in both JIRA and Stash to do this.
See also this information about deleting users and groups in Stash.
On this page:
1. Set up JIRA to allow connections from Stash
192.168.10.1/16. For more information, see the introduction to CIDR notation on Wikipedia and RFC 4632.
2. Set up Stash to connect to JIRA
3. Set up Stash users and groups in JIRA
In order to use Stash, users must be a member of the
Stash-users group or have Stash 'can use' permission. Follow these steps to configure your Stash groups in JIRA:
stash-administratorsgroups in JIRA.
This integration will cause all JIRA users/groups to be fetched in Stash but only those that have the "Can use Stash" permission are allowed to log into the application.
This restriction for "can use" permission can be set as per the above 2 options.
A meaningful name that will help you to identify this Jira server in the list of directory servers. Examples:
The web address of your Jira server. Examples:
The name used by your application when accessing the Jira server that acts as user manager. Note that you will also need to define your application to that Jira server, via the 'Other Applications' option in the 'Users, Groups & Roles' section of the 'Administration' menu.
The password used by your application when accessing the Jira server that acts as user manager.
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.
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 Synchronization||Enable 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.