DSN の作成

このセクションでは、DSN 設定の編集方法と、Garoon API への認証および接続について説明します。

DSN 設定

Microsoft ODBC データソースアドミニストレーターを使ってDSN 設定を編集できます。インストールプロセスではコネクタのインストールで説明のとおり、ユーザーDSN とシステムDSN の両方が作成されることに注意してください。

Note： 本製品は、接続情報をWindows レジストリに保存します。本製品がレジストリに書き込めるようにするには、Power BI を管理者として実行するか、接続にシステムDSN ではなくユーザーDSN を使用します。

DSN 設定を編集するには、次の手順を実行してください。

スタート -> 検索 を選択し、検索ボックスにODBC データソース と入力します。
Power BI Desktop インストールのビット数（32-bit または64-bit）に対応するODBC アドミニストレーターのバージョンを選択してください。
システムデータソースを選択して構成をクリックします。
接続タブの情報を編集してOK をクリックします。

システムDSN をユーザーDSN と同じ方法で設定します。ただし、ステップ3を実行する前に、システムDSN タブに切り替える必要があります。

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