Box 接続

Box 内のデータにアクセスするには、そのデータ用の接続資産を作成します。

Box プラットフォームは、クラウド・コンテンツ・マネジメントおよびファイル共有サービスです。

前提条件: Box でカスタム・アプリを作成する

Box への接続を作成する前に、Box Developer Console でカスタム・アプリを作成します。 ユーザーがファイルを共有するために使用できるアプリケーション・レベルのアクセス用のアプリを作成するか、またはすべてのユーザー・アカウントに対するエンタープライズ・レベルのアクセス用のアプリを作成できます。 エンタープライズ・レベルのアクセスでは、ユーザーはそのアプリケーションを使用してファイルやフォルダーを共有する必要はありません。

  1. 進む Box Developer Consoleで、ウィザードに従って カスタム・アプリケーションを作成します。 認証方式の場合は、 OAuth 2.0 with JWT (Server Authentication)を選択してください。

  2. 構成 ページで以下の選択を行います。 それ以外の場合はデフォルト設定のままにします。

    1. アプリケーション・アクセス・レベルの 2 つの選択項目のいずれかを選択してください:
  3. デフォルトの アプリ・アクセスのみ 選択を保持して、ユーザーがファイルを共有するアクセスを許可します。
  4. すべてのユーザー・アカウントへの全社的なアクセス権限を持つアプリを作成するには、 App + Enterprise Access を選択してください。
  5. 公開鍵の追加と管理の下で、 公開/秘密鍵ペアの生成をクリックしてください。 この項目を選択するには、Box アカウントで 2 要素認証が有効になっている必要があります。ただしこの設定は後で無効にできます。 生成された鍵ペアは、ダウンロード用の構成 (*_config.json) ファイルが生成されます。 このファイルの情報は、Watson Studio で接続を作成するときに必要となります。

  6. App + Enterprise Accessを選択した場合は、 拡張機能の下で、以下のチェック・ボックスを両方とも選択します:

  7. as-user ヘッダーを使用した API 呼び出しを実行する
  8. ユーザー・アクセス・トークンを生成する

  9. 許可を得るために Box エンタープライズ管理者にアプリ・クライアント ID を送信します: Box Developer Console にあるアプリケーションに移動して、アプリケーションの左側のサイドバーから 一般 リンクを選択してください。 アプリ許可 セクションまでスクロールダウンします。

Box 接続を作成する

プロジェクト内

  1. プロジェクト・ページで、 「新規資産」> 「接続」に移動し、Box 接続を選択してください。
  2. 以下の設定に、ダウンロードした構成ファイルの値を入力します。
  3. Client ID
  4. クライアントの秘密鍵
  5. 企業 ID
  6. 秘密鍵 (各 \n を改行で置換)
  7. 秘密鍵パスワード (構成ファイル内の passphrase 値)
  8. 公開鍵 (構成ファイル内の publicKeyID 値)

エンタープライズ・レベルのアプリ

全社的なアクセス・アプリを構成した場合は、Box ユーザー・アカウントのユーザー名を ユーザー名 フィールドに入力します。

アプリケーション・レベルのアプリ

ユーザーは、アプリがファイルにアクセスできるようにするために、ファイルをアプリのメール・アドレスと明示的に共有する必要があります。

  1. アプリの E メール・アドレスを確認するには、接続に対して REST 呼び出しを実行します。 例:

    PUT https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}

    要求本文:

    {}
    

    戻り値:

    {
     "login_name": "[email protected]"
    }
    
  2. Watson Studio からアクセスできるようにする Box のファイルとフォルダーを、REST 呼び出しで返されたログイン名を使用して共有します。

次のステップ: 接続からデータ資産を追加する

この接続を使用できる場所

Box 接続は、以下のワークスペースおよびツールで使用できます:

プロジェクト

  • Data Refinery (Watson Studio または Watson Knowledge Catalog)
  • DataStage (DataStage サービス)
  • メタデータのインポート (Watson Knowledge Catalog)

カタログ

  • プラットフォーム資産カタログ
  • 他のカタログ (Watson Knowledge Catalog)

サポートされるファイル・タイプ

Box 接続は、Avro、CSV、Delimited text、Excel、JSON、ORC、Parquet、SAS、SAV、SHP、および XML の各ファイル・タイプをサポートします。

詳細情報

Box カスタム・アプリケーション

親トピック: サポートされた接続