ユーザー管理のために Crowd または Jira に接続する
ユーザーやグループの管理および認証のために、Confluence アプリケーションを Atlassian Crowd のほか、Jira Server または Data Center アプリケーション (バージョン 4.3 以降) に接続することができます。
Jira Cloud をユーザー管理に使用することはできません。
Connecting Confluence to Crowd for user management
このオプションを使用する場面: Crowd への接続は、ディレクトリ、ユーザー、およびグループの管理に Crowd の完全な機能をすべて使用したいときに行います。Crowd サーバーは、カスタム ディレクトリ コネクタを含む、 Crowd がサポートする多数のタイプのディレクトリに接続できます。
Managing 500+ users across Atlassian products?
Find out how easy, scalable, and effective it can be with Crowd!
See centralized user management.
Confluence を Crowd に接続する方法
- Crowd 管理コンソールに移動し、Confluence アプリケーションを "Crowd" に定義します。Crowd ドキュメント「アプリケーションの追加」を参照してください。
To use Confluence, users must be a member of the
confluence-users
group or the Crowd groups should be configured to access Confluence.
To create the standard Confluence groups:Add the
confluence-users
andconfluence-administrators
groups in Atlassian Crowd.上に記載した両方のグループのメンバーとして、自分のユーザー名を追加します。
Add the other existing users or their groups to
confluence-users
andconfluence-administrators
group.
- In Confluence, go to Administration > General Configuration > User directories.
- To add a directory, select Add, and then select the Atlassian Crowd type. Enter the settings as described below.
- Save the directory settings.
To provide access to groups synced from Atlassian Crowd, go to Global Permissions and assign the can use permission
Validate the configuration by logging in using the credentials of a user synced from Atlassian Crowd.
- Define the directory order by clicking the blue up- and down-arrows next to each directory on the User Directories screen. ディレクトリの順序がどういった影響をもたらすかを説明します。詳細については、「複数のディレクトリの管理」を参照してください。
- ユーザーおよびグループへの変更は、アプリケーションが変更権限を持つ最初のディレクトリに対してのみ行われます。
- ディレクトリの順序は、ユーザーとグループが検索される順序です (既定では、Confluence ではグループ メンバーシップがすべてのディレクトリから集約されるため、順序がメンバーシップ自体に影響することはありません)。
- 必要に応じ、シングル サインオン (SSO) にも Crowd を使用するように Confluence を構成します。 Crowd ドキュメント「Crowd をアトラシアン Confluence と統合する」を参照してください。
Confluence での Crowd 設定
設定 | 説明 |
---|---|
名前 | ディレクトリ サーバーの一覧でこの Crowd サーバーを識別するのに役立つよう、わかりやすい名前にします。例:
|
サーバー URL | Crowd コンソール サーバーのWeb アドレス。例:
|
アプリケーション名 | ご利用の Crowd サーバーが認識する、アプリケーションの名前。Crowd 管理コンソールを使用して、Crowd でもアプリケーションを定義する必要があります。アプリケーションの追加については、Crowd ドキュメントを参照してください。 |
アプリケーション パスワード | クライアントとして Crowd フレームワークとの認証を行う場合に、アプリケーションが使用するパスワード。これは、Crowd でこのアプリケーションに対して登録したパスワードと同じである必要があります。アプリケーションの追加については、Crowd ドキュメントを参照してください。 |
Note: There is a known issue where the password is not saved in some instances CONF-33979 - Getting issue details... STATUS when configuring Confluence to use Jira/Crowd as a external user directory.
Crowd の権限
設定 |
説明 |
---|---|
読み取り専用 |
このディレクトリのユーザー、グループおよびメンバーシップは、Crowd から取得され、Crowd を介してのみ変更することができます。アプリケーション管理画面から Crowd ユーザー、グループ、またはメンバーシップを変更することはできません。 |
読み取り/書き込み |
このディレクトリ内のユーザー、グループ、メンバーシップは Crowd から取得されます。アプリケーション管理画面からユーザー、グループ、メンバーシップを変更すると、Crowd に変更が直接適用されます。アプリケーションが、Crowd 内の関連ディレクトリを変更する権限を持っていることを確認してください。Crowd ドキュメント「アプリケーションのディレクトリ権限を指定する」を参照してください。 |
高度な Crowd 設定
設定 | 説明 |
---|---|
Enable Nested Groups | 入れ子グループのサポートを有効または無効にします。入れ子グループを有効にする前に、Crowd のユーザー ディレクトリで入れ子グループがサポートされているかどうかを確認します。入れ子グループが有効になっているときは、グループを別のグループのメンバーとして定義できます。グループを使用して権限を管理している場合、入れ子グループを作成して、1 つのグループからそのサブグループに権限を継承できます。 |
Enable Incremental Synchronization | インクリメンタル同期を有効または無効にします。ディレクトリの同期時には、前回の同期時以降の変更のみが取得されます。完全な同期はアプリケーションの再起動時に常に実行されます。 |
Synchronization Interval (minutes) | 同期とは、アプリケーションがユーザー データの内部ストアをディレクトリ サーバ上のデータで更新するプロセスです。アプリケーションは x 分ごとにディレクトリ サーバーにリクエストを送信します。x はここで指定する数値です。既定値は60分です。 |
ユーザー管理のために Confluence を Jira アプリケーションに接続する
この機能の使用にあたって、Jira アプリケーションと Confluence のライセンス層が一致する必要はないことにご注意ください。たとえば、Jira Software のユーザーライセンスが 25 ライセンスしかない場合でも、Jira Software で Confluence のユーザー ライセンスを 50 ライセンス管理できます。
このオプションを使用すべきタイミング: Jira 4.3 以降、Jira Software 7.0 以降、Jira Core 7.0 以降、または Jira Service Management (旧 Jira Service Desk) 3.0 以降を実行中のサーバーに接続できます。ユーザーの数が限られているシンプルな構成では、Atlassian Crowd の代替として、このオプションを選択します。
Confluence を Jira Server または Data Center アプリケーションに接続するには、
- Jira アプリケーションで、[ユーザー管理] > [Jira ユーザー サーバー] に移動します。
(Jira 6.4 以前の場合は、Jira 管理画面に移動し、[ユーザー] > [Jira ユーザー サーバー] に移動します)- [アプリケーションの追加] をクリックします。
- Confluence が Jira にアクセスする際に使用するアプリケーション名とパスワードを入力します。
- IPアドレスまたは Confluence サーバーのアドレスを入力します。有効な値は以下のとおりです。
- 完全な IP アドレス、例:
192.168.10.12
。 - ワイルドカードでの IP 範囲 (CIDR 表記を使用) 例:
192.168.10.1/16
。詳細については、Wikipedia の CIDR 通知および RFC 4632 の概要を参照してください。
- 完全な IP アドレス、例:
- Save the new application.
- Confluence で Jira ユーザー ディレクトリをセットアップします。
- [管理] > [一般設定] > [ユーザー ディレクトリ] に移動します。
- To add a directory, select Add, and then select Atlassian Jira.
- 以下に説明するように設定を入力します。アプリケーション名とパスワードを求められた場合、Jira の設定で Confluence アプリケーション用に定義した値を入力します。
- Save the directory settings.
- 次のステップが完了するまでディレクトリの順序を変更しないでください。変更すると、Confluence 管理コンソールにアクセスできなくなる恐れがあります。
- Confluence を使用するには、ユーザは
confluence-users
グループのメンバーであるか、Confluence の "使用可能" 権限を持っている必要があります。以下の手順に従い、Jira アプリケーションで Confluence グループを設定します。- Jira アプリケーションに
confluence-users
およびconfluence-administrators
グループを追加します。 - 上に記載した両方のグループのメンバーとして、自分のユーザー名を追加します。
- 以下のいずれかの方法を選択し、既存の Jira ユーザーに Confluence へのアクセス権を付与します。
- オプション1 : Jira アプリケーションで、関連するユーザーが属するグループを見つけます。上記の Confluence グループの 1 つまたは両方のメンバーとしてグループを追加します。
- オプション 2: Jira アカウントを使用して Confluence にログインし、Confluence の管理コンソールに移動します。[グローバル権限] をクリックし、[使用可能] 権限を関連する Jira グループに割り当てます。
- Jira アプリケーションに
- In Confluence, go to User Directories and select the Synchronise link displayed for the Jira user directory.
- Test the configuration by logging in as a Jira user that was synced to Confluence.
- You can now define the directory order by clicking the blue up- and down-arrows next to each directory on the User Directories screen. ディレクトリの順序がどういった影響をもたらすかを説明します。詳細については、「複数のディレクトリの管理」を参照してください。
- ディレクトリの順序は、ユーザーおよびグループの検索順序です。
- ユーザーおよびグループへの変更は、アプリケーションが変更権限を持つ最初のディレクトリに対してのみ行われます。
Ensure that you have added Confluence URL into Jira Whitelist in Jira Administration >> System >> Security >> Whitelist
. For example: https://confluence.atlassian.com/ or refer to this guide: Configuring the allowlist.
Confluence での Jira の設定
設定 | 説明 |
---|---|
名前 | ディレクトリ サーバーの一覧でこの Jira サーバーを識別するのに役立つ、わかりやすい名前にします。例:
|
サーバー URL | Jira サーバーの Web アドレス。例:
|
アプリケーション名 | ユーザー マネージャーとして機能する Jira サーバーにアクセスするときに、アプリケーションが使用する名前。アプリケーションはこの Jira サーバーで定義されている必要があります。これは、[管理] メニューの [ユーザー、グループおよび役割] セクションにある [その他のアプリケーション] オプションから行います。 |
アプリケーション パスワード | ユーザーマネージャーとして機能する Jira サーバーにアクセスするときに、アプリケーションが使用するパスワード。 |
Jira 権限
設定 | 説明 |
---|---|
読み取り専用 | このディレクトリ内のユーザー、グループ、メンバーシップは、ユーザーマネージャーとして機能する Jira サーバーから取得されます。これらはその Jira サーバーからのみ変更できます。 |
高度な Jira 設定
設定 | 説明 |
---|---|
Enable Nested Groups | 入れ子グループのサポートを有効/無効にします。入れ子グループの有効化前に、ユーザー マネージャーとして機能している Jira Server で入れ子グループが有効になっているかどうかをご確認ください。入れ子グループが有効になっている場合は、グループを別のグループのメンバーとして定義できます。グループによって権限を管理している場合は、入れ子グループを作成して 1 つのグループからそのサブグループに権限を継承できます。 |
グループ メンバーシップをログイン時に更新する | この設定によって、グループ メンバーシップを認証中に更新できるようになります。次のようなオプションを設定できます。
|
Synchronization Interval (minutes) | 同期とは、アプリケーションがユーザー データの内部ストアをディレクトリ サーバ上のデータで更新するプロセスです。アプリケーションは x 分ごとにディレクトリ サーバーにリクエストを送信します。x はここで指定する数値です。既定値は60分です。 |
設定の例
図: Confluence、Jira、その他のアプリがユーザー管理のために Crowd に接続されている。
上の図: ユーザー管理のために Confluence を Jira に接続
上の図: ユーザー管理のために Confluence を Jira (LDAP に接続) に接続
トラブルシューティング
次のようなエラー メッセージが表示される場合があります。問題が発生した場合、関連するクラスの WARN ログを有効にしてください。「ログを設定する」を参照してください。
エラー | メッセージ | 原因 |
---|---|---|
error.jirabaseurl.connection.refused | 接続が拒否されました。Jira インスタンスが指定された URL で実行されているかどうかを確認してください | この原因として、以下のことが考えられます。
|
error.applicationlink.connection.refused | Jira サーバーと Confluence Data Center 間のアプリケーション リンクの確立に失敗しました。 | Jira と Confluence 間のアプリケーション リンクが作成できません。 この原因として、以下のことが考えられます。
詳細なトラブルシューティング情報については、Confluence のログ ファイルを参照してください。 |
error.jirabaseurl.not.valid | これは Jira アプリケーションの有効な URL ではありません。 | ランタイム例外が発生しました。詳細なトラブルシューティング情報については、Confluence のログ ファイルを参照してください。 |