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

ドキュメントレベルのアクセスコントロール

Amazon S3 データソースは、オプションでドキュメントレベルのアクセスコントロールをサポートします。他のコネクタとは異なり、Amazon S3 にはクロールするネイティブアクセス許可システムがないため、管理する設定ファイルを使用して ACLs を定義します。すべてのコネクタにおける ACL 対応の概要については、「」を参照してくださいアクセスコントロールリストの認識の有効化。

仕組み

ACL 対応の Amazon S3 データソースの場合、Bedrock Managed Knowledge Base は、取得前のフィルタリング中にお客様が用意したアクセスコントロールリストを適用し、クエリユーザーがアクセスできるドキュメントのみを返します。お客様が用意した ACL メタデータが信頼できるソースであるため、Amazon S3 ではリアルタイムの ACL 検証はサポートされていません。

ACL 対応を有効にする

Amazon S3 データソースの ACL 対応を有効にするには、 true で aclEnabledを に設定connectorParametersし、次の 2 つの方法のいずれかを使用してアクセス許可を定義します。

"connectorParameters": {
    "type": "S3",
    "version": "1",
    "aclEnabled": true,
    "connectionConfiguration": {
        "bucketName": "your-bucket-name",
        "bucketOwnerAccountId": "123456789012"
    },
    "aclConfiguration": {
        "globalAccessControlListS3Uri": "s3://your-bucket-name/acl/global-acl.json"
    }
}

グローバル ACL ファイル構造

グローバル ACL ファイルは、各エントリがキープレフィックスをアクセスコントロールエントリのセットにマッピングする JSON 配列です。各 keyPrefixは、フォルダ (その下にあるすべてのドキュメントに適用) または個々のドキュメントの絶対 Amazon S3 URI です。

[
    {
        "keyPrefix": "s3://your-bucket-name/finance/",
        "aclEntries": [
            {
                "Name": "user1@example.com",
                "Type": "USER",
                "Access": "ALLOW"
            }
        ]
    }
]

各aclEntries要素には以下が含まれます。

ドキュメントごとのメタデータファイル

グローバル ACL ファイルの代わりに、メタデータファイルを使用してドキュメントごとに ACLs を定義できます。ドキュメントごとに、同じ Amazon S3 パスfilename.metadata.jsonに という名前のファイルを作成します。グローバルファイルと同じエントリ形式のaccessControlList配列を含めます。

{
    "metadataAttributes": {},
    "accessControlList": [
        {
            "Name": "user1@example.com",
            "Type": "USER",
            "Access": "ALLOW"
        },
        {
            "Name": "user2@example.com",
            "Type": "USER",
            "Access": "DENY"
        }
    ]
}

ドキュメントごとのメタデータは、グローバル ACL ファイルよりも優先されます。ドキュメントに一致するグローバルプレフィックスエントリとドキュメントごとのメタデータファイルの両方がある場合、ドキュメントごとのメタデータが使用されます。

設定を確認する

Amazon S3 ACLs はお客様が提供するため、クエリを実行する前に検証してください。

トラブルシューティング