메모
Foundry IQ (Azure AI 검색)는 관리 검색을 위해 고급 수준의 지식 원본 API 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
Important
이 문서에서 (미리 보기)로 표시된 기능 또는 성능은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
Foundry IQ(Azure AI 검색)와 관련된 미리 보기 약관은 미리 보기 기능을 참조하세요.
SharePoint ACL 수집 및 쿼리 시간 권한 필터링, ADLS Gen2 ACL/RBAC 및 표준 Blob 컨테이너 RBAC는 일반적으로 2026-10-01 데이터 평면 REST API에서 사용할 수 있습니다. 푸시 ACL 수집도 일반적으로 사용할 수 있습니다. Microsoft Purview 민감도 레이블 적용은 미리 보기로 유지됩니다.
foundry IQ(Azure AI 검색)는 문서 수준 액세스 제어를 지원하므로 조직은 데이터 수집부터 쿼리 실행까지 문서 수준에서 세분화된 권한을 적용할 수 있습니다. 이 기능은 보안 AI 에이전트 시스템 접지 데이터, RAG(검색 보강 생성) 애플리케이션 및 문서 수준에서 권한 부여 검사가 필요한 엔터프라이즈 검색 솔루션을 빌드하는 데 필수적입니다.
문서 수준 액세스 제어에 대한 접근 방식
Foundry IQ는 각각 다른 데이터 원본 및 ID 체계에 적합한 문서 수준 권한 설정을 적용하는 5가지 기본 방법을 제공합니다.
| 접근 | 설명 |
|---|---|
| 보안 필터 | 문자열 비교. 애플리케이션은 사용자 또는 그룹의 ID를 문자열로 제공하여 쿼리의 필터를 설정합니다. 이 필터는 문자열과 일치하지 않는 문서를 제외합니다. 보안 필터는 문서 수준 액세스 제어를 달성하기 위한 기술입니다. 이 방법은 API에 바인딩되지 않으므로 모든 버전 또는 패키지를 사용할 수 있습니다. |
| POSIX와 유사한 ACL/RBAC 범위 | 위임된 사용자의 Microsoft Entra ID는 지원되는 권한 메타데이터에 대해 평가됩니다. ADLS Gen2 ACL 및 컨테이너 RBAC 범위 수집, 표준 Blob 컨테이너 RBAC 범위 수집 및 해당 쿼리 권한 필터링은 REST API 2026-10-01에서 일반적으로 사용할 수 있습니다. 고객 관리형 푸시 ACL 수집도 일반적으로 사용할 수 있습니다. 다른 기능은 문서화된 가용성을 유지합니다. 모든 스토리지 권한 부여 정책이 지원되지는 않습니다. API 및 SDK 지침은 ACL 권한 메타데이터 검색을 참조하세요. |
| Microsoft Purview 민감도 레이블(미리 보기) | 인덱서는 지원되는 데이터 원본(Azure Blob Storage, ADLS Gen2, Microsoft 365 OneLake의 SharePoint)에서 Microsoft Purview 정의된 민감도 레이블을 추출합니다. 이러한 레이블은 메타데이터로 저장되고 쿼리 시간에 평가되어 Microsoft Entra 토큰 및 Purview 정책 할당에 따라 사용자 액세스를 적용합니다. 또한 지식 원본 및 에이전트 검색 응답을 통해 레이블이 표시되므로 기술 자료를 사용하는 AI 에이전트 및 채팅 앱이 동일한 레이블 인식 필터링을 받을 수 있습니다. 이 방법은 Foundry IQ 권한 부여를 엔터프라이즈의 Microsoft Information Protection 모델에 맞춥니다. |
| Microsoft 365 ACL의 SharePoint | Foundry IQ 인덱서는 지원되는 권한 메타데이터를 추출하고, REST API 2026-10-01를 통한 쿼리 시간 액세스 검사에 이를 사용합니다. 인덱싱된 권한 하위 집합, 그룹 제한, 동기화 동작 및 구성에 대해서는 권한 메타데이터를 수집하기 위해 SharePoint 인덱서 사용을 참조하세요. |
| OneLake 소스 권한 (미리 보기) | 복사한 사용자 및 그룹 ACL 대신 인덱싱된 원본 위치 및 쿼리 시간 OneLake 권한 부여를 사용합니다. OneLake 권한 유지를 참조하세요. |
인덱싱된 지식 소스의 경우 ingestionPermissionOptions는 assetStore와 함께 사용할 수 없습니다. 따라서 네이티브 문서 수준 권한 수집을 사용하는 경우 이미지 서비스(미리 보기) 를 사용할 수 없습니다.
권한 수집에 지원되는 구문 분석 및 콘텐츠 추출
SharePoint, ADLS Gen2 또는 Blob Storage 대해 네이티브 문서 수준 권한을 사용하도록 설정하는 경우 표준 또는 기본 문서 구문 분석 및 콘텐츠 추출을 사용합니다. 수집 내내 각 원본 항목의 권한 메타데이터 및 원본 컨텍스트를 유지합니다.
데이터 원본 및 API에서 지원하는 Content Understanding 기반 추출을 사용할 수도 있습니다. 필요한 권한 메타데이터 및 원본 컨텍스트를 유지하도록 생성된 모든 청크를 구성합니다. 지원되는 다운스트림 청크는 특수 소스 구문 분석 모드를 선택하는 것과 다릅니다.
REST API 2026-10-01의 경우 구성하는 리소스에 대한 설정을 사용하세요:
| Resource | REST 속성 | Configuration |
|---|---|---|
| SharePoint, ADLS Gen2 또는 Blob 인덱서 | parameters.configuration.parsingMode |
표준 문서 구문 분석에 default를 사용합니다. |
| ADLS Gen2를 포함한 Blob 지식 원본 | azureBlobParameters.ingestionParameters.contentExtractionMode |
minimal 는 기본 추출 옵션입니다. standard 는 Content Understanding 기반 추출을 선택합니다. 생성된 권한 및 원본 컨텍스트 매핑을 유지합니다. |
| 인덱싱된 SharePoint 기술 자료 | indexedSharePointParameters.ingestionParameters.contentExtractionMode |
minimal 는 기본 추출 옵션입니다. 지원되는 경우 Content Understanding 기반 추출에 사용합니다 standard . 생성된 파서 설정을 변경하지 않고 knowledge-source API를 통해 추출을 구성합니다. |
지식 소스 contentExtractionMode 및 인덱서 parsingMode는 서로 다른 설정입니다. 특히 minimal는 특수한 일반 텍스트 구문 분석 모드가 아닙니다. REST 정의는 인덱서 - 만들기 및 지식 원본 - 만들기 또는 업데이트를 참조하세요.
현재는 고객이 선택한 다른 구문 분석 모드가 문서 수준 사용 권한으로 지원되지 않습니다. 다음을 선택하지 마세요:
- JSON 구문 분석(
json). - JSON 배열 구문 분석(
jsonArray) 또는 여러 JSON 문서를 별도의 레코드로 구문 분석합니다. - JSON Lines 구문 분석 (
jsonLines). - CSV 또는 구분 기호로 구분된 텍스트 구문 분석 (
delimitedText). - 일반 텍스트 전용 구문 분석 (
text). - Markdown 관련 구문 분석(
markdown). - 지원되는 권한 전파 계약 없이 한 원본 항목에서 여러 논리 레코드를 만들거나, 분할하거나, 변형하거나, 매핑하는 다른 모든 모드입니다.
이러한 제한 사항은 파일 확장자 또는 추출된 콘텐츠 형식이 아닌 구문 분석 모드와 관련이 있습니다. 예를 들어 구문 분석으로 default 처리된 일반 텍스트 파일은 특수 text 모드를 사용하지 않습니다. Content Understanding의 Markdown 출력은 원본 구문 분석 모드가 markdown 아닙니다.
청크 매핑 및 필요한 원본 메타데이터는 SharePoint 권한 지침, ADLS Gen2 권한 지침 및 Blob RBAC 범위 지침을 참조하세요.
인덱싱된 권한의 원본을 신뢰하세요
쿼리 시간 권한 필터링은 인덱싱된 레코드와 연결된 권한 메타데이터를 평가합니다. 이와 별도로 수집 설계에서는 누가 해당 레코드의 식별자를 선택하고 해당 콘텐츠에 대한 액세스 권한을 부여할 권한이 있는지 정해야 합니다. 문서 키는 업데이트하거나 병합할 레코드를 선택합니다. 권한 부여 경계가 아닙니다.
네이티브 커넥터 수집의 경우 원본별 구성을 따르고 원본 콘텐츠, ID 및 커넥터 파생 권한 간의 연결을 유지합니다. 고객 관리 푸시 수집의 경우 권한 있는 게시자는 키 및 권한 값을 제공합니다. 또한 애플리케이션 관리 문자열 필터링은 애플리케이션의 인증 및 필터 생성에 따라 달라집니다.
필드 이름이 일치하기 때문에 일반 하위 신뢰 콘텐츠를 권한 있는 권한 메타데이터로 취급하지 마세요. 원본 작성기, 수집 관리자, 암시적 및 명시적 매핑, 보강 출력 및 프로젝션된 자식을 검토합니다. Blob 수집의 경우 identity 및 권한 구성 검사 목록을 사용합니다. 이 검토는 권한 최신성과는 별개입니다.
방법 선택
다음 조건을 사용하여 데이터 원본, ID 모델 및 규정 준수 요구 사항에 가장 적합한 접근 방식을 식별합니다.
| Scenario | 권장되는 접근 방식 | 이유 |
|---|---|---|
| 사용자 지정 ID 시스템 또는 비 Microsoft 보안 프레임워크입니다. | 보안 필터 | API에 구애받지 않으며 일반적으로 사용 가능하며 간단한 문자열 일치를 기반으로 합니다. |
| 인덱스로 푸시된 Microsoft Entra 사용자 및 그룹 권한, 인덱싱된 ADLS Gen2 ACL 또는 ADLS Gen2 및 Azure Blob Storage의 인덱싱된 컨테이너 RBAC 범위. | POSIX와 유사한 ACL/RBAC 범위 | 쿼리 시간 적용을 위해 네이티브 권한 메타데이터를 사용합니다. 스키마, 푸시 인덱싱 및 쿼리 적용은 일반적으로 REST API 2026-10-01에서 사용할 수 있습니다. 원본별 수집에는 별도의 가용성 요구 사항이 있습니다. |
| Microsoft Purview 정보 보호 정책의 적용을 받는 엔터프라이즈 콘텐츠입니다. | Microsoft Purview 민감도 레이블 | Foundry IQ에서 중앙 집중식 분류 및 정책 할당을 다시 사용합니다. |
| Microsoft 365 SharePoint 원본 콘텐츠(라이브러리, 목록, ASPX 사이트 페이지). | Microsoft 365 ACL의 SharePoint | Search에 동기화된 지원되는 권한 하위 집합을 평가합니다. 원본 쪽 요청 시간 검색 또는 고객이 제어하는 업데이트 제출의 경우 SharePoint 검색 방법 및 최신성을 비교합니다. |
필터를 사용한 보안 트리밍 패턴
네이티브 ACL/RBAC 범위 통합이 실행 가능하지 않은 시나리오의 경우 보안 문자열 필터를 사용하여 제외 기준에 따라 결과를 트리밍합니다. 패턴에는 다음 구성 요소가 포함됩니다.
- 사용자 또는 그룹 ID를 저장하려면 인덱스로 문자열 필드를 만듭니다.
- 연결된 ACL을 포함하는 원본 문서를 사용하여 인덱스를 로드합니다.
- 문자열에서 일치하도록 쿼리 논리에 필터 식을 포함합니다.
- 쿼리 시 호출자의 ID를 가져옵니다.
- 호출자의 ID를 필터 문자열로 전달합니다.
- 결과는 사용자 또는 그룹 ID 문자열을 포함하지 않는 일치 항목을 제외하도록 잘립니다.
푸시 또는 끌어오기 모델 API를 사용할 수 있습니다. 이 방법은 API에 구애받지 않으므로 인덱스 및 쿼리에 여과 단계에 대한 유효한 문자열(ID)이 있는지 확인해야 합니다.
이 방법은 사용자 지정 액세스 모델 또는 비 Microsoft 보안 프레임워크가 있는 시스템에 유용합니다. 이 방법에 대한 자세한 내용은 Foundry IQ의 결과 트리밍에 대한 보안 필터를 참조하세요.
POSIX와 유사한 ACL 및 RBAC 범위 권한에 대한 네이티브 지원 패턴
네이티브 권한 필터링은 인덱싱된 Microsoft Entra 사용자 및 그룹 개체 ID 및 스토리지 컨테이너 RBAC 범위를 사용합니다.
ADLS(Azure Data Lake Storage) Gen2는 디렉터리 및 파일에서 ACL을 지원합니다.
ADLS Gen2에 대해 구성된 ADLS Gen2 인덱서 또는 Blob 지식 원본을 사용하여 REST API2026-10-01를 사용하여 지원되는 ACL 및 컨테이너 RBAC 범위를 수집합니다. 표준 Blob Storage의 경우 Blob 인덱서 또는 기술 자료 원본은 파일별 ACL이 아닌 컨테이너 RBAC 범위를 수집합니다.
ACL 보안 콘텐츠의 경우 관리 용이성을 위해 개별 사용자 액세스에 대한 그룹 액세스를 사용합니다. 패턴에는 다음 구성 요소가 포함됩니다.
- ACL 할당이 있는 문서 또는 파일로 시작합니다.
- 인덱스에서 권한 필터를 활성화합니다.
- 인덱스에서 적절한 문자열 또는 문자열 컬렉션 필드에 사용 권한 필터를 추가합니다.
- ACL이 연결된 원본 문서를 사용하여 인덱스를 로드합니다.
- 요청 헤더에 추가하여
x-ms-query-source-authorization인덱스 쿼리
기본 제공 권한 필터링 쿼리는 호출자와 해당 문서 권한이 평가되는 사용자를 구분합니다.
-
Authorization는 검색 RBAC에 대한 호출자의 토큰을 전달합니다. 애플리케이션 서비스 주체 또는 관리 ID는 검색 인덱스 데이터 판독기 또는 검색 인덱스 데이터 기여자와 같은 적절한 역할을 사용하여 Search를 호출할 수 있습니다. -
x-ms-query-source-authorization는 문서 권한 평가를 위해 위임된 사용자의 토큰을 전달합니다. 그룹은 토큰 기반 ID가 아닌 권한 메타데이터입니다.
검색을 호출할 수 있는 애플리케이션이 반드시 문서 사용 권한 주체로 지원되는 것은 아닙니다. 예를 들어 권한 있는 애플리케이션은 Purview가 아닌 인덱스에서 관리자 권한 읽기를 사용할 수 있지만 해당 관리 바이패스가 애플리케이션 ACL 멤버 자격을 평가하지는 않습니다. 지원되는 토큰 흐름 및 작업별 제한은 애플리케이션 토큰 경계를 참조하세요.
푸시 API 워크플로를 사용하여 콘텐츠 및 네이티브 권한 메타데이터를 로드합니다.
ADLS Gen2 ACL 및 컨테이너 범위 또는 표준 Blob 컨테이너 범위에는 REST API 2026-10-01가 포함된 끌어오기 모델(인덱서) API를 사용합니다.
수집 중 ACL 권한 메타데이터 가져오기
ACL 권한을 검색하는 방법은 문서 페이로드를 푸시하는지 또는 ADLS Gen2 인덱서를 사용하는지에 따라 달라집니다.
ADLS Gen2 및 표준 Blob 권한 수집의 경우 REST API 2026-10-01을 사용합니다. SDK 변경 로그에서 해당 API 및 필수 속성을 지원하는지 확인합니다. GA REST 가용성은 SDK 패키지 준비 상태를 설정하지 않습니다.
푸시 ACL 수집은 정식 출시되었습니다.
푸시 가이드에는 2026-10-01REST 워크플로가 포함됩니다. 권한 필터 및 ACL/RBAC 수집 지원 여부는 SDK 변경 로그에서 확인하세요.
-
예제에서 사용되는 REST API
2026-10-01입니다. - Azure SDK for Python 변경 로그.
- Azure SDK for .NET 변경 로그.
- Azure SDK for Java 변경 로그.
푸시 모델 접근 방식의 경우:
- REST API 또는 필수 속성을 지원하는 Azure SDK 패키지를 사용하여 권한 필터를 갖춘 인덱스 스키마를 만듭니다.
- Microsoft Graph SDK를 사용하여 그룹 또는 사용자 ID를 가져오는 것이 좋습니다.
- 인덱스 문서 또는 해당하는 Azure SDK API를 사용하여 문서 및 관련 권한 메타데이터를 검색 인덱스에 푸시합니다.
풀 모델 ADLS Gen2 인덱서 접근 방식 또는 Blob(ADLS Gen2) 지식 소스의 경우:
- ADLS Gen2 액세스 제어 모델을 사용하여 디렉터리의 파일이 보호되는지 확인합니다.
- 인덱서 사용 - CREATE(REST API), Knowledge Sources - CREATE(REST API) 또는 이와 동등한 Azure SDK API를 사용하여 인덱서, 인덱스 및 데이터 원본을 만듭니다.
기술 집합이 ADLS 또는 Blob 문서를 청크로 분할하는 경우, 인덱서 필드 매핑에만 의존하지 말고 인덱스 프로젝션을 통해 보호된 각 청크에 권한을 설정하세요.
권한 수집에 대한 원본 메타데이터
원본 컨텍스트 및 권한 부여는 다른 용도로 사용됩니다. 원본 경로는 인코딩된 키, 인용 URL 또는 생성된 부모 ID가 아니라 있는 그대로의 값으로 유지하세요.
| 소스 및 시나리오 | 원본 메타데이터 및 목적 | 매핑 및 사용 가능 여부 |
|---|---|---|
| ADLS의 명명된 사용자/그룹 ACL | 필수 metadata_storage_path(Edm.String)는 소스를 식별합니다.
metadata_user_ids 및 metadata_group_ids에는 유효 ACL이 포함됩니다. |
userIds 및 groupIds로 주석이 지정된 Collection(Edm.String) 필드에 ACL을 매핑합니다. 레코드 및 청크의 경로를 유지합니다. GA in 2026-10-01. |
| ADLS RBAC 전용 |
metadata_storage_path는 ACL 필드가 없더라도 ADLS 권한 수집에 필요합니다.
metadata_rbac_scope 는 컨테이너를 식별합니다. |
rbacScope로 주석 처리된 Edm.String 필드에 범위를 매핑합니다. 필요한 경로는 역할 할당을 복사하는 데 사용되지 않습니다.
2026-10-01에서 GA. |
| ADLS 혼합 ACL/RBAC | 소스 경로, 유효한 사용자/그룹 ACL 및 컨테이너 범위. | 레코드 및 프로젝션된 청크에 구성된 모든 필드를 유지합니다. 모든 독립적인 지원 권한 부여는 액세스 권한을 부여할 수 있습니다. 정식 출시 2026-10-01. |
| 표준 Blob RBAC |
metadata_rbac_scope는 컨테이너를 식별합니다. 이 범위를 계산하려면 문서별 경로가 필요하지 않습니다. 생성된 기술 원본 파이프라인에는 metadata_storage_path가 여전히 포함됩니다. |
스칼라 범위를 rbacScope문서 및 청크의 주석이 추가된 필드에 매핑합니다. ADLS 파일 ACL 유추가 없습니다. GA in 2026-10-01. |
| SharePoint ACLs |
metadata_spo_item_path는 항목 수준 컨텍스트를 제공하고, metadata_spo_site_url는 사이트 수준 컨텍스트를 제공합니다. 목록 및 페이지도 metadata_spo_site_asset_item_id을 사용합니다. |
원본별 SharePoint 스키마 및 프로젝션 지침을 사용합니다. SharePoint 가용성 및 요구 사항은 Storage GA 범위와 독립적입니다. |
직접 스키마 정의, 신뢰할 수 있는 매핑, 생성된 파이프라인 및 기존 레코드 수정은 ADLS 권한 수집 및 Blob RBAC 범위 수집을 참조하세요.
명명된 ID를 제외하는 동안 광범위한 액세스 권한을 부여하는 ADLS 원본 ACL의 경우 지원되지 않는 암시적 blocklistsACL을 참조하세요.
Microsoft 365 기본 ACL 권한 수집의 SharePoint 패턴
인덱싱된 SharePoint 콘텐츠의 경우 Foundry IQ는 지원되는 원본 권한을 메타데이터로 저장하고 이를 사용하여 쿼리 결과를 필터링할 수 있습니다. 이 권한 구성에 REST API 2026-10-01 가 있는 Microsoft 365 인덱서의 SharePoint 사용하거나 기능을 지원하는 SDK 패키지를 사용합니다.
사용 권한 요구 사항, 지원되는 그룹 관계, 권한 동기화 및 제한 사항은 SharePoint 인덱서를 사용하여 사용 권한 메타데이터를 수집하는 방법을 참조하세요.
기술 집합이 문서를 청크로 분할하는 경우(예: 통합 벡터화를 위해 텍스트 분할 기술을 사용하는 경우) ACL 필드는 인덱서 필드 매핑에서 인덱스 프로젝션으로 이동합니다. ACL 필드를 채울 위치 선택을 참조하세요.
Microsoft Purview 민감도 레이블 패턴(미리 보기)
레이블 수집을 사용하도록 설정하면 Foundry IQ는 지원되는 데이터 원본에서 민감도 메타데이터를 추출합니다. 이러한 데이터 원본에는 Azure Blob Storage, ADLS Gen2(Azure Data Lake Storage Gen2), Microsoft 365 SharePoint 및 Microsoft OneLake가 포함됩니다. 추출된 레이블은 문서 콘텐츠와 함께 인덱스에 저장됩니다.
쿼리 시 Foundry IQ는 각 문서의 민감도 레이블, 사용자의 Microsoft Entra 토큰 및 조직의 Purview 정책을 확인하여 액세스를 확인합니다. 시스템은 사용자의 ID 및 레이블 기반 사용 권한이 구성된 Purview 정책에 따라 액세스를 허용하는 경우에만 문서를 반환합니다.
이 패턴에는 다음 구성 요소가 포함됩니다.
- REST API 또는 Purview 레이블 수집을 지원하는 미리 보기 SDK를 사용하여
2026-11-01-preview, 데이터 원본 및 인덱서(예약 용도)를 구성합니다. - Foundry IQ 서비스에서 시스템 할당 관리형 ID를 사용하도록 설정합니다. 사용자 할당 관리형 ID는 Purview 레이블 추출에 지원되지 않으며, 서비스 자체 ID에 더 높은 수준의 Purview 권한이 부여되어 있어야 합니다. 그런 다음, 테넌트 전역 관리자 또는 권한 있는 역할 관리자에게 Foundry IQ 서비스가 Microsoft Purview 인증하고 레이블 메타데이터를 추출할 수 있도록 필요한 액세스 권한을 부여합니다.
- 인덱싱 전에 문서에 민감도 레이블을 적용하여 시스템이 수집 중에 이를 인식하고 유지할 수 있도록 합니다.
- 쿼리 시 헤더
x-ms-query-source-authorization통해 각 쿼리 요청에 유효한 Microsoft Entra 토큰을 연결합니다. Foundry IQ는 토큰 및 관련 레이블 메타데이터를 평가하여 레이블 기반 액세스 제어를 적용합니다.
Purview 민감도 레이블 적용은 단일 테넌트 시나리오로 제한되며 RBAC 인증이 필요합니다. 미리 보기 중에는 REST API 및 Azure SDK 통해서만 지원됩니다. 자동 완성 및 제안 API는 현재 Purview 사용 인덱스에 사용할 수 없습니다.
민감도 레이블이 표시되는 위치
시스템에서 쿼리 시간에 레이블을 적용하거나 응답을 검색할 때 반환하려면 먼저 레이블 메타데이터를 인덱스에 동기화해야 합니다. 이 섹션에 설명된 두 사용 경로는 이 동기화 단계에 따라 달라집니다. 지원되는 데이터 원본에 대해 직접 Foundry IQ 인덱서를 구성하거나 기술 자료를 만들 때 해당하는 수집 옵션을 사용하도록 설정하여 레이블을 동기화할 수 있습니다. 두 경우 모두 사용자 환경은 민감도 레이블 메타데이터 동기화 구성 필수 조건(관리 ID, Foundry IQ 서비스의 RBAC 및 필요한 Microsoft Purview 및 데이터 원본 권한)을 충족해야 합니다. 종단 간 인덱서 설정은 Foundry IQ 인덱서를 사용하여 Microsoft Purview 민감도 레이블을 수집을 참조하세요. 지식 원본 기반 수집의 경우 ingestionPermissionOptions 시 sensitivityLabel가 을 포함하도록 설정합니다.
레이블을 동기화한 후 두 쿼리 경로는 동일한 인덱싱된 레이블 메타데이터를 사용합니다. 애플리케이션에서 Foundry IQ를 호출하는 방법과 일치하는 경로를 선택합니다.
직접 쿼리 API(
/docs/search):x-ms-query-source-authorization에 사용자의 Microsoft Entra 토큰을 첨부합니다. 관리자는 감사 가능한 조사를 위해 상승된 읽기 요청을 실행할 수도 있습니다. 설정 및 예제는 Microsoft Purview 민감도 레이블의 쿼리 시간 적용 참조하세요.지식 원본 및 에이전트 검색(MCP):
sensitivityLabel를 지식 원본에 포함하도록 설정합니다ingestionPermissionOptions. 검색 작업 및 MCPknowledge_base_retrieve도구는 클라이언트가 표시 배너 및 정책 적용에 사용할 수 있는 참조별sensitivityLabelInfo및 응답 수준metadata.responseSensitivityLabelInfo를 반환합니다. 설정하려면 지식 원본 만들기 및 검색 응답에서 민감도 레이블 메타데이터 검사를 참조하세요.
기술 원본이 통합 벡터화 또는 사용자 지정 텍스트 분할 기술을 통해 채워진 인덱스와 같은 청크 인덱스를 가리키는 경우 기술 세트는 각 청크 행에 민감도 레이블을 프로젝션해야 합니다. 이 프로젝션이 없으면 청크 수준 참조가 필터링되지 않습니다.
자세한 내용은 Microsoft Purview 민감도 레이블을 수집하기 위해 Foundry IQ 인덱서 사용을 참조하세요.
쿼리 시 문서 수준 권한 적용
토큰 기반 쿼리 강제 적용은 POSIX 유사 ACL 및 RBAC 범위, Microsoft Purview 민감도 레이블, 그리고 Microsoft 365의 SharePoint ACL 패턴 전반에 걸쳐 적용되는 기능입니다. 기본 토큰 기반 쿼리를 사용하여 Foundry IQ는 각 요청에서 호출자의 Microsoft Entra 토큰의 유효성을 검사하고 문서 ACL 메타데이터가 인덱스에 동기화되는 한 호출자가 문서 ACL에 따라 읽을 수 있는 권한 있는 문서로만 결과 집합을 트리밍합니다.
x-ms-query-source-authorization 헤더를 통해 쿼리 요청에 사용자의 토큰을 첨부하면 Foundry IQ는 다음을 수행합니다:
- 토큰에서 사용자, 그룹 및 범위 클레임을 추출합니다.
- 이러한 클레임을 인덱싱된 문서(ACL 항목, RBAC 범위, Purview 레이블 할당 또는 SharePoint ACL)와 함께 저장된 권한 메타데이터와 비교합니다.
- 동기화된 권한 메타데이터가 호출자 액세스 권한을 부여하는 문서만 반환합니다.
권한 최신성
쿼리 시간 적용은 저장된 권한 메타데이터를 사용하지만 최신성은 사용 권한 유형에 따라 달라집니다. ADLS 사용자 및 그룹 ACL은 인덱싱된 스냅샷입니다. ACL만 변경된 경우, 적격한 일반 실행 시 기본적으로 활성화된 대략 일일 자동 새로 고침이나 명시적인 권한 재동기화를 통해 반영됩니다. 컨테이너 RBAC 범위는 역할 할당이 아닌 리소스를 식별합니다. 위임된 사용자 권한 부여는 전파 및 캐시를 사용하여 쿼리 시 별도로 평가됩니다. 그룹 멤버 자격 확인에는 자체 전파 및 캐싱 동작도 있습니다.
SharePoint의 경우 증분 처리는 감지된 항목 수준 변경 사항과 변경되지 않은 하위 항목을 포함하여 지원되는 루트가 아닌 폴더 권한 변경을 포함합니다. 다른 범위 또는 누락된 알림에는 명시적 새로 고침이 필요할 수 있습니다. 시나리오 표와 타이밍 제한은 인덱싱된 콘텐츠와 원본 콘텐츠 간의 권한 동기화를 참조하세요.
권한 새로 고침은 즉각적인 해지 또는 모음 전체의 최신 상태 SLA를 제공하지 않습니다. 작업 단계, 오류, 청크 일관성 및 정리는 ADLS 동기화, Blob 범위 새로 고침 및 SharePoint 동기화를 참조하세요. 사용자 지정 푸시 수집은 자체 메타데이터를 계속 동기화할 책임이 있습니다.
엔드 투 엔드 쿼리 구현 단계는 Foundry IQ의 쿼리 시간 ACL 및 RBAC 적용을 참조하세요.
문서 수준 액세스 제어의 이점
Foundry IQ의 네이티브 문서 수준 액세스 제어는 애플리케이션 쪽 필터링보다 구체적인 이점을 제공합니다.
- 사용자 지정 권한 코드를 줄입니다. Foundry IQ는 쿼리 실행 중에 지원되는 그룹 확인 및 권한 필터링을 처리합니다.
- 기존 준수 컨트롤에 맞춥니다. Microsoft Entra, Microsoft Purview 및 SharePoint 권한 메타데이터를 다시 사용하면 검색 결과를 원본 ID 시스템과 일치시키는 데 도움이 됩니다. 각 원본에 대한 권한 동기화 모델을 검토하여 해당 제한 사항을 이해합니다.
- 각 ACL 동기화 후 원본 사용 권한을 적용합니다. 토큰 기반 방법(ACL, RBAC 범위, Purview 레이블, SharePoint ACL)의 경우 쿼리 시간 적용은 문서화된 원본별 동기화 메커니즘(인덱서 실행, 푸시 API 업데이트 또는 Purview 새로 고침)이 이미 인덱스에 쓴 권한 메타데이터를 사용합니다.
- 쿼리 후 트리밍에 비해 성능이 향상됩니다. 검색 파이프라인 내에서 필터링하는 것은 더 큰 결과 집합을 애플리케이션에 로드하고, 특히 높은 쿼리 볼륨에서 트리밍하는 것보다 빠릅니다.
- 기존 ID 인프라를 다시 사용합니다. Microsoft Entra 및 SharePoint ID는 액세스 결정의 원본으로 남아 있으므로 ID 중복 및 병렬 권한 저장소 유지 관리의 운영 오버헤드가 줄어듭니다.
자습서 및 샘플
추가 문서와 샘플을 통해 Foundry IQ에서 문서 수준 액세스 제어를 탐색합니다.
- 자습서: 인덱서를 사용하여 ADLS Gen2 권한 메타데이터 인덱싱
- azure-search-rest-samples/acl
- azure-search-python-samples/Quickstart-Document-Permissions-Push-API
- azure-search-python-samples/Quickstart-Document-Permissions-Pull-API
- 데모 앱: 민감도 레이블 수집 및 적용