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

# 관리형 지식 기반에서 ACL 인식 검색
<a name="kb-test-retrieve-acl"></a>

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

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

## 요청 검색에서 userContext 사용
<a name="kb-test-retrieve-acl-api"></a>

ACL 인식 검색을 수행하려면 [검색](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html) 요청에 `userContext` 필드를 포함합니다. 는 사용자의 자격 증명을 `userContext` 지정합니다. `userId`는 항상 기본 데이터 소스와 연결된 사용자의 범용 이메일 주소입니다.

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

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

## ACLs 사용한 검색 동작
<a name="kb-test-retrieve-acl-behavior"></a>

ACL 인식이 활성화되면 다음 동작이 적용됩니다.
+ **ACL 지원 데이터 소스에 필요한 사용자 컨텍스트 -** 검색 요청에 사용자 컨텍스트를 제공하지 않으면 ACL 지원 데이터 소스는 0개의 결과를 반환합니다. 동일한 지식 기반의 비 ACL 데이터 소스는 일반적으로 결과를 반환합니다.
+ **ACL 메타데이터가 누락되면 액세스할 수 없음 **- ACL 지원 데이터 소스의 문서에 ACL이 없는 경우(예: 커넥터가 권한을 추출하지 못했거나 문서가 퍼블릭인 경우) 해당 문서가 사용자에게 반환되지 않습니다. 누락된 권한은 퍼블릭이 아닌 제한된 권한으로 처리됩니다.
+ **혼합 데이터 소스** - ACL 지원 데이터 소스와 비 ACL 데이터 소스를 동일한 지식 기반에 둘 다 보유할 수 있습니다. 비 ACL 데이터 소스의 문서는 사용자 컨텍스트에 관계없이 모든 사용자에게 반환됩니다.
+ **부분 결과** - 실시간 ACL 확인이 일부 문서에 대한 액세스를 거부하면 응답에 요청된 보다 적은 결과가 포함될 수 있습니다`maxResults`. Bedrock 관리형 지식 기반은 추가 문서로 채우지 않습니다. 애플리케이션은 요청된 것보다 적은 결과로 응답을 처리해야 합니다.
+ **거부 재정의 허용** - 사용자가 문서에 대한 허용 목록과 거부 목록 모두에 나타나면 액세스가 거부됩니다.

**참고**  
타사 자격 증명 공급자 자격 증명은 최대 1시간 동안 캐시됩니다. 캐시가 새로 고쳐질 때까지 액세스가 계속될 수 있습니다.  
액세스 제어 권한에 대한 변경 사항은 최종적으로 일관됩니다. 업데이트는 일반적으로 몇 분 이내에 적용됩니다.

## 문제 해결
<a name="kb-test-retrieve-acl-troubleshooting"></a>

ACL 인식 검색에서 결과나 예상치 못한 결과가 반환되지 않는 경우 원인은 일반적으로 권한, 자격 증명 또는 ACL 구성 등 커넥터별로 다릅니다. 커넥터에 대한 문제 해결 지침을 참조하세요.
+ [SharePoint](kb-managed-ds-sharepoint-acl.md#kb-managed-ds-sharepoint-acl-troubleshooting)
+ [OneDrive](kb-managed-ds-onedrive-acl.md#kb-managed-ds-onedrive-acl-troubleshooting)
+ [Google Drive](kb-managed-ds-googledrive-acl.md#kb-managed-ds-googledrive-acl-troubleshooting)
+ [Confluence](kb-managed-ds-confluence-acl.md#kb-managed-ds-confluence-acl-troubleshooting)
+ [Amazon S3](kb-managed-ds-s3-acl.md#kb-managed-ds-s3-acl-troubleshooting)
+ [사용자 지정](kb-managed-ds-custom-acl.md#kb-managed-ds-custom-acl-troubleshooting)