LDAP インポート
承認プロセスに使用されるアセットや従業員とマネージャーの関係が含まれている社内ディレクトリを使用している場合があります。このような LDAP エントリは、Insight にインポートできます。作業を簡単にするため、Insight には一般的な LDAP ディレクトリで動作して、ディレクトリから構造とアセットを取得できるモジュールが用意されています。この記事では、これを設定する方法について説明します。インポートの詳細についてご確認ください。
LDAP インポートを作成して設定するには、Jira 管理者である必要があります。
概要
LDAP ディレクトリは、ユーザーとその他のアセットのコレクションです。ライトウェイト ディレクトリ アクセス プロトコル (LDAP) はインターネット プロトコルで、Web アプリケーションで LDAP サーバーからこれらのアセットに関する情報を検索するために使用できます。
アトラシアンでは、最も一般的な LDAP ディレクトリ サーバー向けに組み込みのコネクターを提供しています。
- Microsoft Active Directory
- Apache Directory Server (ApacheDS)
- Apple Open Directory
- Fedora Directory Server
- Novell eDirectory
- OpenDS
- OpenLDAP
- OpenLDAP (Posix Schema を使用)
- LDAP 用 Posix Schema
- Sun Directory Server Enterprise Edition (DSEE)
- 汎用 LDAP ディレクトリ サーバー
LDAPS 検証
Secure LDAP (LDAPS) がサポートされており、Insight で動作させるための特別な要件はありません。
LDAPS ソースからインポートしようとしている場合は、インポートされた CA (認証局) 証明書によって LDAP サーバー証明書を検証できます。LDAP サーバー証明書を検証する場合は、Jira で CA 証明書によって LDAP サーバー証明書を検証できるようにするため、LDAP サーバー証明書に署名した CA からルート CA 証明書をインポートする必要があります。詳細についてはこちらをご覧ください。
必ずポートを 3269 に変更してください。これは、LDAP から LDAPS に変更すると、グローバル カタログ (GC) サーバーが 389 ではより大きい AD "フォレスト" を参照する照会を返すが、3268 (LDAPS の場合は 3269) では通常の LDAP サーバーのように動作するという事実によるものです。
インポート フィールド
インポート タイプを選択したら、その詳細を入力する必要があります。Insight に表示されるフィールドについて、次で説明します。
これらのフィールドはインポート タイプ (モジュール) に固有です。
設定 | 説明 |
|---|---|
URL | LDAP を実行しているサーバーのプロトコル、ホスト名、ポート。例: ldap://ldap.example.com:389 |
ユーザー DN | ディレクトリ サーバーに接続する際にアプリケーションが使用するユーザーの識別名。例：
|
パスワード | 上記で指定したユーザーのパスワード。 |
ベース DN | ディレクトリ サーバーに対してクエリを実行する場合に使用するルート識別名（DN）。例：
オブジェクト タイプに特定のベース DN が必要な場合は、後述の Selector の値をご参照ください。 |
| 検索フィルター | フィルター検索の範囲を定義します。初期設定では、すべてのエントリを取得する (objectClass=*) です。たとえば、Jira ユーザーのみが必要な場合は、(objectClass=Person) を設定できます。LDAP 内のユーザーは "objectClass" を "person" に設定する必要があることにご注意ください。 検索フィルターは、同期時間に影響する点で重要です。 |
| インポート時の検索範囲 | 検索範囲によって、LDAP からオブジェクトを取得する方法が決まります。既定の設定は ONE_LEVEL ですが、ロケーターと構造は SUBTREE で作成されます。 |
| 照会に従う | 分散 LDAP 環境でも常に正しいデータを取得できるようにする LDAP 機能です。 |
| 名前空間を含める | このオプションは、LDAP サーバーから Insight オブジェクト構造を作成する際にのみ適用されます。このオプションを選択すると、cn=users,ou=company,=dc=examle,dc=com などの名前空間がオブジェクト タイプの説明に追加されます。同期の実行中にこの値は使用されません。 |
本番環境で同期する前に、必ずテスト環境で同期をテストしてください。
事前定義済みの構造と設定
必須フィールドに入力した後に、次のステップで Insight から定義済みの構造 (オブジェクト タイプ マッピング) と設定 (属性マッピング) を作成するかどうかを尋ねられます。この詳細はインポート タイプによって異なります。一部のオブジェクト タイプ マッピングは初期設定で無効になっています。必ず関連する内容を選択してください。
ユーザーまたはグループのインポートは、Insight LDAP のインポート中に 1 つの組織単位 (OU) からのみ行えます。詳細については、「How to import users or groups from specific OUs with Insight LDAP import (Insight LDAP のインポートで特定の OU からユーザーまたはグループをインポートする方法)」を参照してください。
LDAP インポートの詳細について説明します。
この構造は、LDAP サーバーから返された結果に基づいて作成されます。定義済みの構造を作成すると、指定された設定でクエリが LDAP サーバーに送信されて結果が取得されます。この結果に基づいて、オブジェクト タイプの階層が作成されます。子を持つ各ノード (DN で識別される) は、オブジェクト タイプとして扱われて作成されます。Insight オブジェクト タイプに属する属性は、LDAP サーバーのノードにある属性になります。
LDAP サーバーから返された結果によって子を持たないオブジェクトを取得した場合、事前定義済みの構造は自動で作成されないため手動で作成する必要があります。
事前定義済みの構造では、オブジェクト タイプごとに 2 つの追加属性が作成されます。属性 CN (共通名) はラベルとして使用されて、属性 DN (識別名) は非表示プロパティで設定されます。
LDAP インポートにある事前定義済みの構造で作成されたすべての属性は、既定のテキスト タイプになります。このデータが別のものを表している場合は、属性を確認して適宜変更してください。
例
LDAP 構造の例 | 結果として得られる Insight オブジェクト タイプ構造 |
|---|---|
|
|
事前定義済みの設定では LDAP サーバーがクエリされて、上記の構造と同じ条件に基づいて設定のマッピングが作成されます。検出されたすべての属性は、CN (共通名) と DN (識別名) を追加することでデータ ロケーターとして選択可能になります。
LDAP サーバーの各オブジェクトを一意に識別するため、各オブジェクトの DN に識別子が設定されます。
事前定義済みの設定は接続されている LDAP サーバーによって異なるため、上の例で示した Employees をマッピングする例を次に示します。
例
LDAP インポートがユーザーをインポートするように設定されている場合は、複数のユーザーを作成するために REGEX 設定によってユーザーを分割できます。
作成されたインポート設定
これでインポート設定を表示できるようになりましたが、まだ準備が完了していません。引き続き、オブジェクト タイプと属性のマッピングを作成または確認して、インポート設定に問題がないことを確実にする必要があります。
準備できたら「2. オブジェクト タイプと属性マッピングを作成する」に進みます。
最後に一言
次のステップでは、オブジェクト マッピングの設定を作成します。LDAP インポート タイプに固有の設定をいくつか紹介します。
オブジェクト タイプ マッピング
名前 | 説明 |
|---|---|
| セレクター | LDAP インポート タイプでは、LDAP の検索が実行される前にベース DN 値の直前にセレクターが追加されます。この値は、LDAP の構造化ツリーを特定のノードに絞り込むために使用されます。 検索フィルターは一般設定で指定されたものと同じになりますが、このセレクターによって検索フィルターの適用範囲が絞り込まれます。 例: ベース DN が dc=ad,dc=example,dc=com でセレクターが cn=users の場合、結果として得られる LDAP 検索ベースは cn=users,dc=ad,dc=example,dc=com になります。 |