接続の確立

コネクタ内で利用可能なオブジェクトは、"cdata.garoon" モジュールからアクセスできます。モジュールのオブジェクトを直接使用するには：

モジュールを以下のようにインポートします。
```
import cdata.garoon as mod
```
接続を確立するには、以下のような適切な接続文字列を使用してコネクタオブジェクトからconnect() メソッドを呼び出します。
```
mod.connect("User=myuseraccount;Password=mypassword;Url=http://subdomain.domain.com;")
```

Garoon への接続

認証値に加えて、下記のパラメータを使い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 - 証明書ストアでパスワードが必要とされる場合、このプロパティを使用してパスワードを指定し、証明書ストアにアクセスできます。