View a markdown version of this page

Box のクライアント認証情報付与認証を設定する - Amazon Bedrock
ステップ 1: Box アプリを作成するステップ 2: アプリのアクセス許可を設定するステップ 3: 認証情報を保存して収集するステップ 4: アプリを承認するステップ 5: Secrets Manager シークレットを作成する次の手順

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Box のクライアント認証情報付与認証を設定する

クライアント認証情報付与 (CCG) 認証は、Box データソースに推奨される認証方法です。コネクタは、クライアント認証情報付与 (2LO) フローを使用して Box アプリとして認証します。これには、すべてのエンタープライズコンテンツをクロールするサービスアカウント (ユーザーではない) があり、インタラクティブなサインインはありません。これは、ドキュメントレベルのアクセスコントロール (ACLs) をサポートする唯一の認証方法です。ほとんどのデプロイで使用します。

ステップ 1: Box アプリを作成する

  1. Box デベロッパーコンソールに移動します。

  2. 新しいアプリの作成を選択します。

  3. 認証方法 で、サーバー認証 を選択します。

  4. クライアント認証情報の付与 (Box で推奨とマーク) を選択します。

  5. アプリに名前を付け、作成を選択します。設定ページに移動します。

ステップ 2: アプリのアクセス許可を設定する

アクセスレベル — アプリアクセスレベルで、アプリ + エンタープライズアクセスを選択します。

重要

App + Enterprise アクセスがないと、サービスアカウントはすべてのエンタープライズデータを表示できず、コネクタはクロールに失敗します。

コンテンツアクション (必須) — 次の両方を有効にします。

  • すべてのファイルとフォルダを読み取る

  • すべてのファイルとフォルダを書き込む

重要

Box はダウンロードを書き込みインタラクションとして扱うため、読み取り専用のクローリングでも書き込みが必要です。

管理アクション — 次の両方を有効にします。

  • ユーザーを管理する

  • グループの管理

注記

ドキュメントレベルのアクセスコントロール (ACL) のサポートには、管理アクションが必要です。ACLs が必要ない場合は、省略できます。Box はフル管理アクセス許可セットのみを提供します。読み取り専用オプションはありません。

追加設定 — ユーザーとして ヘッダーを使用して API コールを行うを有効にします。これにより、コネクタは個々のユーザーとして委任し、ユーザーごとのコンテンツをクロールできます。ユーザーアクセストークンの生成をオフにします。

ステップ 3: 認証情報を保存して収集する

  1. [保存] を選択します。正常に保存されたアプリ設定の確認が表示されます。

  2. 右側のパネル (アプリの詳細 > アクセス) で、クライアント ID をコピーします。

  3. シークレットの取得を選択してクライアントシークレットを表示し、コピーします。

    注記

    クライアントシークレットは、作成後に自動的には表示されません。シークレットを取得するを選択して公開する必要があります。これは、保存後すぐに、移動する前に実行します。

  4. 右側のパネルのプロパティまでスクロールし、ユーザー ID (ccgUserId) とエンタープライズ ID () を収集しますenterpriseId。

ステップ 4: アプリを承認する

保存後、右側のステータスパネルに認可: 未送信と認可ボタンが表示されます。

  1. 承認を選択して、管理者レビューに送信します。

  2. エンタープライズ管理者は、使用する前にアプリを承認する必要があります。

重要

アプリは、管理者認可が付与されるまで機能しません。未送信 は、実行時にアプリが失敗することを意味します。

ステップ 5: Secrets Manager シークレットを作成する

次のキーと値のペアを使用して、認証情報を AWS Secrets Manager シークレットに保存します。

{
    "clientId": "your-client-id",
    "clientSecret": "your-client-secret",
    "enterpriseId": "your-enterprise-id",
    "ccgUserId": "your-user-id"
}
CCG シークレットフィールド
フィールド 説明
clientId アクセスセクションのアプリケーションクライアント ID (右パネル）。
clientSecret アプリの保存後にシークレットの取得を選択して表示。
enterpriseId プロパティパネルから。クロールする Box エンタープライズインスタンスを識別します。
ccgUserId プロパティパネルから。認証情報がユーザーとして委任できることを検証します。

以下を使用してシークレットを作成します AWS Command Line Interface。

aws secretsmanager create-secret \
  --name bedrock-box-ccg-creds \
  --secret-string file://secret.json

レスポンスからシークレット ARN を記録します。データソース として使用しますsecretArn。

次の手順

シークレットを保存したら、 を authTypeに設定してデータソースを作成しますCCG。「Box データソースを接続する」を参照してください。ユーザーアクセス許可でクエリ結果をフィルタリングするには、「」を参照してくださいドキュメントレベルのアクセスコントロール。