ユーザー管理のために Crowd または Jira に接続する
ユーザーやグループの管理および認証のために、Confluence アプリケーションを Atlassian Crowd のほか、Jira Server または Data Center アプリケーション (バージョン 4.3 以降) に接続することができます。
Jira Cloud をユーザー管理に使用することはできません。
ユーザー管理のために Confluence を Crowd に接続する
このオプションを使用する場面: Crowd への接続は、ディレクトリ、ユーザー、およびグループの管理に Crowd の完全な機能をすべて使用したいときに行います。Crowd サーバーは、カスタム ディレクトリ コネクタを含む、 Crowd がサポートする多数のタイプのディレクトリに接続できます。
アトラシアン製品全体で 500 人以上のユーザーを管理していますか?
Crowd を使用することで、スケーラブルかつ効果的な方法でユーザーを簡単に管理できます。
「ユーザーの一元管理」を参照してください。
Confluence を Crowd に接続する方法
- Crowd 管理コンソールに移動し、Confluence アプリケーションを "Crowd" に定義します。Crowd ドキュメント「アプリケーションの追加」を参照してください。
> [一般設定] > [ユーザー ディレクトリ] に移動します。- ディレクトリを追加し、タイプとして [Atlassian Crowd] を選択します。次に説明するように設定を入力します。
- Save the directory settings.
- [ユーザー ディレクトリ] 画面で各ディレクトリの横にある青色の上下矢印をクリックして、ディレクトリの順序を定義します。以下は、ディレクトリの順序が処理に与える影響の概要です。
- ユーザーおよびグループへの変更は、アプリケーションが変更権限を持つ最初のディレクトリに対してのみ行われます。
- ディレクトリの順序は、ユーザーとグループが検索される順序です (既定では、Confluence ではグループ メンバーシップがすべてのディレクトリから集約されるため、順序がメンバーシップ自体に影響することはありません)。
- 必要に応じ、シングル サインオン (SSO) にも Crowd を使用するように Confluence を構成します。 Crowd ドキュメント「Crowd をアトラシアン Confluence と統合する」を参照してください。
Confluence での Crowd 設定
設定 | 説明 |
|---|---|
名前 | ディレクトリ サーバーの一覧でこの Crowd サーバーを識別するのに役立つよう、わかりやすい名前にします。例:
|
サーバー URL | Crowd コンソール サーバーのWeb アドレス。例:
|
アプリケーション名 | ご利用の Crowd サーバーが認識する、アプリケーションの名前。Crowd 管理コンソールを使用して、Crowd でもアプリケーションを定義する必要があります。アプリケーションの追加については、Crowd ドキュメントを参照してください。 |
アプリケーション パスワード | クライアントとして Crowd フレームワークとの認証を行う場合に、アプリケーションが使用するパスワード。これは、Crowd でこのアプリケーションに対して登録したパスワードと同じである必要があります。アプリケーションの追加については、Crowd ドキュメントを参照してください。 |
注: 外部ユーザー ディレクトリとして Jira / Crowd を使用するように Confluence を設定する場合にパスワードが保存されないことがある既知の問題があります。詳細については、CONF-33979 課題詳細の取得中... ステータス を参照してください。
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 アプリケーションに複数のアトラシアン アプリケーションを接続して、一元的なユーザー管理を行うことができます。
このオプションを使用すべきタイミング: 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 ユーザー ディレクトリをセットアップします。
- > [一般設定] > [ユーザー ディレクトリ] に移動します。
- ディレクトリを追加し、タイプ "Atlassian Jira" を選択します。
- 以下に説明するように設定を入力します。アプリケーション名とパスワードを求められた場合、Jira の設定で Confluence アプリケーション用に定義した値を入力します。
- Save the directory settings.
次のステップが完了するまでディレクトリの順序を変更しないでください。変更すると、Confluence 管理コンソールにアクセスできなくなる恐れがあります。
- In order to use Confluence, users must be a member of the
confluence-usersgroup or have Confluence 'can use' permission. Follow these steps to configure your Confluence groups in your Jira application:- Add the
confluence-usersandconfluence-administratorsgroups in your Jira application. - 上に記載した両方のグループのメンバーとして、自分のユーザー名を追加します。
- Select one of the following methods to give your existing Jira users access to Confluence:
- Option 1: In your Jira application, find the groups that the relevant users belong to. Add the groups as members of one or both of the above Confluence groups.
- Option 2: Log in to Confluence using your Jira account and go to the Confluence Administration Console. Click Global Permissions and assign the can use permission to the relevant Jira groups.
- Add the
- Confluence の [ユーザー ディレクトリ] 画面で各ディレクトリの横にある青色の上下矢印をクリックして、ディレクトリの順序を定義することができるようになりました。以下は、ディレクトリの順序が処理に与える影響の要約です。
- ディレクトリの順序は、ユーザーおよびグループの検索順序です。
- ユーザーおよびグループへの変更は、アプリケーションが変更権限を持つ最初のディレクトリに対してのみ行われます。
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 whitelist.
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 サーバー間のアプリケーション リンクの確立に失敗しました。 | Jira と Confluence 間のアプリケーション リンクが作成できません。 この原因として、以下のことが考えられます。
詳細なトラブルシューティング情報については、Confluence のログ ファイルを参照してください。 |
| error.jirabaseurl.not.valid | これは Jira アプリケーションの有効な URL ではありません。 | ランタイム例外が発生しました。詳細なトラブルシューティング情報については、Confluence のログ ファイルを参照してください。 |