Interstage Application Server ディレクトリサービス運用ガイド

9.1.2.1 セションのオープン/初期設定

　クライアントは、Interstage ディレクトリサービスとの通信を開始する前に、セションの初期化とセションハンドルオプションの設定を行う必要があります。

セションのオープン

　クライアントは、以下の関数を使用してセションをオープンします。オープンした1つのセションは、複数のスレッドで共有することはできません。スレッドで使用する場合は、各スレッドでセションをオープンしてください。
　関数の使用方法については“リファレンスマニュアル(API編)”の“セションのオープンとクローズインタフェース”を参照してください。

• ldap_init() ： セションを初期化してオープンするための関数(SSLを使用しない場合)
• ldapssl_init() ： セションを初期化してオープンするための関数(SSLを使用する場合)

　これらの関数は、セションを識別するためのセションハンドルを返します。セションハンドルは、これ以降の処理においてパラメタとして使用します。

　セションをオープンする際、Interstage ディレクトリサービスのサーバのホスト名、またはIPアドレスとポート番号を指定します。
　ホスト名やIPアドレスは、空白で区切って複数指定することができます。
　また、ldapssl_init()では、SSLにおいて使用するパラメタ（ユーザの証明書など）を指定する必要があります。
　

オプションの設定

　クライアントは、該当するセションにおける処理に関係するパラメタを、セションハンドルオプションとして設定する必要があります。
　クライアントは、以下の関数を使用してセションハンドルオプションの設定/参照を行います。

• ldap_set_option() ： セションハンドルオプションを設定するための関数
• ldap_get_option() ： セションハンドルオプションの値を参照するための関数
• ldap_version() ： ライブラリ/LDAPプロトコル/SSLプロトコルのバージョンを参照するための関数

　関数の使用方法については、“リファレンスマニュアル(API編)”の“セションハンドルオプションの設定/参照インタフェース”を参照してください。
　LDAPプロトコルのバージョンを指定しない場合、LDAP V2プロトコルが使用されます。Interstage ディレクトリサービスでは、LDAP V2プロトコルは未サポートのため、セションハンドルオプションに必ずLDAP V3プロトコルを指定してください。
　LDAP V3プロトコルで使用する文字コードは、UTF-8です。