AD/LDAP Connectorのインストールと設定

AD/LDAP Connectorをインストールして設定する方法を説明します。

​

前提条件

• お使いのシステムがシステム要件を満たしていることを確認してください。
• Git、Node.js、および npm がすでにインストールされていることを確認してください。
• ほとんどのプラットフォームでは、root 権限または管理者権限が必要です。

​

Windows 用コネクタのインストール

​

インストーラーをダウンロードして実行する

Auth0 Dashboard > Authentication > Enterprise > Active Directory/LDAP に移動し、設定する接続を選択します。

Setup タブで Install For Windows ボタンを選択し、最新のインストーラー (MSI ファイル) をダウンロードします。

インストーラーを実行し、画面の指示に従って AD/LDAP Connector を Windows サービスとしてインストールします。

インストールが完了すると、localhost を指す画面がブラウザーに表示されます。

接続をプロビジョニングした際に提供された TICKET URL を入力します。TICKET URL は、Auth0 内でこのコネクターを一意に識別します。コネクターはこれを使用して Auth0 サーバーと通信し、設定を自動的に完了します。

​

LDAP への接続

LDAP の設定を入力します。

設定	説明
LDAP Connection String	たとえば ldap://ldap.internal.contoso.com です。これは、LDAP サーバーのプロトコルとドメイン名または IP アドレスを指定する文字列です。LDAP サーバーは、Active Directory がインストールされているローカルのドメインコントローラーです。プロトコルには ldap または ldaps を使用できます。ldaps を使用する場合は、現在のサーバーで証明書が有効であることを確認してください。
Base DN	たとえば dc=contoso,dc=com です。これは、コネクターが実行するすべてのクエリのベースコンテナーです。
Username	たとえば cn=svcauth0,dc=services,dc=contoso,dc=com です。クエリの実行に使用するユーザーの完全識別名です。
Password	ユーザーのパスワードです。

上記の情報を送信すると、コネクターは入力内容を検証するために一連のテストを実行します。結果は、コンソール画面の Configuration Log に表示されます。

すべてのテストが緑色であることを確認してください。

テスト	説明	トラブルシューティング
Test 1	指定された LDAP サーバーとポートへの TCP 接続の確立を試行します。	基本的なネットワーク接続と、この接続を妨げる可能性のあるファイアウォール設定を確認してください。
Test 2	指定された LDAP サーバーとポートに対して、指定されたユーザー名とパスワードを使用した LDAP バインドを試行します。	LDAP 接続文字列、検索パス、ユーザー名、パスワードを確認してください。
Test 3	指定されたユーザー名の権限を確認するために、ディレクトリに対する LDAP 検索を試行します。	対象ディレクトリ内で、そのユーザー名に付与されている権限を確認してください。
Test 4	Auth0 サーバーへの接続の確立を試行します。	ネットワーク接続と、この接続を妨げる可能性のあるファイアウォール設定を確認してください。

​

他のプラットフォーム向けのコネクターをインストールする

1. 最新バージョンの Auth0 Active Directory/LDAP Connector パッケージを /tmp にダウンロードしてインストールします。詳しくは、AD/LDAP Connector リポジトリを参照してください。

2. サーバーを起動します。 node server.jsチケット番号の入力を求められたら、Auth0 管理ダッシュボードの Setup AD/LDAP connector 画面にある Settings タブから、チケットの完全な URL を入力します。

3. 次に、LDAP 接続と認証の詳細を含む config.json 設定ファイルの編集を求められます。

4. コネクターを起動するため、再度 node server.js を実行します。この時点で、config.json 内の LDAP_BIND_PASSWORD 行は LDAP_BIND_CREDENTIALS に変わる点に注意してください。

5. コネクターが起動したら、コネクターをデーモン化する必要があります (まだ使用するツールを決めていない場合は、systemd を検討してください) 。たとえば、Ubuntu Xenial で systemd を使用する場合、/lib/systemd/system/auth0-adldap.service ファイルには次の内容を記述できます。

   [Unit]
   Description=Auth0 AD LDAP Agent
   After=network.target
   
   [Service]
   Type=simple
   Restart=always
   User=ubuntu
   WorkingDirectory=/opt/auth0-adldap
   ExecStart=/usr/bin/node server.js
   

6. 管理 UI にアクセスするには、node admin/server.js を実行します。管理 UI が起動し、http://localhost:8357 で利用できるようになります。

初めてコネクターを設定するときに Invalid Ticket メッセージが表示される場合、最も可能性が高い原因はネットワークの問題です (たとえば、プロキシの背後でコネクターを実行している場合などです) 。

​

詳細情報

• AD/LDAP Connector のトラブルシューティング
• AD/LDAP Connector のシステム要件
• AD/LDAP Connector を Auth0 の接続に関連付ける
• クライアント証明書を使用した AD/LDAP Connector 認証の設定
• Kerberos を使用した AD/LDAP Connector 認証の設定
• AD/LDAP Connector の更新