View a markdown version of this page

관리형 지식 기반에서 ACL 인식 검색 - Amazon Bedrock
요청 검색에서 userContext 사용ACLs 사용한 검색 동작문제 해결

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

관리형 지식 기반에서 ACL 인식 검색

관리형 지식 기반 데이터 소스에서 ACL 인식이 활성화되면 검색 요청에서 사용자 컨텍스트를 전달하여 쿼리 결과를 필터링합니다. Bedrock 관리형 지식 기반은 제공된 사용자가 액세스할 수 있는 문서만 반환합니다. ACL 인식의 작동 방식, 자격 증명 모델, 커넥터 지원 및 활성화 시 책임에 대한 개요는 섹션을 참조하세요액세스 제어 목록 인식 활성화.

중요

ACL 인식은 인증이 아닌 ACL 인식 필터링을 제공합니다. Bedrock 관리형 지식 기반은 최종 사용자를 인증하지 않습니다. 애플리케이션은 사용자를 인증하고 확인된 자격 증명 컨텍스트를 전달해야 합니다. 자세한 내용은 액세스 제어 목록 인식 활성화을 참조하세요.

요청 검색에서 userContext 사용

ACL 인식 검색을 수행하려면 검색 요청에 userContext 필드를 포함합니다. 는 사용자의 자격 증명을 userContext 지정합니다. userId는 항상 기본 데이터 소스와 연결된 사용자의 범용 이메일 주소입니다.

{
    "knowledgeBaseId": "your-knowledge-base-id",
    "retrievalQuery": {
        "text": "your query"
    },
    "userContext": {
        "userId": "user@example.com"
    }
}

검색 요청에를 제공하지 않으면 ACL 지원 데이터 소스userContext는 0개의 결과를 반환합니다. 동일한 지식 기반의 비 ACL 데이터 소스는 일반적으로 결과를 반환합니다.

ACLs 사용한 검색 동작

ACL 인식이 활성화되면 다음 동작이 적용됩니다.

  • ACL 지원 데이터 소스에 필요한 사용자 컨텍스트 - 검색 요청에 사용자 컨텍스트를 제공하지 않으면 ACL 지원 데이터 소스는 0개의 결과를 반환합니다. 동일한 지식 기반의 비 ACL 데이터 소스는 일반적으로 결과를 반환합니다.

  • ACL 메타데이터가 누락되면 액세스할 수 없음 - ACL 지원 데이터 소스의 문서에 ACL이 없는 경우(예: 커넥터가 권한을 추출하지 못했거나 문서가 퍼블릭인 경우) 해당 문서가 사용자에게 반환되지 않습니다. 누락된 권한은 퍼블릭이 아닌 제한된 권한으로 처리됩니다.

  • 혼합 데이터 소스 - ACL 지원 데이터 소스와 비 ACL 데이터 소스를 동일한 지식 기반에 둘 다 보유할 수 있습니다. 비 ACL 데이터 소스의 문서는 사용자 컨텍스트에 관계없이 모든 사용자에게 반환됩니다.

  • 부분 결과 - 실시간 ACL 확인이 일부 문서에 대한 액세스를 거부하면 응답에 요청된 보다 적은 결과가 포함될 수 있습니다maxResults. Bedrock 관리형 지식 기반은 추가 문서로 채우지 않습니다. 애플리케이션은 요청된 것보다 적은 결과로 응답을 처리해야 합니다.

  • 거부 재정의 허용 - 사용자가 문서에 대한 허용 목록과 거부 목록 모두에 나타나면 액세스가 거부됩니다.

참고

타사 자격 증명 공급자 자격 증명은 최대 1시간 동안 캐시됩니다. 캐시가 새로 고쳐질 때까지 액세스가 계속될 수 있습니다.

액세스 제어 권한에 대한 변경 사항은 최종적으로 일관됩니다. 업데이트는 일반적으로 몇 분 이내에 적용됩니다.

문제 해결

ACL 인식 검색에서 결과나 예상치 못한 결과가 반환되지 않는 경우 원인은 일반적으로 권한, 자격 증명 또는 ACL 구성 등 커넥터별로 다릅니다. 커넥터에 대한 문제 해결 지침을 참조하세요.