接続の確立

JDBC データソースの作成

Java アプリケーションから接続するJDBC データソースを作成できます。CData JDBC Driver for LDAP に基づくJDBC データソースの作成は、3つの基本ステップで構成されます。

ドライバーのJAR ファイルをクラスパスに追加します。JAR ファイルはインストールディレクトリの［lib］サブフォルダ内にあります。.lic ファイルはJAR ファイルと同じフォルダ内に配置される必要があることに注意してください。
ドライバークラスを入力します。次に例を示します。
```
cdata.jdbc.ldap.LDAPDriver
```
JDBC URL を入力します。次に例を示します。
```
jdbc:ldap:user=MyUserName;password=MyPassword;Server=MyServer;Port=MyPort;

or

jdbc:cdata:ldap:user=MyUserName;password=MyPassword;Server=MyServer;Port=MyPort;
```
上記の2つ目の形式は、同じURL 形式を使用しているドライバー間でアプリケーションに競合がある場合は、CData ドライバーを使用していることを確認するために常に使用できます。URL は "jdbc:ldap:" または"jdbc:cdata:ldap:" のいずれかから始まり、任意の接続プロパティの名前と値のペアをセミコロン区切りで入力します。

LDAP への接続

CData driver for LDAP は、LDAP サーバーオブジェクトへの接続をサポートします。接続するには必要なプロパティを設定します。

必須プロパティ

Server：LDAP サーバーのドメイン名、もしくはIP。
Port：The port setting defaults to port=389.Specifying the port to a different setting is optional.
BaseDN：このプロパティは、結果を指定されたサブツリーに限定するために使用されます。BaseDN（Base Distinguished Name）の範囲を絞ることはパフォーマンスを劇的に向上させます。例えば、cn=users,dc=domain の値は、cn=users およびその子に含まれる結果のみを返します。

オプションのプロパティ

Optional properties can be used to further refine control of the returned results.

FollowReferrals：This property follows referrals when TRUE.The returned response then becomes read only.To modify data returned by a referral server, open a new connection to the server by specifying server and port.
Scope：This property enables more control over the search depth of the LDAP tree, starting with BaseDN.範囲を限定することで、検索パフォーマンスを大幅に向上させられます。Scope を次の値のいずれかに指定します：
- WholeSubtree：検索の範囲を、BaseDN およびすべての子階層に制限します。
- SingleLevel：検索の範囲を、BaseDN および1つ下の子階層に制限します。
- BaseObject：検索の範囲を、ベースオブジェクトのみに制限します。
LDAPVersion：サーバーに接続し、通信する際に使われるLDAP バージョン。2 に設定します。

LDAP への認証

リクエストを認証するには、User およびPassword プロパティを有効なLDAP クレデンシャルに設定します。例えば、User をDomain\\BobF またはcn=Bob F,ou=Employees,dc=Domain に設定します。

The AuthMechanism properties for the 本製品 are as follows:

SIMPLE：The default plaintext value of the authentication mechanism to login to the server.
NEGOTIATE：Negotiates whether to use NTLN or Kerberos when authenticating to the server.

SSL Configuration

By default, the driver uses plaintext when communicating with the server set to port=389. The driver automatically switches to use SSL when talking to the LDAP on port=636. You can force the connection to use the SSL connection property when set to SSL=TRUE.

テーブルのカスタマイズ

本製品は、LDAP エンティティから最も頻繁に必要とされるカラムを表示します。ただし、その他のデータを使用する必要がある場合は、テーブルを簡単に変更できます。テーブルは、シンプルな形式のスキーマファイルで定義されます。

デフォルトのスキーマを拡張する方法や独自のスキーマを記述する方法については、LDAP テーブルとの連携を参照してください。カスタムスキーマを使用するには、Location プロパティをスキーマファイルを有するフォルダに設定します。テーブルおよびビューについて詳しくは、サンプルデータモデルを参照してください。