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

# Box データソースを接続する
<a name="kb-managed-ds-box-connect"></a>

認証を設定し、認証情報を AWS Secrets Manager シークレットに保存したら、ナレッジベースに Box データソースを作成します。このページでは、 AWS マネジメントコンソール または API を使用してデータソースを作成し、次に設定できるコネクタパラメータのリファレンスを作成する方法について説明します。

**注記**  
最初に認証のセットアップを完了します。[Box のクライアント認証情報付与認証を設定する](kb-managed-box-ccg-setup.md) 「（推奨）」または「」を参照してください[Box の OAuth 2.0 認証を設定する](kb-managed-box-oauth2-setup.md)。シークレット ARN が必要です。

## データソースを作成する
<a name="kb-managed-ds-box-create"></a>

------
#### [ Console ]

**Box をマネージドナレッジベースに接続するには**

1. **データソース**で、データソースの名前を指定します。

1. データソースドロップダウンから **Box** を選択します。

1. **認証** で、認証方法を選択し、シークレットを選択します。クライアント認証情報付与 (CCG) は Box エンタープライズ全体のコンテンツをクロールするためのものです。OAuth 2.0 は特定のユーザーのコンテンツをクロールするためのものです。

1. (オプション) ドキュメントレベルのアクセスコントロールを有効にするには、**ACLsを使用してドキュメントアクセスを制御する**を選択します。このオプションは、クライアント認証情報付与認証でのみ使用でき、作成後に変更することはできません。詳細については、「[ドキュメントレベルのアクセスコントロール](kb-managed-ds-box-acl.md)」を参照してください。

1. (オプション) OAuth 2.0 クロールの場合は、クロールする特定のファイルとフォルダURLs を入力します。

------
#### [ API ]

Box データソースを作成するには、Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) リクエストを送信します。次の AWS Command Line Interface 例では、クライアント認証情報付与認証を使用するデータソースを作成します。代わりに OAuth 2.0 を使用するには、 `authType`を に変更します`OAUTH2`。ドキュメントレベルのアクセスコントロールを有効にするには、 `aclEnabled`を に設定します`true`。各フィールドの説明については、以下のコネクタパラメータリファレンスを参照してください。

```
aws bedrock-agent create-data-source \
 --name "{{Box-connector}}" \
 --knowledge-base-id "{{your-knowledge-base-id}}" \
 --data-source-configuration file://box-managed-connector.json
```

`box-managed-connector.json` ファイルには以下が含まれています。

```
{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "BOX",
            "version": "1",
            "aclEnabled": false,
            "connectionConfiguration": {
                "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-box-ccg-creds}}",
                "authType": "CCG"
            },
            "filterConfiguration": {
                "maxFileSizeInMegaBytes": "500"
            }
        }
    }
}
```

OAuth 2.0 データソースの場合は、 `authType`を に設定します`OAUTH2`。必要に応じて、 `inclusionFolderIds` と `dataEntityConfiguration`で を追加して`inclusionFileIds`、特定のフォルダとファイルをクロールできます。

```
{
    "type": "BOX",
    "version": "1",
    "connectionConfiguration": {
        "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-box-oauth2-creds}}",
        "authType": "OAUTH2"
    },
    "dataEntityConfiguration": {
        "inclusionFolderIds": ["{{123456789}}"],
        "inclusionFileIds": ["{{987654321}}"]
    }
}
```

マネージドナレッジベースの場合、 `CreateDataSource`は非同期です。オペレーションが完了すると、データソースのステータスは から `CREATING` に移行`AVAILABLE`します。

------

## コネクタパラメータ
<a name="kb-managed-config-box"></a>

データソース設定では、次のコネクタパラメータを使用します。Box に接続するには、 のコネクタタイプ`BOX`として を指定します`connectorParameters`。ラップするフィールド `connectorParameters` ( `deletionProtectionConfiguration`や など`mediaExtractionConfiguration`) については、「」を参照してください[データソースを接続する](kb-managed-connect-ds.md)。


**connectionConfiguration**  

| フィールド | 必要 | 説明 | 
| --- | --- | --- | 
| secretArn | はい | Box 認証情報を含む AWS Secrets Manager シークレットの ARN。 | 
| authType | はい | 認証タイプ: CCG (推奨) または OAUTH2。「[認証方法](kb-managed-ds-box.md#kb-managed-box-auth-methods)」を参照してください。 | 


**dataEntityConfiguration (OAuth 2.0 のみ)**  

| フィールド | 必要 | 説明 | 
| --- | --- | --- | 
| inclusionFolderIds | いいえ | クロールするフォルダ IDs のリスト。 | 
| inclusionFileIds | いいえ | クロールするファイル IDs のリスト。 | 


**filterConfiguration (オプション)**  

| フィールド | 必要 | 説明 | 
| --- | --- | --- | 
| maxFileSizeInMegaBytes | いいえ | コネクタが取り込む 1 つのファイルの最大サイズ、メガバイト単位。数値文字列として を指定します (例: "500")。デフォルトは "500" です。 | 


**aclEnabled (オプション)**  

| フィールド | 必要 | 説明 | 
| --- | --- | --- | 
| aclEnabled | いいえ | に設定するとtrue、ドキュメントレベルのアクセスコントロールが有効になります。CCG 認証が必要です。データソースの作成後にこの設定を変更することはできません。詳細については、「[ドキュメントレベルのアクセスコントロール](kb-managed-ds-box-acl.md)」を参照してください。 | 

## 認証方法を変更する
<a name="kb-managed-ds-box-change-auth"></a>

[UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) オペレーションまたは を使用して、データソースの認証方法 (OAuth 2.0 からクライアント認証情報付与など) を変更するには、データソースを新しい `authType`と、一致する認証情報を含むシークレットで更新します AWS マネジメントコンソール。ドキュメントレベルのアクセスコントロール設定は、データソースの作成時に修正されるため、ACLs を追加または削除するには、新しいデータソースを作成する必要があります。

## 次の手順
<a name="kb-managed-ds-box-connect-next"></a>

データソースを作成したら、同期してコンテンツをナレッジベースに取り込みます。詳細については、「[データソースを同期する](kb-managed-sync.md)」を参照してください。ユーザーアクセス許可でクエリ結果をフィルタリングするには、「」を参照してください[ドキュメントレベルのアクセスコントロール](kb-managed-ds-box-acl.md)。