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

문서 수준 액세스 제어

OneDrive 데이터 소스는 선택적으로 문서 수준 액세스 제어를 지원합니다. 활성화된 경우 Bedrock 관리형 지식 기반은 각 크롤링 중에 OneDrive의 액세스 제어 목록(ACLs)을 동기화하고 쿼리 시 각 사용자의 권한을 확인하므로 사용자는 OneDrive에서 액세스할 수 있는 권한이 부여된 문서의 결과만 볼 수 있습니다. 모든 커넥터의 ACL 인식에 대한 개요는 섹션을 참조하세요액세스 제어 목록 인식 활성화.

작동 방식

사용자가 ACL 지원 OneDrive 데이터 소스를 사용하는 지식 기반을 쿼리하면 Bedrock 관리형 지식 기반은 두 단계로 액세스 제어를 적용합니다.

이 2단계 접근 방식은 동기화 간에 OneDrive 권한이 변경되더라도 최신 상태를 유지하는 문서 수준 액세스 제어를 제공합니다.

크롤링되는 항목

ACLs 활성화되면 Bedrock 관리형 지식 기반은 OneDrive에서 파일 수준 공유 권한 및 보안 그룹 할당을 크롤링합니다. 중첩된(전이적) 그룹 멤버십도 해결됩니다.

쿼리 시 사용자의 이메일 주소(그룹 아님)를 전달합니다. Bedrock 관리형 지식 기반은 크롤링한 데이터에서 해당 사용자의 그룹 멤버십을 확인하고 결과를 필터링할 때 적용합니다. 자격 증명 모델에 대한 자세한 내용은 섹션을 참조하세요액세스 제어 목록 인식 활성화.

ACL 인식을 위한 사전 조건

ACL 지원 OneDrive는 각각 Microsoft Entra 애플리케이션에 고유한 애플리케이션 권한이 설정된 두 가지 다른 Microsoft APIs를 사용합니다. 크롤링은 Microsoft Graph API를 사용하고 실시간 확인은 SharePoint REST API를 사용합니다(OneDrive for Business는 SharePoint에서 지원함). ACL 인식을 활성화하기 전에 관리자의 동의를 받아 두 APIs에 대한 권한을 구성합니다.

인증서를 포함한 전체 설정 절차는 섹션을 참조하세요OneDrive에 대한 Microsoft Entra 앱 ID 인증 설정.

ACL 인식 활성화

OneDrive 데이터 소스에 대한 ACL 인식을 활성화하려면 true에서 ENTRA_APP_ID를 aclEnabled로 설정하고 인증 유형을 connectorParameters 사용합니다. 이 인증 유형은 Bedrock 관리형 지식 기반이 자격 증명 정보를 크롤링하고 쿼리 시 문서 액세스를 확인할 수 있는 애플리케이션 권한을 사용합니다.

OneDrive에 대해 ACLs 활성화된 경우 Amazon S3certificateS3Path의 PKCS#12(.p12) 인증서 파일을 connectionConfiguration 가리키는에를 포함해야 합니다. 이 인증서는 SharePoint REST API에 대한 실시간 ACL 확인에 사용됩니다. ACLcertificateS3Path이 비활성화된 경우는 필요하지 않습니다. ACLs

"connectorParameters": {
    "type": "ONEDRIVE",
    "version": "1",
    "aclEnabled": true,
    "connectionConfiguration": {
        "tenantId": "your-tenant-id",
        "authType": "ENTRA_APP_ID",
        "secretArn": "arn:aws:secretsmanager:region:account-id:secret:secret-name",
        "certificateS3Path": {
            "s3BucketName": "your-certificate-bucket",
            "s3KeyName": "certs/certificate.p12"
        }
    },
    "dataEntityConfiguration": {
        "crawlPersonalDrives": true
    }
}

실시간 액세스 확인

Bedrock Managed Knowledge Base는 애플리케이션 자격 증명을 사용하여 각 후보 문서를 서버 측에서 실시간으로 확인합니다. 최종 사용자 로그인 또는 위임된 동의는 없습니다. OneDrive for Business는 SharePoint에서 지원되므로 Bedrock 관리형 지식 기반은 테넌트의 OneDrive 호스트에 대한 SharePoint REST API에 대해 쿼리 사용자의 유효 권한을 확인합니다.

OneDrive 실시간 확인은 2자격 증명 모델을 사용하며 두 자격 증명이 모두 필요합니다.

구성 확인

검색 요청과 독립적으로 Entra 애플리케이션 권한을 검증할 수 있습니다. 다음 각 검사를 수행합니다.

문제 해결