기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

문서 수준 액세스 제어

Amazon S3 데이터 소스는 선택적으로 문서 수준 액세스 제어를 지원합니다. 다른 커넥터와 달리 Amazon S3에는 크롤링할 기본 권한 시스템이 없으므로 관리하는 구성 파일을 통해 ACLs을 정의합니다. 모든 커넥터의 ACL 인식에 대한 개요는 섹션을 참조하세요액세스 제어 목록 인식 활성화.

작동 방식

ACL 지원 Amazon S3 데이터 소스의 경우 Bedrock 관리형 지식 기반은 검색 전 필터링 중에 고객이 제공한 액세스 제어 목록을 적용하여 쿼리 사용자가 액세스할 수 있는 문서만 반환합니다. 고객이 제공한 ACL 메타데이터가 정확한 출처이므로 Amazon S3에서는 실시간 ACL 확인이 지원되지 않습니다.

ACL 인식 활성화

Amazon S3 데이터 소스에 대한 ACL 인식을 활성화하려면 true에서를 aclEnabled로 설정하고 다음 두 가지 방법 중 하나를 사용하여 액세스 권한을 connectorParameters 정의합니다.

"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은 고객이 제공하므로 쿼리하기 전에 검증하세요.

문제 해결