참고
Foundry IQ (Azure AI 검색)는 관리 검색을 위해 직접 인덱싱 및 쿼리 API와 함께 상위 수준의 지식 소스 및 지식 베이스 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
중요
Microsoft Purview 민감도 레이블 수집은 공개 미리 보기에 있으며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
이 기능과 관련된 미리 보기 관련 약관은 미리 보기 기능을 참조하세요.
기존 Azure AI 검색(Foundry IQ) 인덱서 파이프라인에 Microsoft Purview 민감도 레이블 지원(미리 보기)을 추가합니다. 레이블 추출을 구성하고, 대상 메타데이터 필드에 주석을 추가하고, 해당 값을 인덱싱된 각 문서 또는 청크에 매핑합니다. Foundry IQ는 인덱싱된 레이블을 사용하여 Microsoft Purview 정책에 따라 쿼리 시간에 문서 수준 액세스를 적용합니다.
이 기능은 다음 데이터 원본에 사용할 수 있습니다.
이 문서의 세 필드 예제에서는 Microsoft 365 문서 라이브러리(드라이브) 파일의 SharePoint에 대해 확인된 메타데이터를 사용합니다. 민감도 레이블 수집은 SharePoint list 항목 또는 사이트 페이지를 지원하지 않습니다.
필수 구성 요소
이전 섹션에 연결된 커넥터 지침을 사용하여 구성된 기존 데이터 원본 및 인덱서 파이프라인이 청크를 인덱싱하는 경우 레이블 매핑을 추가하기 전에 기술 세트 및 인덱스 프로젝션 을 구성합니다.
로 만든 대상 인덱스 또는
purviewEnabled: true에 설명된 대로 새 Purview 지원 인덱스를 만들고 기존 파이프라인의 대상을 다시 지정하는 계획입니다.Microsoft Purview 민감도 레이블 정책을 구성하고 인덱싱하기 전에 문서에 적용합니다.
Purview API 및 민감도 레이블에 대한 Foundry IQ 서비스에 대한 액세스 권한을 부여하려면 Microsoft Entra 테넌트에 전역 관리자 또는 권한 있는 역할 관리자 역할이 있어야 합니다.
Foundry IQ 서비스와 쿼리를 실행하는 사용자는 모두 동일한 Microsoft Entra 테넌트에 있어야 합니다.
Purview 민감도 레이블에서 지원되고 Foundry IQ 인덱서에서 지원하는 파일 형식으로 원본 문서를 사용합니다.
REST API 버전 2026-11-01-preview 또는 동등한 미리 보기 SDK 패키지를 사용합니다.
Foundry IQ 서비스는 시스템 할당 관리 ID를 사용하여 Microsoft Purview에 인증해야 합니다. 이 기능은 사용자 할당 관리 ID를 지원하지 않습니다.
제한
Azure 포털은 이 기능을 지원하지 않습니다.
자동 완성 및 제안 API는 아직 레이블 기반 액세스 제어를 적용할 수 없으므로 Purview 사용 인덱스에 대해 지원되지 않습니다.
게스트 계정 및 테넌트 간 쿼리는 지원되지 않습니다.
다음 인덱서 기능은 민감도 레이블이 있는 문서를 지원하지 않습니다. 기술 세트 또는 인덱서에서 이러한 기능을 사용하는 경우 민감도 레이블이 있는 문서는 처리되지 않습니다.
지식 저장소, 에이전트 검색에서 이미지 서비스(미리 보기)에 필요한 자산 저장소를 포함한 따라서 민감도 레이블을 수집하는 기술 자료에는 이미지 제공이 지원되지 않습니다.
정책 적용 작동 방식
민감도 레이블 지원에는 인덱싱 및 쿼리 시간 적용의 두 단계가 있습니다.
인덱싱
인덱서는 문서 콘텐츠 및 민감도 레이블 메타데이터를 추출합니다. 이후 실행 시 문서의 레이블, 콘텐츠 또는 메타데이터에 대한 변경을 감지하면 인덱싱된 값을 업데이트합니다.
인덱스가 다음에 성공한 인덱서를 실행할 때까지 원본 문서의 레이블 변경 내용을 반영하지 않습니다.
쿼리 수행 시 강제
쿼리 시 Foundry IQ는 민감도 레이블을 평가하고 사용자의 Microsoft Entra ID 토큰 및 Microsoft Purview 레이블 정책에 따라 문서 수준 액세스 제어를 적용합니다. 지정된 레이블에서 읽기 사용 권한 으로 콘텐츠에 액세스할 권한이 있는 사용자만 검색 결과에서 해당 문서를 검색할 수 있습니다.
쿼리 인증 및 권한 부여 요구 사항은 민감도 레이블이 사용하도록 설정된 인덱스 쿼리를 참조하세요. 관리 조사 및 감사 동작은 상승된 읽기를 참조하세요.
1. Foundry IQ 관리 ID 활성화
Foundry IQ 서비스에 시스템 할당 관리 ID를 사용하도록 설정합니다. 인덱서는 서비스 고유의 ID를 사용하여 Microsoft Purview에 인증하고 암호화된 콘텐츠 및 보안 분류를 읽는 등 권한이 필요한 EXTRACT 작업을 수행합니다.
3단계에서 필요한 역할을 이 ID에 직접 할당합니다.
2. Foundry IQ 서비스에서 RBAC를 사용 설정
Foundry IQ 서비스에서 RBAC(역할 기반 액세스 제어)를 사용하도록 설정합니다. Purview를 사용하도록 설정된 인덱스에서는 콘텐츠 인덱싱과 쿼리를 포함한 문서 작업에 RBAC 인증이 필요합니다. 다른 서비스 작업이 API 키에 의존하는 경우 RBAC 및 API 키를 모두 활성화된 상태로 유지하세요. 이 구성은 Purview 사용 인덱스에 대한 API 키 문서 작업을 허용하지 않습니다.
3. 민감도 레이블 추출에 대한 액세스 권한 부여
Microsoft Purview 민감도 레이블 메타데이터에 액세스하는 데에는 높은 권한이 필요한 작업이 수반됩니다. 권한을 할당하기 전에 보안 또는 규정 준수 팀과 협의하고 조직의 거버넌스 프로세스를 통해 승인을 받습니다.
승인되면 전역 관리자 또는 권한 있는 역할 관리자에게 요청하여 이러한 역할을 Foundry IQ 시스템 할당 관리형 ID에 할당합니다.
- 레이블 및 콘텐츠 추출을 위한 Content.SuperUser입니다.
- UnifiedPolicy.Tenant.Read Purview 정책 및 레이블 메타데이터 액세스를 위한.
PowerShell을 사용하여 역할 할당
이러한 역할은 사용자 할당 관리 ID , 별도의 애플리케이션 서비스 주체 또는 개별 사용자 계정이 아닌 Foundry IQ 서비스의 시스템 할당 관리 ID에만 할당합니다. PowerShell 스크립트는 서비스 리소스에서 관리 ID 개체 ID를 자동으로 검색합니다.
전역 관리자 또는 권한 있는 역할 관리자는 다음 PowerShell 스크립트를 사용하여 필요한 권한을 부여해야 합니다. 위임된 Microsoft Graph 범위 AppRoleAssignment.ReadWrite.All 및 Application.Read.All에 대한 관리자 동의를 승인된 거버넌스 프로세스를 통해 얻습니다. 테넌트 관리자 역할만으로는 이러한 토큰 범위를 제공하지 않습니다.
다음 섹션에 표시된 모듈을 설치한 후 나머지 명령을 실행하기 전에 동일한 PowerShell 세션에서 별도의 인증된 Azure PowerShell 컨텍스트를 설정합니다.
Connect-AzAccount를 사용하여 Foundry IQ 서비스의 테넌트에 로그인하고 Set-AzContext를 사용하여 올바른 테넌트 및 구독을 선택합니다. Azure 계정에는 Reader 역할과 같은 Foundry IQ 서비스 리소스를 읽을 수 있는 권한이 있어야 합니다.
Connect-Entra은 이 Az 컨텍스트를 설정하지 못합니다.
자리 표시자를 실제 테넌트 ID, 구독 ID, 리소스 그룹 및 Foundry IQ 서비스 이름으로 바꿉니다.
Install-Module -Name Az -Scope CurrentUser
Install-Module -Name Microsoft.Entra -AllowClobber
Import-Module Az.Resources
Connect-Entra -TenantId "<tenantId>" `
-Scopes 'AppRoleAssignment.ReadWrite.All', 'Application.Read.All'
$resourceIdWithManagedIdentity = (
"/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/" +
"providers/Microsoft.Search/searchServices/<searchServiceName>"
)
$managedIdentityObjectId = (Get-AzResource `
-ResourceId $resourceIdWithManagedIdentity).Identity.PrincipalId
# Microsoft Information Protection (MIP)
$MIPResourceSP = Get-EntraServicePrincipal `
-Filter "appID eq '870c4f2e-85b6-4d43-bdda-6ed9a579b725'"
New-EntraServicePrincipalAppRoleAssignment `
-ServicePrincipalId $managedIdentityObjectId `
-PrincipalId $managedIdentityObjectId `
-ResourceId $MIPResourceSP.Id `
-Id "8b2071cd-015a-4025-8052-1c0dba2d3f64"
# Microsoft Rights Management Services (MRMS) - policy read
$MRMSResourceSP = Get-EntraServicePrincipal `
-Filter "appID eq '00000012-0000-0000-c000-000000000000'"
New-EntraServicePrincipalAppRoleAssignment `
-ServicePrincipalId $managedIdentityObjectId `
-PrincipalId $managedIdentityObjectId `
-ResourceId $MRMSResourceSP.Id `
-Id "7347eb49-7a1a-43c5-8eac-a5cd1d1c7cf0"
참조: Connect-Entra, Get-AzResource, Get-EntraServicePrincipal, New-EntraServicePrincipalAppRoleAssignment 및 Microsoft Graph 앱 역할 할당 권한
스크립트는 다음 리소스 서비스 주체의 애플리케이션 역할을 Foundry IQ 서비스의 관리 ID에 할당합니다.
| App ID | 리소스 서비스 주체 |
|---|---|
870c4f2e-85b6-4d43-bdda-6ed9a579b725 |
Microsoft 정보 보호 동기화 서비스 |
00000012-0000-0000-c000-000000000000 |
Microsoft 권한 관리 서비스 |
4. Purview 민감도 레이블을 사용하도록 인덱스 구성
다음 단계의 구성 변경에는 REST API 버전 2026-11-01-preview를 사용합니다.
중요
인덱스를 만들 때 purviewEnabled 속성을 true(으)로 설정해야 합니다. 이 설정은 영구적이며 나중에 수정할 수 없습니다.
기존 인덱스에 purviewEnabled: true가 없는 경우 새 Purview 지원 인덱스를 만들고 인덱서와 프로젝션 선택기의 대상을 해당 인덱스로 다시 지정합니다. 기존 인덱스에서는 이 속성을 사용하도록 설정할 수 없습니다.
Purview 사용 인덱스의 경우 모든 문서 작업 API에 대해 RBAC 인증만 지원됩니다. API 키 액세스는 인덱스 스키마 검색(목록 및 가져오기)으로 제한됩니다.
지원되는 모든 민감도 레이블 데이터 원본에서 metadata_sensitivity_label에는 GUID 문자열인 레이블 ID 하나가 포함됩니다. 대상 인덱스 필드를 컬렉션이 아닌 것으로 Edm.String정의합니다. 문서의 레이블이 지정되지 않거나 레이블 추출을 의도적으로 건너뛰는 경우 값이 없거나 null일 수 있습니다.
이러한 세 문자열 필드를 대상 인덱스로 추가합니다. 청크가 검색 가능한 문서인 경우 청크 인덱스에 필드를 추가합니다.
| 원본 메타데이터 필드 | 대상 인덱스 필드 | 유형 및 주석 |
|---|---|---|
metadata_sensitivity_label |
sensitivity_label_id |
Edm.StringGUID; sensitivityLabelId: true, filterable: true, retrievable: true. |
metadata_sensitivity_label_name |
sensitivity_label_name |
Edm.String레이블 이름; sensitivityLabelName: true, retrievable: true. |
metadata_source_document_id |
source_document_id |
Edm.String감사 식별자; sourceDocumentId: true, retrievable: true. |
source_document_id 필드는 감사할 원본 문서를 식별합니다. 검색 인덱스 키도 아니고 프로젝션 부모 키도 아닙니다.
Warning
다음 JSON 조각은 전체 PUT 요청 본문이 아닌 구성 델타입니다. 요청을 제출하기 전에 이를 전체 리소스 정의에 병합하세요. 만들기 또는 업데이트 PUT은 리소스 정의를 대체합니다. 기존 필드 및 배열, 매핑, 옵션, 선택기, 자격 증명 및 기타 구성을 유지합니다. 전체 정의 또는 배열을 조각으로 대체하지 마세요.
인덱스 만들기 속성: 새 인덱스의 전체 만들기 정의에 이 속성을 포함합니다. 기존 인덱스에 이미 있으면, 변경하지 않고 유지합니다.
{
"purviewEnabled": true
}
인덱스 필드 추가: 이러한 개체를 전체 인덱스 정의의 fields 배열에 추가하여 기존 스키마 및 인덱싱 레이아웃을 유지합니다.
[
{
"name": "sensitivity_label_id",
"type": "Edm.String",
"filterable": true,
"retrievable": true,
"sensitivityLabelId": true
},
{
"name": "sensitivity_label_name",
"type": "Edm.String",
"retrievable": true,
"sensitivityLabelName": true
},
{
"name": "source_document_id",
"type": "Edm.String",
"retrievable": true,
"sourceDocumentId": true
}
]
참조: 인덱스 정의.
문서 수준 매핑의 경우 7단계를 따릅니다. 자식 청크의 경우 6단계를 따릅니다.
5. 데이터 원본 구성
데이터 원본 옵션 델타: 구성된 데이터 원본의 sensitivityLabel에 indexerPermissionOptions을 추가합니다. 다른 사용 권한 옵션을 이미 사용하도록 설정한 경우 해당 옵션을 유지하고 배열을 바꾸는 대신 이 옵션을 추가합니다.
{
"indexerPermissionOptions": ["sensitivityLabel"]
}
참조: 데이터 원본 정의.
이 옵션을 사용하면 레이블 추출이 가능합니다.
sourceDocumentId, sensitivityLabelId, sensitivityLabelName 인덱스 필드 주석과는 다릅니다. 커넥터의 기존 자격 증명, 컨테이너 선택 및 기타 설정을 유지합니다.
6. 기술 집합에서 인덱스 프로젝션 구성(해당하는 경우)
파이프라인에서 청크를 인덱싱하는 경우 기존 인덱스 프로젝션 선택기를 확장합니다. 4단계에서 필드 추가 및 Purview 사용 인덱스 요구 사항을 청크 인덱스에 적용합니다.
프로젝션 매핑 추가: 이러한 항목을 indexProjections.selectors 내부의 관련 선택기의 mappings 배열에 추가합니다. 이러한 추가 항목은 완전한 선택기나 기술 세트가 아닙니다.
[
{
"name": "sensitivity_label_id",
"source": "/document/metadata_sensitivity_label"
},
{
"name": "sensitivity_label_name",
"source": "/document/metadata_sensitivity_label_name"
},
{
"name": "source_document_id",
"source": "/document/metadata_source_document_id"
}
]
참조: 스킬셋 정의.
필요한 경우 새 인덱스로 대상을 다시 지정하는 경우를 제외하고, 선택기의 targetIndexName, parentKeyFieldName, 그리고 청크 sourceContext를 유지합니다. 다른 선택기, 콘텐츠 및 벡터 매핑 및 기존 프로젝션 모드를 유지합니다. 키가 아닌 모든 자식 필드를 명시적으로 매핑합니다. 위의 세 가지 추가 항목이 전체 매핑 집합은 아닙니다.
이러한 루트 수준 경로는 부모에서 사용할 수 있는 매핑된 문자열 값을 모든 청크에 복사합니다. 프로젝션은 변경 내용 추적을 위한 자식 키 및 부모 연결을 생성합니다. 프로젝션 또는 청크 인덱서의 chunk_id에서 parent_id 또는 fieldMappings와 같은 생성된 키를 수동으로 매핑하지 마세요.
텍스트 분할 기술이 chunks 아래에 원시 문자열을 내보내는 경우, 선택기의 sourceContext 및 콘텐츠 매핑에는 /id 또는 /text 자식 경로가 아닌 /document/chunks/*를 사용합니다.
skipIndexingParentDocuments를 사용하면 직접 인덱서 fieldMappings이 자식 문서를 채우지 않습니다. 청크 수준 쿼리 강제 적용 및 관련 레이블 응답 메타데이터에는 레이블 ID 프로젝션이 필요합니다. 응답 처리에 대해서는 응답에서 민감도 레이블 메타데이터 검사를 참조하세요.
2인덱스 부모-자식 레이아웃의 경우 7단계의 직접 매핑을 사용하여 부모 인덱스를 채우고 이러한 프로젝션을 사용하여 자식 인덱스를 채웁니다. 매핑 의미 체계는 필드 매핑 검토를 참조하세요.
7. 인덱서 구성
원본 문서당 검색 문서를 하나씩 만들려면 기존 인덱서에 직접 메타데이터 매핑을 추가합니다.
/document/ 접두사 없이 원시 원본 필드 이름을 사용합니다.
직접 필드 매핑 추가: 이러한 항목을 인덱서의 fieldMappings 배열에 추가합니다. 필요할 때 새 인덱스를 대상으로 다시 지정하는 경우를 제외하고, 커넥터 키 매핑, 기타 매핑, 데이터 원본 및 기술 세트 연결, 대상 인덱스, 구성을 그대로 유지합니다.
[
{
"sourceFieldName": "metadata_sensitivity_label",
"targetFieldName": "sensitivity_label_id"
},
{
"sourceFieldName": "metadata_sensitivity_label_name",
"targetFieldName": "sensitivity_label_name"
},
{
"sourceFieldName": "metadata_source_document_id",
"targetFieldName": "source_document_id"
}
]
참조: 인덱서 정의.
청크의 경우 기존 인덱서가 해당 기술 세트에 연결되도록 합니다. 6단계의 선택기 매핑은 자식 메타데이터를 채웁니다.
레이블 수집 확인
변경 내용을 전체 리소스 정의에 병합한 후 기존 인덱서가 원본 파일을 이미 처리한 경우 초기 백필 을 수행합니다. 추출을 사용하도록 설정하거나, 메타데이터 필드를 추가하거나, 파이프라인의 대상을 다시 지정해도 변경되지 않은 파일이 일반 증분 실행의 대상이 되지 않습니다. 해당 파일들을 다시 처리하려면 인덱서를 재설정한 다음 를 실행합니다. 초기화는 변경 내용 추적을 지우고 후속 실행은 모든 원본 문서를 다시 처리합니다. 해당 작업 부하를 고려하세요.
파일이 아직 인덱싱되지 않은 경우 재설정 없이 인덱서 실행합니다. 인덱서 상태 가져오기를 사용하여 실행이 성공적으로 완료되었는지 확인하고 문서 오류 및 경고를 검사합니다. 승인된 실행 요청은 완료된 수집의 증명이 아닙니다.
권한 있는 쿼리 ID 및 쿼리 가이드를 사용하여 알려진 레이블이 지정된 문서와 해당 청크를 확인합니다.
- 지원되는 소스의 레이블이 지정된 파일은
sensitivity_label_id에 GUID 문자열을 채웁니다. 레이블이 지정된 SharePoint 문서 라이브러리(드라이브) 파일의 경우 함께 제공되는 필드에서 레이블 이름과 원본 문서 감사 ID도 확인합니다. 다른 원본의 경우 해당 원본 메타데이터를 사용할 수 있으면 함께 제공되는 값을 확인합니다. - 레이블이 지정되지 않은 문서나 레이블 추출을 의도적으로 건너뛴 문서는 레이블 ID가 없거나 null입니다.
- 모든 자식 청크는 부모에서 사용할 수 있는 매핑된 메타데이터 값을 상속하며 생성된 자식 및 부모 키는 그대로 유지됩니다.
예상 메타데이터가 누락된 경우 실행 오류 및 경고, 5단계의 데이터 원본 추출 옵션, 6단계와 7단계의 직접 또는 프로젝션 매핑을 확인하세요. 백필에서 알려진 파일을 처리했는지 확인합니다.
이후 증분 새로 고침의 경우 감지된 원본 변경 내용을 처리하도록 인덱서를 실행하거나 예약합니다. 레이블을 새로 고칠 때마다 인덱서를 다시 설정하지 마세요. 소스 레이블 변경 내용은 성공적인 인덱서 실행에서 처리할 때까지 인덱스에서 볼 수 없습니다. 반복 새로 고침은 인덱서 예약을 참조하세요.