p4 ldap
概要
LDAPコンフィギュレーション仕様の作成、編集、削除、または既存のLDAPコンフィギュレーションのテストを行います。
構文
p4 [gopts] ldap configname
p4 [gopts] ldap -i
p4 [gopts] ldap -o configname
p4 [gopts] ldap -d configname
p4 [gopts] ldap -t username configname
解説
p4 ldapコマンドには5つの構文バリアントがあります。
-
最初のバリアントは、LDAPコンフィギュレーションの作成や編集ができます。
-
p4 ldap -iコマンドを使用すると、LDAPコンフィギュレーションを標準入力から読み取ることができます。
-
p4 ldap -oコマンドを使用すると、指定のLDAPコンフィギュレーションを表示できます。
-
p4 ldap -dコマンドを使用すると、指定のLDAPコンフィギュレーションを削除できます。
-
p4 ldap -tコマンドを使用すると、既存のLDAPコンフィギュレーションをテストできます。
LDAPコンフィギュレーションを作成する
p4 ldapコマンドで作成したLDAPコンフィギュレーションでは、Perforceサーバがユーザを認証するアクティブディレクトリまたはその他のLDAPサーバを指定します。
LDAPコンフィギュレーション仕様を作成するには、AD/LDAPサーバのホスト名とポート番号、バインドメソッドについての情報、セキュリティパラメータを指定する値を設定します。バインドメソッドには以下が含まれます。
-
シンプル: ユーザ名に基づくテンプレートを使用して、Perforceサーバがバインドを試行する識別名を生成し、ユーザのパスワードを検証します。例:
uid=%user%,ou=users,dc=example,doc=org
-
検索: LDAP検索クエリを使用して、ユーザレコードを検索します。この検索は、既知のベースDNとLDAP検索クエリをもとにして行われます。これらはLDAPコンフィギュレーション仕様の
SearchBaseDN、SearchFilter、SearchScopeの各フィールドを使用して特定することができます。また、このメソッドでは、完全な識別名とディレクトリ内の既知の読み取り専用エンティティのパスワードが必要になることがあります。これらはLDAPコンフィギュレーションのSearchBindDNとSearchPasswdフィールドを使用して特定することができます。ここで、検索クエリのサンプルを示します。BaseDN: ou=users,dc=example,dc=org LDAP query: (uid=%user%)
-
SASL: AD/LDAPサーバで
SASL DIGEST-MD5がサポートされている場合、AD/LDAPサーバに対するユーザの検索方法は異なるため、バインドを試行する前に識別名を特定する必要はありません。ユーザは、ユーザ名、パスワード、オプションの領域を指定します。
LDAPコンフィギュレーションの作成に加えて、次の構成可能変数を使用してコンフィギュレーションを有効にし、さらに認証プロセスを設定します。
-
auth.ldap.order.N- AD/LDAPサーバを有効にし、検索の順序を指定します。 -
auth.default.method- ユーザをPerforceで認証するか、LDAPを使用して認証するか指定します。 -
auth.ldap.userautocreate- LDAP認証を使用するとき、ログイン時に新しいユーザを自動で作成するか否かを指定します。 -
auth.ldap.timeout- 接続をあきらめるまでの時間を指定します。 -
auth.ldap.cafile- AD/LDAPサーバでSSLまたはTLSが使用される場合、証明書ファイルへのパスを指定します。 -
auth.ldap.ssllevel- SSL証明書の検証レベルを指定します。
詳細については、「“構成可能変数”」を参照してください。
ユーザベースの認証:
ここで、LDAPコンフィギュレーションのサンプルを示します。
Name: sleepy Host: openldap.example.com Port: 389 Encryption: tls BindMethod: search SearchBaseDN: ou=employees,dc=example,dc=com SearchFilter: (cn=%user%) SearchScope: subtree GroupSearchScope: subtree
LDAPコンフィギュレーションをテストする
LDAPコンフィギュレーションをテストするには、以下のようなコマンドを使用します。
p4 ldap -t userX myConfig
このコマンドは、パスワードの入力を指示し、userXが見つかった場合は正常に戻ります。myConfigで指定したAD/LDAPサーバがダウンしている場合や、ユーザがみつからない場合、あるいは入力したパスワードが正しくない場合は、コマンドは詳細なエラーメッセージを返します。例:
c:\temp>p4 -p 1666 ldap -t userX sleepy Enter password: Authentication as cn=userX,ou=employees,dc=example,dc=com failed. Reason: Invalid Credentials
フォームフィールド
|
フィールド名 |
タイプ |
解説 |
|---|---|---|
|
|
読み取り専用 |
LDAPコンフィギュレーションの名前。 関連するバインドメソッド: すべて |
|
|
書き込み可能 |
AD/LDAPサーバの完全修飾ドメイン名。デフォルトは 関連するバインドメソッド: すべて |
|
|
書き込み可能 |
接続するポート。デフォルトは 関連するバインドメソッド: すべて |
|
|
書き込み可能 |
関連するバインドメソッド: すべて |
|
|
書き込み可能 |
関連するバインドメソッド: すべて |
|
|
書き込み可能 |
ユーザの資格情報を検証するためのバインドに使用される識別名。 関連するバインドメソッド: シンプル |
|
|
書き込み可能 |
ユーザオブジェクトの検索を開始する識別名。 関連するバインドメソッド: 検索 |
|
|
書き込み可能 |
バインドするユーザオブジェクトを識別するLDAPクエリフィルタ。 関連するバインドメソッド: 検索 |
|
|
書き込み可能 |
次のいずれかになります。
関連するバインドメソッド: 検索 |
|
|
書き込み可能 |
ディレクトリ検索のためにバインドされる識別名。 関連するバインドメソッド: 検索 |
|
|
書き込み可能 |
関連するバインドメソッド: 検索 |
|
|
書き込み可能 |
SASLでユーザ認証を行う時に使用するオプションの領域。 関連するバインドメソッド: sasl |
|
|
書き込み可能 |
グループ検索に使用するフィルタ。 関連するバインドメソッド: すべて |
|
|
書き込み可能 |
グループ検索を実行するための検索ベース。デフォルトは 関連するバインドメソッド: すべて |
|
|
書き込み可能 |
グループ検索時に次の1つを使用します。
関連するバインドメソッド: すべて |
オプション
|
|
指定のLDAPコンフィギュレーションを削除します。 |
|
|
標準入力からLDAP仕様を読み取ります。 |
|
|
指定のLDAPコンフィギュレーションを標準出力に書き込みます。 |
|
|
指定のLDAPコンフィギュレーションに対して認証するユーザー名を指定します。これは、テストを目的としています。このコマンドは、成功のメッセージまたは詳細なエラーメッセージを返します。このテストを実行するためにコンフィギュレーションを有効にする必要はありません。 |
使用上の留意点
|
ファイル引数にリビジョン指定子を使えるか？ |
ファイル引数にリビジョン範囲を使えるか？ |
最低限必要なアクセスレベル |
|---|---|---|
|
適用外 |
適用外 |
|
例
|
p4 ldap myLdap |
|
|
p4 ldap -o myLdap |
|
|
p4 ldap -t Joanna myLdap |
|
|
p4 ldap -d myLdap |
|