Stash is now known as Bitbucket Server.
See the

Unknown macro: {spacejump}

of this page, or visit the Bitbucket Server documentation home page.

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:

  1. Set up JIRA to allow connections from Stash.
  2. Set up Stash to connect to JIRA.
  3. Set up Stash users and groups in JIRA.

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.

(warning) You need to be an administrator in both JIRA and Stash to do this.

このページの内容

Connecting to JIRA

1. Set up JIRA to allow connections from Stash

  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 JIRA 4.4 or later, choose Administration > Users > JIRA User Server.
  3. [アプリケーションの追加] をクリックします。
  4. Enter the application name and password that Stash will use when accessing JIRA.
  5. Enter the IP address of your Stash server. 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.
  6. 保存 をクリックします。
  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:
    • ディレクトリの順序は、ユーザーおよびグループの検索順序です。
    • ユーザーおよびグループへの変更は、アプリケーションが変更権限を持つ最初のディレクトリに対してのみ行われます。

2. Set up Stash to connect to JIRA

  1. Log in as a user with 'Admin' permission.
  2. Click Administration in the top menu and then User Directories.
  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 blue up- and down-arrows next to each directory. The directory order has the following effects:
    • ディレクトリの順序は、ユーザーおよびグループの検索順序です。
    • ユーザーおよびグループへの変更は、アプリケーションが変更権限を持つ最初のディレクトリに対してのみ行われます。

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:

  1. Add the stash-users and stash-administrators groups in JIRA.
  2. 上に記載した両方のグループのメンバーとして、自分のユーザー名を追加します。
  3. Choose one of the following methods to give your existing JIRA users access to Stash:
    • Option 1: In JIRA, find the groups that the relevant users belong to. Add the groups as members of one or both of the above Stash groups.
    • Option 2: Log in to Stash using your JIRA account, click Administration and then Global Permissions. Assign the appropriate permissions to the relevant JIRA groups.

サーバー設定

設定

説明

名前

A meaningful name that will help you to identify this JIRA server amongst your list of directory servers. Examples:

  • JIRA Server
  • My Company JIRA

サーバー URL

The web address of your JIRA server. Examples:

  • http://www.example.com:8080
  • http://jira.example.com

アプリケーション名

ユーザー マネージャーとして機能する Jira サーバーにアクセスするときに、アプリケーションが使用する名前。アプリケーションをこの Jira サーバーに定義する必要があります。これは、[管理 メニューの [ユーザー、グループおよび役割] セクションにある [その他のアプリケーション オプションから行います。

アプリケーション パスワード

ユーザーマネージャーとして機能する JIRA サーバーにアクセスするときに、アプリケーションが使用するパスワード。

JIRA server permissions

設定

説明

読み取り専用

このディレクトリ内のユーザー、グループ、メンバーシップは、ユーザーマネージャーとして機能する JIRA サーバーから取得されます。その JIRA サーバーを介する場合しか、これらの変更はできません。

読み取り/書き込み

The users, groups and memberships in this directory are retrieved from the JIRA server that is acting as user manager. When you modify a user, group or membership, the changes will be applied directly to your application and to the JIRA server that is acting as user manager.

高度な設定

設定

説明

Enable Nested Groups

入れ子グループのサポートを有効または無効にします。入れ子グループを有効にする前に、ユーザー マネージャーとして機能している Jira サーバーで入れ子グループが有効になっているかどうかを確認してください。入れ子グループが有効になっているときは、グループを別のグループのメンバーとして定義できます。グループを使用して権限を管理している場合、入れ子グループを作成して、1 つのグループからそのサブグループに権限を継承できます。

Enable Incremental SynchronisationEnable or disable incremental synchronisation. Only changes since the last synchronisation will be retrieved when synchronising a directory..

同期間隔(分)

Synchronisation 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.

  • ラベルなし