5.16.4　Active Directoryを使用する場合の設定

(a)　ログインモジュールの設定

認証方式にパスワード認証を使用する場合はWebPasswordLDAPLoginModule，クライアント証明を使用する場合はWebCertificateLoginModuleを設定します。

(b)　ログインモジュールのオプションの指定（パスワード認証を使用する場合）

WebPasswordLDAPLoginModuleのオプションに「ldap.w」を設定します。なお，SSOを使用する場合は「sso.ldap.w」を設定します。

(a)　ユーザ識別属性の指定

ユーザ識別属性に，「cn」（フルネームに該当）または「sAMAccountName」を設定します。

設定例を次に示します。

（例1）「cn」をユーザ識別属性に使用する場合

com.cosminexus.admin.auth.ldap.attr.userid.0=cn

（例2）「sAMAccountName」をユーザ識別属性に使用する場合

com.cosminexus.admin.auth.ldap.attr.userid.0=sAMAccountName

ユーザ識別属性を「sAMAccountName」に設定した場合リポジトリのユーザエントリ（RDN）の検索が必要となります。検索に必要なプロパティとその設定例を次に示します。

（例）

java.naming.security.principal.0=cn=Administrator,cn=Users,dc=cosminexus,dc=com
java.naming.security.credentials.0=adminpassword
com.cosminexus.admin.auth.ldap.search.userrdn.0=true
com.cosminexus.admin.auth.ldap.search.scope.0=onelevel

なお，「sAMAccountName」をユーザ識別属性に使用する場合は，LdapUserDataManagerクラスのaddUserData(String uid, UserData userData)メソッドは使用できません。ユーザを追加する場合は addUserData(String uid, UserData userData, String name, String value)メソッドを使用してください。また，属性名の引数（String name）には，「cn」を設定してください。

(b)　DNでユーザIDとして使用する属性名の指定（クライアント証明書を使用する場合）

クライアント証明書を使用する場合は，クライアント証明書に格納されているDN（クライアント証明書の被認証者識別名）を分解したあと，ユーザIDとして使用する属性名を設定します。設定例を次に示します。

（例）

com.cosminexus.admin.auth.ldap.certificate.attr.userid.0=cn

ここで指定する属性名は，「(a)　ユーザ識別属性の指定」で指定するユーザ識別属性とは異なります。

(c)　パスワード属性の指定（パスワード認証を使用する場合）

パスワード属性に「unicodePwd」を設定します。設定例を次に示します。

（例）

com.cosminexus.admin.auth.ldap.attr.password.0=unicodePwd

(d)　LDAPディレクトリサーバの種類の指定（パスワード認証を使用する場合）

接続先のLDAPディレクトリサーバの種類に「AD」を指定した行を追加します。LDAP設定番号が「0」の場合の設定例を次に示します。

（例）

com.cosminexus.admin.auth.ldap.directory.kind.0=AD

(e)　URLプロトコルの変更

接続先のLDAPディレクトリサーバのURLのプロトコルに「ldaps」を設定します。設定例を次に示します。なお，ポート番号は省略できます。

（例）

変更前：java.naming.provider.url.0=ldap://localhost:389

変更後：java.naming.provider.url.0=ldaps://localhost.example.com:636

(f)　URLホスト名の注意事項

Active DirectoryのドメインコントローラのFQDN（完全修飾ドメイン名）を指定してください。そのとき，hostsファイルなどでホスト名を解決できるようにする必要があります。