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 authentication (with JWT)] を選択します。

   

   [Server authentication (with JWT)] を選択します。

7. [Create app] をクリックします。

Box アプリを構成する

1. Box Developer Console で、[Platform app] を選択し、[Configuration] タブに移動します。

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

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

3. [Application scopes] セクションで、次の表から要件に応じてスコープを選択します。

   接続モード	スコープ	目的
   連携検索	Read 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 アプリを構成します。

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

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

   • 必要に応じて、独自の鍵を生成するには、Box 鍵ペアの設定ガイドをご覧ください。

     

     鍵を管理します。

5. [Save changes] をクリックします。

Box アプリを承認する

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

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

   

   Box アプリを承認します。

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

   

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

4. 管理者アカウントで Box 管理プラットフォームのアプリ マネージャーにログインします。

5. 構成した [Platform app] を選択します。

6. 該当する行の 3 つのドット [...] をクリックします。

7. プルダウン リストから [Authorize app] を選択します。

8. [Authorize app] ダイアログで、[Authorize] をクリックして承認プロセスを完了します。

   

   [Authorize] をクリックします。

Box の認証情報を取得する

次の Box の認証情報を用意します。

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

  

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

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

  

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

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

  

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