接続の確立

接続プロファイルの設定

［CData］リボンから［データの取得］をクリックし、［取得元：Box］> 設定済みの接続を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、［新しいBox 接続］をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。

Box への接続

本製品は、Box テーブルおよびフォルダへのアクセスを実現します。なお、本製品はBox に格納されているファイルの内容を更新したり、ファイルの内容をテーブルやカラムとしてモデル化したりはできません。

Box への認証

本製品は、Box への接続にOAuth 認証標準を使います。ユーザーアカウントまたはサービスアカウントで認証できます。下記で説明するとおり、本製品はこれらの認証フローをサポートします。

ユーザーアカウント（OAuth）

AuthScheme は、すべてのユーザーアカウントフローでOAuth に設定する必要があります。

デスクトップアプリケーション

CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。代わりに、カスタムOAuth アプリケーションを作成することも可能です。カスタムアプリケーションの作成およびその理由については、カスタムOAuth アプリの作成を参照してください。

OAuth アクセストークンの取得およびリフレッシュ

次を設定して、接続してください。

OAuthClientId（カスタムアプリのみ）：アプリの登録時に割り当てられたクライアントId に設定。
OAuthClientSecret（カスタムアプリのみ）：アプリの登録時に割り当てられたクライアントシークレットに設定。
CallbackURL（カスタムアプリのみ）：アプリの登録時に定義されたリダイレクトURI に設定。次に例を示します。 https://localhost:3333

接続すると、本製品はデフォルトブラウザでBox のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。本製品はアクセストークンの期限が切れると自動的にリフレッシュします。

サービスアカウント

サービスアカウントには、ブラウザによるユーザー認証が不要なサイレント認証があります。また、サービスアカウントを使用して、エンタープライズ全体のアクセススコープを本製品に委任することもできます。

サービスアカウントを使用するには、OAuth アプリケーションの作成が必要です。アプリの作成および認可については、カスタムOAuth アプリの作成を参照してください。これでサービスアカウントにアクセス権があるBox データに接続できます。

次の接続プロパティを設定して、接続してください。

AuthScheme：OAuthJWT に設定。
OAuthClientId：アプリケーション設定のクライアントId に設定。
OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
OAuthJWTCertType："PEMKEY_FILE" に設定。
OAuthJWTCert：生成した.pem ファイルのパスに設定。
OAuthJWTCertPassword：.pem ファイルのパスワードに設定。
OAuthJWTCertSubject：証明書のサブジェクトに設定。代わりに"*" に設定すると、証明書ストアの1番目の証明書が選択されます。
OAuthJWTSubjectType：アプリケーション設定で選択した［Application Access Value］に応じて、［enterprise］または［user］に設定。この接続プロパティのデフォルト値は［enterprise］です。
OAuthJWTSubject：サブジェクトタイプが［enterprise］に設定されている場合は、これをエンタープライズID に設定します。［user］に設定されている場合は、アプリのユーザーID に設定します。
OAuthJWTPublicKeyId：アプリケーション設定の公開キーID に設定。

接続すると、本製品はサービスアカウントでのOAuth フローを完了します。

接続プロパティ

最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。

接続の管理

Box への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理を参照してください。

Excel Add-In for Box