Box の構成

限定公開プレビュー版: データ取り込みデータストアは限定公開プレビュー版です。データ取り込みデータストアを使用するには、許可リストに登録されている必要があります。許可リストに追加するには、Google のアカウント担当者またはセールスチームにお問い合わせください。

公開プレビュー版: 連携検索とアクションの機能は公開プレビュー版です。この機能は、サービス固有規約の「一般サービス規約」セクションの「一般提供前サービス規約」の対象となります。pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。詳細については、リリース ステージの説明をご覧ください。

このページでは、Box データストアを作成する前にサードパーティの構成を行う方法について説明します。

Box アプリを作成する

1. 管理者アカウントで Box 開発者コンソールにログインします。
2. [Create platform app] をクリックします。
3. [App type] で [Custom app] を選択します。
4. [App name] を入力します。

5. 次のプロパティ値を設定します。

   • Purpose: Integration。
   • Categories: AI。
   • External system: Google Cloud Gemini Enterprise。

6. [Authentication method] で [Server Auth - JWT] を選択します。

7. [アプリを作成] をクリックします。

Box アプリを構成する

1. Box Developer Console で、[My Platform Apps] ページから [Platform app] を選択します。

   

   Box Developer Console の [My Platform Apps] ページ。

2. [構成] タブで、次の操作を行います。

   1. [App access level] セクションで、[App + Enterprise access] を選択します。

      注: 個々のユーザー アカウントからファイル、コメント、タスクを取得するには、App + Enterprise access が必要です。また、このアクセスレベルは増分同期機能にも必要です。Enterprise event stream は、このレベルを使用して、新しいファイルや変更されたファイル、コメント、タスクを効率的に特定して取得します。

      

      Box アプリを構成します。

   2. [Application scopes] セクションで、次の表から接続モードに基づいてスコープを選択します。

      接続モード	スコープ	目的
      連携検索	Read all files and folders stored in Box	コメントとタスクを取得し、検索用にファイルをプレビューするために必要です。
      連携検索とアクション	Write all files and folders stored in Box	ファイルのコピー、アップロード、ダウンロード、コメントとタスクの取得、検索用のファイルのプレビューを行うために必要です。
      データの取り込み	Read all files and folders stored in Box	データ取り込みに必要です。
      	Manage users	ユーザーのリストを取得するために必要です。これにより、個々のユーザー アカウントからファイル、コメント、タスクを取得して取り込むことができます。管理者サービス アカウントは、ユーザーが所有するすべてのファイルにアクセスできるわけではありません。as-user ヘッダーを使用すると、システムが特定のユーザーとして API リクエストを行い、そのユーザーのデータにアクセスできます。
      	Manage enterprise properties	増分同期機能に必要なスコープです。このスコープにより、Enterprise event stream を使用して取り込みの変更を追跡できます。
      	Manage groups	グループとそのメンバーのリストを取得するために必要です。これは、取り込み中のアクセス制御に不可欠です。

      注: データストアを検索のみに使用し、Box のコンテンツを変更するアクションを実行しない場合は、スコープを [Read all files and folders stored in Box] に制限できます。Box のコンテンツの更新を伴うアクションには、[Write all files and folders stored in Box] スコープが必要です。

3. [Add and manage public keys] セクションで、[Generate a public/private keypair] をクリックします。

   • 公開鍵は、ID とともにコンソールに自動的にアップロードされます。この ID は、接続の作成時に使用されます。
   • 秘密鍵とパスフレーズを含む構成ファイルをダウンロードできます。このファイルは後で使用するため、必ず保管してください。
   • 必要に応じて、独自の鍵を生成するには、Box 鍵ペアの設定ガイドをご覧ください。

4. [変更を保存] をクリックします。

Box アプリを承認する

デベロッパー コンソールから Box アプリを承認するには、次の操作を行います。

1. Box Developer Console で、[Platform app] を選択し、[Authorization] タブに移動します。
2. [Review and submit] をクリックします。

3. [Review app authorization submission] ダイアログで、[Submit] をクリックします。

   承認リクエストが正常に送信されると、次の確認メッセージが表示されます。

   

   承認リクエストが正常に送信されました。

Box 管理プラットフォームのアプリ マネージャーから Box アプリを承認するには、次の操作を行います。

1. 管理者アカウントで Box 管理プラットフォームのアプリ マネージャーにログインします。
2. 構成した [Platform app] を選択します。
3. 該当する行の 3 つのドット [...] をクリックします。
4. プルダウン リストから [Authorize app] を選択します。
5. [Authorize app] ダイアログで、[Authorize] をクリックして承認プロセスを完了します。

Box の認証情報を取得する

Box の認証情報を取得する手順は次のとおりです。

1. Box Developer Console で、[My Platform Apps] ページから [Platform app] を選択します。

• エンタープライズ ID: [General settings] タブで取得します。

  

  エンタープライズ ID を取得します。

• クライアント ID とクライアント シークレット: [OAuth 2.0 credentials] の [Configuration] タブから取得します。

  

  クライアント構成を取得します。

• 秘密鍵、鍵 ID、パスフレーズ: これらのパラメータは、アプリの構成時に [Add and manage public keys] の [Configuration] タブからローカル ファイルに生成され、ダウンロードされています。

  

  公開鍵を追加して管理します。