接続の確立
JDBC データソースの作成
Java アプリケーションから接続するJDBC データソースを作成できます。CData JDBC Driver for Garoon に基づくJDBC データソースの作成は、3つの基本ステップで構成されます。
- ドライバーのJAR ファイルをクラスパスに追加します。JAR ファイルはインストールディレクトリの［lib］サブフォルダ内にあります。.lic ファイルはJAR ファイルと同じフォルダ内に配置される必要があることに注意してください。
- ドライバークラスを入力します。次に例を示します。
cdata.jdbc.garoon.GaroonDriver
- JDBC URL を入力します。次に例を示します。
jdbc:garoon:User=myuseraccount;Password=mypassword;Url=http://subdomain.domain.com; or jdbc:cdata:garoon:User=myuseraccount;Password=mypassword;Url=http://subdomain.domain.com;
上記の2つ目の形式は、同じURL 形式を使用しているドライバー間でアプリケーションに競合がある場合は、CData ドライバーを使用していることを確認するために常に使用できます。URL は "jdbc:garoon:" または"jdbc:cdata:garoon:" のいずれかから始まり、任意の接続プロパティの名前と値のペアをセミコロン区切りで入力します。
Garoon への接続
認証値に加えて、下記のパラメータを使いGaroon に接続しデータを取得します。
- URL：アカウントのURL。
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 への認証には、以下を設定する必要があります。
- User：アカウントのユーザー名。
- Password：アカウントのパスワード。
- AuthScheme：AuthScheme をPassword に設定。
追加のセキュリティ
これまでに説明した認証スキームに加えて、Garoon はBasic 認証ヘッダーおよびSSL 証明書の形で追加のセキュリティを提供します。Basic
Basic 認証を使用しているGaroon 環境では、追加のBasic 資格情報を渡す必要があります。そのためには、次を設定してください。
- BasicAuthUser - Basic ログイン名。
- BasicAuthPassword - Basic パスワード。
クライアントSSL
認証情報に加えて、リクエストの受け入れにSSL 証明書が必須となるようGaroon を設定することができます。そのためには、次を設定してください。
- SSLClientCert - SSL 証明書の証明書を含むファイル。または、クライアント証明書のための証明書ストア名。
- SSLClientCertType - 証明書の種類。
- SSLClientCertSubject - （オプション）証明書ストアで証明書を検索する際に、ストア内でこのプロパティの値を含むサブジェクトを検索します。
- SSLClientCertPassword - 証明書ストアでパスワードが必要とされる場合、このプロパティを使用してパスワードを指定し、証明書ストアにアクセスできます。