接続の確立

JDBC データソースの作成

Java アプリケーションから接続するJDBC データソースを CData JDBC Driver for Garoon を使用して作成できます。

以下の手順に従います。

ドライバーのJAR ファイルをクラスパスに追加します。JAR ファイルはインストールディレクトリの lib サブフォルダ内にあります。.lic ファイルはJAR ファイルと同じフォルダ内に配置されていることを確認してください。
ドライバークラスを入力します。次に例を示します。
```
cdata.jdbc.garoon.GaroonDriver
```
JDBC URL を入力します。次に例を示します。
```
jdbc:garoon:User=myuseraccount;Password=mypassword;Url=http://subdomain.domain.com;
```
アプリケーションで同じURL 形式を使用するドライバー間に競合がある場合は、CData ドライバーを使用していることを確認するために次の形式を使用します。
```
jdbc:cdata:garoon:User=myuseraccount;Password=mypassword;Url=http://subdomain.domain.com;
```
URL は jdbc:garoon: または jdbc:cdata:garoon: のいずれかから始まります。 URL には、セミコロン区切りの名前と値のペアで任意の接続プロパティを含めることができます。

認証値に加えて、下記のパラメータを使いGaroon に接続しデータを取得します。

NOTE：サポートされているバージョンで許容されるURL 形式は以下のとおりです。

Cloud 版：https://(subdomain).cybozu.com
Package 版（Windows 環境）：http://(server IP address or host name)/scripts/(installation identifier)/grn.exe
Package 版（Linux 環境）：http://(server IP address or host name)/cgi-bin/(installation identifier)/grn.cgi

Garoon は、以下の認証メソッドをサポートしています。

Garoon への認証には、以下を設定する必要があります。

これまでに説明した認証スキームに加えて、Garoon はBasic 認証ヘッダーおよびSSL 証明書の形で追加のセキュリティを提供します。

Basic 認証を使用しているGaroon 環境では、追加のBasic 資格情報を渡す必要があります。そのためには、次を設定してください。

認証情報に加えて、リクエストの受け入れにSSL 証明書が必須となるようGaroon を設定することができます。そのためには、次を設定してください。

SSLClientCert - SSL 証明書の証明書を含むファイル。または、クライアント証明書のための証明書ストア名。
SSLClientCertType - 証明書の種類。
SSLClientCertSubject - （オプション）証明書ストアで証明書を検索する際に、ストア内でこのプロパティの値を含むサブジェクトを検索します。
SSLClientCertPassword - 証明書ストアでパスワードが必要とされる場合、このプロパティを使用してパスワードを指定し、証明書ストアにアクセスできます。