Foundry IQ의 쿼리 시간 ACL 및 RBAC 적용(Azure AI 검색)

참고

Foundry IQ (Azure AI 검색)는 관리 검색을 위해 고급 수준의 지식 원본 API 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.

중요

이 문서에서 (미리 보기)로 표시된 기능 또는 성능은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.

Foundry IQ(Azure AI 검색)와 관련된 미리 보기 용어는 미리 보기 기능을 참조하세요.

SharePoint ACL 권한 필터링, ADLS Gen2 ACL/RBAC 필터링, 표준 Blob 컨테이너 RBAC 필터링 및 상승된 읽기는 일반적으로 2026-10-01 데이터 평면 REST API에서 사용할 수 있습니다.

쿼리 시간 액세스 제어는 위임된 사용자의 ID 및 인덱스의 지원되는 권한 메타데이터를 사용하여 검색 결과를 필터링합니다. 푸시 ACL 수집은 정식 출시되었습니다. Microsoft Purview 민감도 레이블 적용은 미리 보기로 유지됩니다.

권한 있는 액세스는 인덱싱 중에 수집되는 권한 메타데이터에 따라 달라집니다. ADLS(Azure Data Lake Storage) Gen2 및 Microsoft 365 SharePoint 같은 기본 제공 액세스 모델이 있는 인덱서 데이터 원본의 경우 인덱서는 각 문서에 대한 권한 메타데이터를 자동으로 끌어올 수 있습니다. 다른 데이터 원본의 경우 문서 페이로드를 직접 어셈블해야 하며 페이로드에는 콘텐츠와 연결된 권한 메타데이터가 모두 포함되어야 합니다. 그런 다음 푸시 API 를 사용하여 인덱스를 로드합니다.

이 문서에서는 권한 메타데이터를 사용하여 결과를 필터링하는 쿼리를 설정하는 방법을 설명합니다.

OneLake 원본 권한은 호출자 토큰 흐름을 다시 사용합니다 x-ms-query-source-authorization . 원본 위치 메타데이터 요구 사항 및 권한 부여 모델에 대해서는 아래에 설명된 복사된 ACL/RBAC 모델이 아니라 OneLake 권한 유지를 참조하세요.

필수 구성 요소

  • 인덱스에서 permissionFilterOption를 사용하도록 설정하고, 필터링 가능한 최상위 권한 필드를 사용합니다. 쿼리에 사용 권한 필터를 추가하지 않습니다. 검색 엔진이 내부적으로 빌드합니다.

  • 원본에 적합한 권한 메타데이터를 사용합니다. SharePoint 사용자 및 그룹 ID, ADLS Gen2용 POSIX 스타일 ACL 또는 ADLS Gen2 또는 표준 Blob Storage RBAC 범위에 대한 컨테이너 리소스 ID.

  • 사용자 지정 수집을 사용하는 ACL 기반 적용의 경우 userIds 및 groupIds는 전자 메일 주소나 UPN이 아닌 Microsoft Entra 개체 ID(GUID)로 저장합니다. 쿼리 시 Foundry IQ(Azure AI 검색)는 x-ms-query-source-authorization의 위임된 사용자 토큰을 사용하여 문서 권한을 평가합니다. 필드 형식 및 스키마 세부 정보는 푸시 REST API를 사용한 인덱스 문서 ACL을 참조하세요.

  • 데이터 원본에 따라:

    • ADLS Gen2 데이터 원본의 경우, 컨테이너 수준에서 ACL(액세스 제어 목록) 및/또는 Azure RBAC(역할 기반 액세스 제어) 역할을 구성해야 합니다.
    • Azure Blob 데이터 원본의 경우 지원되는 컨테이너 액세스가 있어야 합니다. Blob 인덱서, 기술 자료 또는 푸시 API를 사용하여 인덱스의 권한 메타데이터를 인덱싱할 수 있습니다.
    • SharePoint 데이터 원본의 경우 ACL(액세스 제어 목록)을 구성해야 합니다. built-in SharePoint 인덱서를 사용하고 ACL 수집 기능 사용하여 구성할 수 있습니다. 인덱싱된 SharePoint 기술 원본을 사용하여 문서 수준 권한을 적용하도록 구성할 수도 있습니다. Microsoft 365 그룹를 포함한 그룹 기반 권한은 Entra 개체 ID로 수집되는 경우 지원됩니다. 그룹 확장은 Microsoft Graph 통해 쿼리 시간에 발생합니다.
  • SharePoint 및 ADLS/Blob 권한 필터링 쿼리에 REST API 2026-10-01을 사용하거나 패키지 변경 로그에서 동등한 SDK 지원을 확인합니다. 독립적인 미리 보기 시나리오의 경우 해당 문서화된 API 버전을 사용합니다.

제한

  • 확인되지 않은 그룹 멤버 자격은 액세스 권한을 부여하지 않습니다. SharePoint의 경우 독립적으로 확인된 권한 부여는 그룹 조회가 실패하더라도 계속 적용됩니다. 요청이 권한 부여 오류를 반환하는 경우 필터링되지 않았거나 상승된 액세스 권한으로 다시 시도하지 마세요.

  • 복사된 ACL 및 RBAC 메타데이터의 경우 각 수집 메서드가 권한 변경 내용을 인덱스에 전파하는 방법에 따라 새로 고침이 달라집니다.

    • SharePoint 인덱서는 성공적인 증분 처리 중에 검색된 항목 수준 변경 내용 및 지원되는 루트가 아닌 폴더 권한 변경 사항을 반영합니다. 권한 새로 고침을 위한 짧은 반복 일정을 구성합니다. 이 간격은 완료 기한 또는 권한 취소 SLA가 아닙니다. 연결된 지침에서는 다른 범위와 명시적 새로 고침 옵션도 설명합니다.
    • ADLS Gen2 인덱서는 기본적으로 적격한 일반 실행 시 ACL을 거의 매일 새로 고치거나, 명시적 권한 재동기화를 통해 새로 고칩니다.
    • Blob 및 ADLS RBAC 범위 검사는 쿼리 시 위임된 사용자의 컨테이너 권한 부여를 평가합니다. 역할 할당 전파 및 권한 부여 캐시는 인덱싱된 ACL 최신성과는 별개입니다.
    • 사용자 지정 또는 푸시 수집을 사용하려면 영향을 받는 문서를 다시 수집해야 합니다.
  • OneLake 원본 위치 메타데이터 및 쿼리 시간 액세스 정보는 사용 권한 및 경로 최신 상태를 참조하세요.

  • 승격된 읽기가 없는 쿼리에는 다음이 모두 필요합니다.

    • 호출자의 검색 RBAC 권한 부여(Authorization 헤더)입니다.
    • 권한으로 보호되는 콘텐츠에 대해 x-ms-query-source-authorization에 의해 전달되는 위임된 사용자 ID입니다.
  • 초기 ACL 기반 쿼리는 캐싱 및 권한 확인 오버헤드로 인해 후속 요청에 비해 대기 시간이 더 높을 수 있습니다.

  • 인덱싱된 SharePoint 콘텐츠의 경우 SharePoint 그룹 내에 중첩된 Microsoft Entra 그룹은 별도의 사이트 수준 보안 주체 제한에 따라 5개 수준 내에서 지원됩니다. 지원되는 그룹 관계를 참조하세요.

데이터 원본당 ACL 항목 제한

ACL(액세스 제어 목록) 항목 제한은 연결된 데이터 원본 내의 파일, 폴더 또는 항목과 연결할 수 있는 고유 권한 레코드 수를 정의합니다. 각 항목은 단일 사용자 또는 그룹 ID와 해당 ID에 부여된 액세스 권한(예: 읽기, 쓰기 또는 실행)을 나타냅니다.

Foundry IQ 기능에서 지원하는 ACL 항목의 최대 수는 데이터 원본 형식에 따라 달라집니다.

Azure Data Lake Storage Gen2(ADLS Gen2): 각 파일 또는 디렉터리에는 최대 32개의 ACL 항목 사용 권한 포함할 수 있습니다. 이 컨텍스트에서 항목은 특정 권한 집합을 가진 단일 주체(사용자 또는 그룹)를 의미합니다. 예: "모든 사용자" 읽기 액세스 및 "Azure 사용자" 실행 액세스를 할당하면 두 개의 ACL 항목으로 계산됩니다.

Microsoft 365 SharePoint: 검색의 SharePoint 데이터 원본은 파일당 최대 1,000개의 권한 항목을 지원합니다. 각 항목은 항목의 사용 권한 목록에 있는 고유한 사용자 또는 그룹 할당을 나타냅니다. 이는 고유한 사용 권한을 가질 수 있는 항목 수를 제어하는 목록 또는 라이브러리당 전체 고유 권한 범위 제한 과 다릅니다.

이러한 제한은 검색 결과를 인덱싱하거나 필터링할 때 Foundry IQ가 항목 수준 권한을 어떻게 세분화하여 적용할 수 있는지를 결정합니다. 항목이 이러한 ACL 항목 제한을 초과하는 경우 쿼리 시 제한을 초과하는 권한이 적용되지 않을 수 있습니다.

쿼리 시간 적용의 작동 방식

이 섹션에서는 쿼리 시 ACL 적용에 대한 작업 순서를 나열합니다. 작업은 Azure RBAC 범위 또는 Microsoft Entra ID 그룹 또는 사용자 ID를 사용하는지에 따라 달라집니다.

1. 사용자 권한 입력

네이티브 권한 필터링 쿼리의 경우 두 토큰 위치에는 별도의 역할이 있습니다.

  • Authorization 는 호출자를 인증하고 검색 RBAC를 통해 데이터 평면 검색 작업에 권한을 부여합니다. 호출자는 필요한 검색 역할 및 리소스 범위를 가진 사용자, 애플리케이션 서비스 주체 또는 관리 ID일 수 있습니다.
  • x-ms-query-source-authorization 는 위임된 사용자 액세스 토큰을 포함합니다. Foundry IQ는 애플리케이션의 문서 사용 권한이 아니라 Authorization의 애플리케이션에 대한 해당 사용자의 문서 권한을 평가합니다.

검색을 호출할 수 있는 권한이 부여된 애플리케이션 또는 관리 ID는 자동으로 지원되는 문서 사용 권한 주체가 아닙니다. 또한 인덱서가 원본을 읽는 데 사용하는 ID는 쿼리 호출자 및 사용 권한이 평가되는 사용자와는 별개입니다.

다음 표에서는 지원되는 위임된 사용자 흐름에 대해 설명합니다. 각 흐름은 소스별 권한 및 API 제한을 유지합니다.

사용 권한 흐름 지원되는 위임 사용자 동작
userIds ACL 인덱싱된 사용자 ACL에 대해 위임된 사용자의 Microsoft Entra 개체 ID(oid)x-ms-query-source-authorization와 일치합니다.
groupIds ACL 지원되는 보안 그룹 및 Microsoft 365 그룹를 포함하여 Microsoft Graph를 통해 사용자의 Microsoft Entra 그룹 멤버 자격을 확인하여 해석하고 해당 개체 ID를 인덱싱된 그룹 ACL과 대조합니다.
SharePoint 사이트 그룹 인덱스에 등록된 애플리케이션을 통해 위임된 사용자의 사이트 그룹 멤버 자격을 확인합니다. groupIds에서 spg:-접두사 ID와 일치합니다. SharePoint 그룹 구성 필요합니다. SharePoint 권한 필터링에 REST API 2026-10-01 를 사용합니다.
rbacScope 인덱싱된 ADLS Gen2 또는 표준 Blob 컨테이너 범위에서 위임된 사용자의 지원되는 Blob 읽기 권한 부여를 평가합니다.
Purview 민감도 레이블(미리 보기) 별도의 Purview 요구 사항에 따라 위임된 사용자의 레이블 권한을 평가합니다.

Microsoft Entra 그룹 확장은 OBO(사용자 대신) 흐름에서 쿼리 원본 사용자 토큰을 사용합니다. 그룹은 토큰 기반 ID가 아닙니다. Authorization의 애플리케이션 토큰은 이 그룹 확인 흐름에 필요한 위임된 사용자 어설션을 대체하지 않습니다. 지원되는 그룹 관계는 소스별 제한을 참조하세요.

애플리케이션 토큰 경계

애플리케이션이 검색에 인증하는 기능뿐만 아니라 작업 및 권한 모델에 대한 토큰 흐름을 선택합니다.

Flow 애플리케이션 토큰 경계
검색 호출자 인증 필요한 Search 역할이 할당된 애플리케이션 서비스 주체 또는 시스템 할당 또는 사용자 할당 관리 ID는 호출자를 인증할 수 있습니다. 이렇게 하면 문서 사용 권한 주체가 되지 않습니다.
userIds, groupIds, 및 SharePoint 사이트 그룹 위에서 설명한 위임된 쿼리 원본 사용자 흐름을 사용합니다. 토큰 또는 ACL의 애플리케이션 개체 ID는 지원되는 앱 전용 쿼리 원본 흐름을 설정하지 않습니다. 그룹 확장에는 문서화된 사용자 어설션 및 동의가 여전히 필요합니다.
조직 전체 권한 값 광범위하게 적용 가능한 권한 승인은 토큰 규약을 변경하지 않습니다. 콘텐츠에 조직 전체의 권한이 있으므로 필요한 사용자 토큰을 생략하거나 애플리케이션 토큰을 대체하지 마세요.
컨테이너 rbacScope 지원되는 위임된 사용자 흐름을 사용하세요. 인덱서 또는 애플리케이션에 스토리지 역할을 할당하더라도 쿼리 사용자의 권한 부여를 대신할 수는 없습니다.
OneLake 소스 권한 원본별 프리뷰 계약을 따르고 요청 중인 사용자의 토큰을 전달합니다. Search의 관리형 ID가 OneLake에 인증하는 것은 해당 사용자와는 별개입니다.
Purview 레이블 Purview가 사용 설정된 인덱스에 대한 상승된 읽기 권한과 관련된 위임된 사용자 요구 사항을 포함하여, 별도로 지정된 위임된 사용자 요구 사항을 준수하세요.
Purview 없이 권한 상승 읽기 권한 있는 애플리케이션은 앱 전용 호출자 인증을 사용하여 직접 인덱스 관리 작업을 수행할 수 있습니다. 이렇게 하면 문서 사용 권한 필터링이 무시됩니다. 애플리케이션 ACL 멤버 자격을 평가하지 않습니다.
애플리케이션 관리형 보안 문자열 필터 애플리케이션은 사용자를 인증하고 신뢰된 필터를 자체적으로 생성합니다. 이것은 네이티브 애플리케이션 토큰 권한 평가가 아닙니다.

추가 권한 주체 지원 oid 또는 tid 클레임, 워크로드 ID 페더레이션, 에이전트 ID 또는 앱-앱 OBO 구성을 유추하지 마세요. 특정 기능에 대해 문서화된 ID 획득 흐름, 동의, API 버전 및 동작을 사용합니다.

Direct Search 쿼리, Get Document, 기술 자료 검색, MCP/에이전트 액세스에는 각기 별도의 계약이 적용됩니다. 한 인터페이스에서 지원된다고 해서 다른 인터페이스에서도 동일한 헤더, ID 형식 또는 관리 바이패스가 설정되는 것은 아닙니다. 기술 자료 및 MCP 액세스의 경우 쿼리 시간 검색 권한 부여를 따릅니다. 인용은 별도의 권한 부여 경로를 제공하지 않습니다.

요청이 제공된 토큰 또는 행위자를 거부하는 경우 애플리케이션 요청을 안전하게 실패합니다. 사용자 토큰을 생략하거나, 주체를 전환하거나, 필터링되지 않은 결과 또는 공개 전용 결과를 반환하거나, 상향된 읽기 권한을 사용하도록 설정하여 다시 시도하지 마세요.

2. 보안 필터 생성

내부적으로 Foundry IQ는 제공된 사용자 권한에 따라 보안 필터를 동적으로 생성합니다. 이러한 보안 필터는 인덱스에 사용 권한 필터 옵션이 설정된 경우 쿼리와 함께 들어올 수 있는 모든 필터에 자동으로 추가됩니다.

Azure RBAC의 경우 인덱스는 복사된 역할 할당이 아닌 컨테이너 리소스 ID를 저장합니다. Foundry IQ는 해당 범위에서 x-ms-query-source-authorization 지원되는 Blob 읽기 권한 부여에 대해 위임된 사용자를 평가합니다. 이 사용자가 반드시 검색 데이터 평면에 대한 액세스 권한을 독립적으로 부여하는 Authorization의 애플리케이션 보안 주체는 아닙니다. 권한 부여 확인은 캐시를 사용합니다. 다시 인덱싱해도 해당 캐시가 강제로 새로 고쳐지지는 않습니다.

3. 결과 필터링

ACL/RBAC 보안 필터는 인덱싱된 userIdsgroupIds필드 및 필드에 대한 사용자의 사용 권한과 rbacScope 일치합니다. 이러한 권한 부여는 독립적으로 평가됩니다. 일치하는 지원되는 권한 부여는 이 필터를 충족합니다. 예를 들어 일치 권한 부여에는 일치 userIdsgroupIds 권한 부여도 필요하지 않습니다. Purview 레이블 적용 에는 별도의 요구 사항이 있습니다.

이 어느 하나의 권한 부여 동작에는 성공적인 권한 평가가 필요합니다. 직접 사용자 ACL 또는 RBAC 권한 부여가 일치할 수 있더라도 그룹을 조회하거나 구성된 다른 권한 흐름을 처리하는 데 실패하면 요청이 실패할 수 있습니다.

해지를 테스트할 때 지원되는 대체 부여를 제외합니다. 컨테이너 RBAC 권한 부여가 여전히 사용자에게 권한을 부여하는 경우 ACL 부여를 제거해도 액세스가 거부되지는 않습니다. 권한 평가에 실패하면 애플리케이션 요청을 안전하게 실패합니다. 위임된 토큰 없이 다시 시도하거나 상승된 읽기를 대체로 사용하도록 설정하지 마세요.

ADLS Gen2의 경우 지원되지 않는 암시적 blocklists 권한은 ACL 파생 액세스 권한을 부여하지 않지만 독립적으로 지원되는 RBAC 권한 부여는 여전히 액세스 권한을 부여할 수 있습니다.

이러한 기본 권한 검사도 적용됩니다 moreLikeThis. 유사성 검색을 실행하기 전에 원본 문서를 읽을 수 있어야 하며 후보 문서는 독립적으로 필터링됩니다. 원본 문서를 읽을 수 없거나 누락된 경우 요청은 작업 권한 부여 실패가 아닌 빈 검색 결과를 반환합니다. Purview 사용 인덱스는 별도로 거부 moreLikeThis합니다.

쿼리 시 SharePoint 그룹

Foundry IQ는 REST API2026-10-01를 사용하여 쿼리 시 소유자, 구성원, 방문자 및 사용자 지정 사이트 그룹과 같은 SharePoint 사이트 그룹 권한을 평가할 수 있습니다. 이 시나리오를 사용하려면 인덱스가 다음을 포함해야 합니다.

  • sharePointConnectorAppRegistration 페더레이션 인증에 대한 수집 애플리케이션의 클라이언트 ID 및 관리 ID의 애플리케이션 ID를 지정하는 속성입니다.
  • 인덱싱된 각 항목의 SharePoint 사이트 URL을 저장하는 sharepointSiteUrl: true 특성으로 표시된 필드입니다(일반적으로 SharePointSiteUrl 이름이 지정되고 metadata_spo_site_url 원본 필드에서 채워집니다).

쿼리 시 Foundry IQ는 각 후보 문서의 등록된 애플리케이션 및 사이트 URL을 사용하여 해당 사이트에서 호출하는 사용자의 SharePoint 그룹 멤버 자격을 확인합니다. 확인된 그룹은 spg: 권한 필터 필드에 저장된 groupIds로 시작하는 값과 대조됩니다. spg: 접두사는 SharePoint 사이트 그룹을 접두사 없이 저장되는 Microsoft Entra 그룹 개체 ID와 구분합니다.

구성 세부 정보 및 제한 사항은 SharePoint 그룹 지원 구성 참조하세요.

SharePoint 권한 필터링이 누락되거나 예기치 않은 결과를 반환하는 경우 SharePoint 권한 필터링 문제 해결을 참조하세요.

예: SharePoint 사이트 그룹 강제 적용 쿼리

요청은 표준 ACL 적용 쿼리와 동일합니다. Foundry IQ 서비스는 인덱스의 sharePointConnectorAppRegistration를 사용하여 호출자를 대신해 SharePoint 그룹 멤버 자격을 확인합니다. <INDEX_NAME>를 엔드포인트로, <USER_ACCESS_TOKEN>를 인덱스 이름으로, <SEARCH_SERVICE_ENDPOINT>를 원시 위임된 사용자 토큰으로 바꾸십시오. 저장된 권한 메타데이터를 검사하려면 일반 사용자 쿼리에서 ACL 필드를 노출하지 않고 ACL 수집 확인 단계를 따릅니다.

POST <SEARCH_SERVICE_ENDPOINT>/indexes('<INDEX_NAME>')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer {{query-token}}
x-ms-query-source-authorization: <USER_ACCESS_TOKEN>
Content-Type: application/json

{
    "search": "*",
    "select": "name,description",
    "orderby": "name asc"
}

쿼리 예제

2026-10-01 푸시 인덱싱 워크플로에서 인덱스 및 4개 문서 페이로드를 사용합니다. 문서를 검색할 수 있게 될 때까지 기다립니다. 엔드포인트로 <USER_ACCESS_TOKEN> 바꾸고 업로드에 사용된 원시 위임된 사용자 토큰 <USER_OBJECT_ID> 으로 바꿉 <SEARCH_SERVICE_ENDPOINT> 다. 인덱스 쿼리에 권한이 부여된 호출자 토큰을 사용합니다.

POST <SEARCH_SERVICE_ENDPOINT>/indexes('secured-content-index')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer {{query-token}}
x-ms-query-source-authorization: <USER_ACCESS_TOKEN>
Content-Type: application/json

{
    "search": "*",
    "select": "id,content",
    "top": 4,
    "count": true,
    "orderby": "id asc"
}

참조: 문서 검색.

잘못된 결과를 조사하기 위한 상승된 권한

권한 상승 읽기는 일반적으로 REST API 2026-10-01에서 사용할 수 있습니다. 최종 사용자 쿼리에 대한 대체가 아니라 권한 있는 관리 조사에만 사용합니다.

승격된 읽기 요청은 문서 수준 권한 필터에 관계없이 일치하는 문서를 반환합니다. 누락되거나 예기치 않은 결과를 조사할 때 인덱싱된 콘텐츠를 검사하도록 x-ms-enable-elevated-read: true를 설정합니다.

Purview를 사용하지 않는 인덱스의 경우 애플리케이션 서비스 주체는 관리자 권한 읽기에 Authorization 앱 전용 액세스 토큰을 사용할 수 있습니다. 호출자에게 필요한 관리자 권한 읽기 권한을 할당합니다. 이렇게 하면 문서 사용 권한 필터링이 무시됩니다. 애플리케이션을 문서 사용 권한 주체로 평가하지 않습니다.

elevated-read 요청에 x-ms-query-source-authorization를 포함하지 마세요. 결과를 최종 사용자의 보기와 비교하려면 관리자 권한으로 읽은 헤더 없이 해당 사용자의 토큰을 사용하여 별도의 일반 쿼리를 실행합니다.

Purview 사용 인덱스의 경우 승격된 읽기에는 Authorization에 위임된 사용자 토큰이 필요합니다. 앱 전용 토큰은 해당 흐름에 대해 지원되지 않습니다. Purview 관리자 권한 읽기 요구 사항을 참조하세요.

관리자 권한의 읽기 요청에 대한 권한

호출자에 Authorization 는 검색 인덱스 데이터 기여자 권한 또는 읽기 권한 상승 권한이 포함된 사용자 지정 역할이 있어야 합니다.

쿼리는 데이터 평면 작업이므로 사용자 지정 역할은 원자성 데이터 평면 권한으로만 구성됩니다. 사용자 지정 역할의 경우 Microsoft.Search/searchServices/indexes/contentSecurity/elevatedOperations/read 권한을 추가합니다.

쿼리에 고급 읽기 헤더 추가

사용 권한을 설정한 후 쿼리를 실행할 수 있습니다. 다음 예제는 검색 인덱스를 위한 쿼리 요청입니다.

POST {endpoint}/indexes('{indexName}')/docs/search.post.search?api-version=2026-10-01
Authorization: Bearer {AUTH_TOKEN}
x-ms-enable-elevated-read: true
Content-Type: application/json

{
    "search": "prototype tests",
    "select": "filename, author, date",
    "count": true
}

중요

REST API는 2026-10-01 검색 GET, POST 검색 및 문서 가져오기 작업을 지원 x-ms-enable-elevated-read 합니다. 지식 베이스 조사를 위해 기본 검색 인덱스에 직접 요청을 보냅니다. 기술 자료 검색 REST API는 이 헤더를 선언하지 않습니다. 민감도 레이블 적용은 별도의 미리 보기 요구 사항을 유지합니다.

특정 미리 보기 API 버전에서 중요한 ACL 기능 동작 변경

REST API 버전 2025-11-01-preview이전에는 사용자 토큰이 제공되지 않았더라도 서비스 API 키 또는 권한 있는 Entra 역할을 사용할 때 이전 미리 보기 버전 2025-05-01-preview2025-08-01-preview 과 모든 문서를 반환했습니다. 사용자 토큰의 존재 여부를 확인하지 않은 애플리케이션은 올바르게 구현되지 않거나 모범 사례를 따르는 경우 실수로 최종 사용자에게 결과를 노출할 수 있습니다.

2025년 11월부터 이 동작이 변경되었습니다.

  • ACL 권한 필터는 이제 ACL을 지원하는 모든 버전에서 서비스 API 키 또는 Entra 인증만 사용하는 경우에도 적용됩니다.
  • 사용자 토큰을 생략하면 ACL로 보호된 콘텐츠가 반환되지 않습니다.
  • 문제 해결을 위해 모든 문서를 보려면 REST API 버전 2026-05-01-preview 이상을 사용할 때 관리자 권한 헤더를 명시적으로 포함해야 합니다.

이 업데이트는 애플리케이션이 토큰 유효성 검사에 대한 모범 사례를 적용하지 않는 경우 콘텐츠를 보호하는 데 도움이 됩니다.