InfoDirectory SDK 使用手引書

2.1.1.2 ユーザ認証

　セションのオープン／初期設定が完了後、InfoDirectoryサーバにアクセスする前に、ユーザ認証する必要があります。ユーザ認証は、以下の関数を使用します。

• ldap_simple_bind() ： 非同期型の簡易認証
• ldap_simple_bind_s() ： 同期型の簡易認証
• ldap_sasl_bind() ： 非同期型の証明書ベースの認証
• ldap_sasl_bind_s() ： 同期型の証明書ベースの認証
  

　ただし、LDAP V3プロトコルを使用する場合、ユーザ認証を省略できます。ユーザ認証を省略した場合、InfoDirectoryサーバに対するアクセスは、アノニマスのアクセスとして処理されます。
　また、ldapssl_init()を使用してセションをオープンした場合、SSLによる安全な通信が可能です。証明書ベースで認証する場合、必ず、ldapssl_init()でセションを初期化する必要があります。以下にユーザ認証の組合せを示します。

[表: セションのオープン／初期化とユーザ認証の組合せ]

組合せ	セションの オープン／初期設定	ユーザ認証	使用されるセションと認証方法
a	ldap_init()	ldap_simple_bind() / ldap_simple_bind_s()	DN、パスワードを使用した簡易認証をします。SSLの安全な通信経路は使用されません。
b	ldap_init()	ldap_sasl_bind() / ldap_sasl_bind_s()	この組合せでは使用できません。
c	ldapssl_init()	ldap_simple_bind() / ldap_simple_bind_s()	DN、パスワードを使用した簡易認証を行い、SSLの安全な通信経路が使用されます。
d	ldapssl_init()	ldap_sasl_bind() / ldap_sasl_bind_s()	証明書ベースの認証を行い、SSLの安全な通信経路が使用されます。

　表の組合せa〜dについて、以下に説明します。

1. SSLを使用しないセションのオープン関数と簡易認証関数の使用

   　DN、パスワードを使用した簡易認証をします。SSLの安全な通信経路は使用されません。
   

2. SSLを使用しないセションのオープン関数と証明書ベースの認証関数の使用

   　この組合せでは使用できません。
   

3. SSLを使用するセションのオープン関数と簡易認証関数の使用

   　ldapssl_init()で初期化したSSL証明書環境を使用して、セションがクローズするまで、SSLによる安全な通信経路が使用されます。ユーザの認証には、簡易認証関数のパラメタで指定されるDNとパスワードが使用されます。SSLエラー情報の取得には、ldapssl_error()を使用します。
   

4. SSLを使用するセションのオープン関数と証明書ベースの認証関数の使用

   　ldapssl_init()で初期化したSSL証明書環境を使用して、セションがクローズするまで、SSLによる安全な通信経路が使用されます。
   　ユーザの認証には、ldapssl_init()で初期化されたSSL証明書環境にある証明書をベースに認証が行われます。この場合、ldap_sasl_bind()／ldap_sasl_bind_s()のパラメタに、別途、DN、パスワードおよび証明書データを指定する必要がありません。また、InfoDirectoryサーバとの相互認証は、下位のSSLレイヤで行われるため、呼出し元には通知されません。SSLエラー情報の取得には、ldapssl_error()を使用します。