Vynucování popisků citlivosti Microsoft Purview při dotazu v Azure AI Vyhledávač (Preview)

Při dotazu může Azure AI Vyhledávač vynucovat zásady štítků citlivosti (verze Preview) definované v Microsoft Purview. Mezi tyto zásady patří vyhodnocení práv k používání přidruženýchEXTRACT k jednotlivým dokumentům, aby uživatelé mohli načítat jenom dokumenty, ke kterým mají přístup.

Tato funkce rozšiřuje řízení přístupu na úrovni dokumentu tak, aby odpovídalo požadavkům vaší organizace na ochranu informace a dodržování předpisů spravované v Microsoft Purview.

Pokud je povolené indexování popisků citlivosti Purview, Azure AI Vyhledávač během dotazu zkontroluje metadata popisků jednotlivých dokumentů. Použije filtry přístupu založené na zásadách Purview, aby vracely jenom výsledky, ke které má požadovaný uživatel povolený přístup.

Tento článek vysvětluje, jak funguje vynucení popisků citlivosti během vyhledávání a jak provádět zabezpečené vyhledávací dotazy.

Požadavky

• Dokončete všechny kroky v Použití indexerů Azure AI Vyhledávač k příjmu citlivostních popisků Microsoft Purview.

• Ověřte, že služba Azure AI Vyhledávač má povolenou spravovanou identitu přiřazenou systémem (ne spravovanou identitu přiřazenou uživatelem) a že má přiřazené role Content.SuperUser a UnifiedPolicy.Tenant.Read. Vynucení času dotazu závisí na metadatech popisků, která indexer dokáže extrahovat pouze v případech, kdy má identita přiřazená systémem správnou konfiguraci. Viz krok 1 v článku o nastavení indexeru.

• Služba Azure AI Vyhledávač i uživatel, který dotaz vydává, musí být ve stejném tenantovi Microsoft Entra.

• K dotazování indexu použijte rozhraní REST API ve verzi 2025-11-01-preview nebo novější, případně ekvivalentní balíček SDK ve verzi Preview. Funkce čtení se zvýšenými oprávněními a protokolování auditu Purview vyžadují 2026-05-01-preview nebo novější.

• Ověřte dotazy pomocí Azure řízení přístupu založeného na rolích (RBAC), nikoli pomocí klíčů API. Pokud jsou popisky citlivosti Purview povolené, přístup ke klíči rozhraní API je omezený na načtení schématu indexu.

Omezení

• Účty hostů a dotazy mezi tenanty se nepodporují.

• API rozhraní pro automatické dokončování a Návrhy se nepodporují pro indexy s funkcí Purview.

• Pokud vyhodnocení popisku selže, vrátí služba místo částečné nebo nefiltrované sady výsledků konkrétní kód chyby HTTP. Úplný seznam kódů chyb a příčin najdete v tématu Řešení chyb dotazu.

• Systém vyhodnotí popisky pouze tak, jak existovaly v době posledního spuštění indexeru. Nedávné změny popisků se nemusí projevit až do dalšího plánovaného přeindexování.

Jak funguje prosazení štítků citlivosti při dotazu

Když se dotazujete na index, který obsahuje Microsoft Purview popisky citlivosti, Azure AI Vyhledávač zkontroluje přidružené zásady Purview před vrácením výsledků. Dotaz tak vrátí pouze dokumenty, ke kterým má token uživatele povolený přístup.

1. Identita uživatele a vstup role aplikace

V době dotazu Azure AI Vyhledávač ověří obojí:

• Role RBAC volající aplikace, která je uvedena v hlavičce Authorization. Minimální požadovaná role je Search Index Data Reader. Další podrobnosti najdete v průvodci Azure AI Vyhledávač RBAC.
• Identita uživatele pomocí tokenu uvedeného v x-ms-query-source-authorization hlavičce.

Obě možnosti jsou potřeba k autorizaci viditelnosti založené na popiscích.

2. Vyhodnocení popisku citlivosti

Při přijetí požadavku na dotaz Azure AI Vyhledávač vyhodnotí:

1. Pole sensitivityLabel v každém indexovaného dokumentu (extrahované z Microsoft Purview během příjmu dat).
2. Efektivní oprávnění Purview uživatele, jak jsou definována Microsoft Entra ID a zásadami popisku Purview.

Pokud uživatel nemá autorizaci pro popisek citlivosti dokumentu s oprávněními EXTRACT , je tento dokument vyloučen z výsledků dotazu.

3. Zabezpečené filtrování výsledků

Azure AI Vyhledávač použije filtr zabezpečení po všech uživatelsky definovaných filtrech a bodovacích krocích.
Dokument je součástí konečné sady výsledků pouze v následujících případech:

• Volající aplikace má platné přiřazení role (prostřednictvím RBAC) a
• Token identity uživatele reprezentovaný x-ms-query-source-authorization je platný a umožňuje zobrazit obsah s popiskem citlivosti dokumentu.

Pokud některý z podmínek selže, dokument se z výsledků vynechá.

Získání přístupového tokenu uživatele

Pokud chcete dotazovat Azure AI Vyhledávač pomocí kontextu uživatele, musíte získat přístupový token, který představuje přihlášeného uživatele. Přístup, který použijete, závisí na tom, jestli testujete místně pomocí vlastního tokenu, pokud máte přístup ke zdrojovému dokumentu nebo implementaci toku aplikace, který vyžaduje předání tokenu koncového uživatele.

Testovací scénáře

Pro místní testování můžete pomocí Azure CLI načíst přístupový token uživatele:

$token = az account get-access-token `
  --resource https://search.azure.com `
  --query accessToken `
  --output tsv

Tento přístup používá aktuální relaci přihlášení Azure CLI, takže můžete použít kontext u dokumentů, ke kterým máte přenesená oprávnění EXTRACT označené jako citlivé. Tato metoda je určená pouze pro scénáře vývoje a ověřování.

Získání tokenu pro scénáře OBO

Aplikace, které implementují tok on-behalf-of (OBO), musí získávat tokeny z Microsoft Entra ID s využitím podporované knihovny pro ověřování, jako je Identity a ověřování Microsoftu (MSAL).

Ve scénářích OBO požádejte token pro podřízené rozhraní API, které aplikace volá. Například při volání Azure AI Vyhledávač je identifikátor URI prostředku https://search.azure.com/.default.

Scope .default požaduje všechna delegovaná oprávnění, pro která aplikace předem udělila souhlas pro zadaný prostředek.

Oprávnění štítků citlivosti, včetně EXTRACT, nejsou reprezentována ve formě oborů OAuth. Podřízená služba, například Azure AI Vyhledávač, vyhodnocuje tato oprávnění za běhu na základě identity uživatele v tokenu a použitých zásad popisků citlivosti.

Příklad dotazu

Zde je příklad dotazu, který používá vynucování popisků citlivosti v Microsoft Purview.

Předejte token aplikace jako nosný token v hlavičce Authorization . Předejte token uživatele jako nezpracovanou hodnotu tokenu x-ms-query-source-authorization v hlavičce bez předpony Bearer .

POST  {{endpoint}}/indexes/sensitivity-docs/docs/search?api-version=2026-08-01-preview
Authorization: Bearer {{app-query-token}}
x-ms-query-source-authorization: {{user-query-token}}
Content-Type: application/json

{
    "search": "*",
    "select": "title,summary,sensitivityLabel",
    "orderby": "title asc"
}

Rozšířené oprávnění ke čtení pro správní šetření (Preview)

Čtení se zvýšenými oprávněními umožňuje oprávněnému vývojáři vrátit označené dokumenty, které volající uživatel za normálních okolností nevidí, přičemž se pro každý dokument vrácený požadavkem vytvoří záznam v auditním protokolu Microsoft Purview. Můžete ho použít pro kontroly dodržování předpisů, eDiscovery, reakce na incidenty a další šetření správy, u kterých se vyžaduje auditovatelný záznam o přístupu.

U indexů s podporou Purview v rozhraní REST API verze 2026-05-01-preview a novějších je k dispozici zvýšená oprávnění ke čtení.

Jak funguje čtení se zvýšenými oprávněními

1. Volající aplikace nastaví hlavičku x-ms-enable-elevated-read: true v požadavku hledání.

2. Azure AI Vyhledávač přeskočí kontrolu přístupu na základě popisků jednotlivých dokumentů a vrátí odpovídající dokumenty bez ohledu na oprávnění EXTRACT požadovaného uživatele u každého popisku.

3. Pro každý dokument v odpovědi Azure AI Vyhledávač vygeneruje jednu položku do protokolu auditu Microsoft Purview jménem žádajícího tenanta. Jeden požadavek na vyhledávání, který vrátí N dokumentů, vytvoří N položek auditního protokolu.

4. Položky auditu se do Purview odesílají asynchronně až po vrácení odpovědi na vyhledávání.

Požadované přiřazení role

Volající vývojář musí mít roli Přispěvatel dat indexu vyhledávání ve vyhledávací službě nebo oboru indexu. Čtečka dat indexu vyhledávání nestačí. Pokud není role přiřazená, čtení se zvýšenými oprávněními 403 Forbidden selže. Další informace o rolích Azure AI Vyhledávač najdete v tématu Pojení k Azure AI Vyhledávač pomocí rolí.

Pokud je hlavička x-ms-enable-elevated-read nastavená na true, x-ms-query-source-authorization záhlaví se nedá použít.

Příklad čtení se zvýšenými oprávněními

POST  {{endpoint}}/indexes/sensitivity-docs/docs/search?api-version=2026-08-01-preview
Authorization: Bearer {{contributor-token}}
x-ms-enable-elevated-read: true
Content-Type: application/json

{
    "search": "*",
    "select": "title,summary,sensitivityLabel",
    "orderby": "title asc"
}

Pole auditu odeslaná do Microsoft Purview

Každý záznam auditu odpovídá schématu rozhraní API pro aktivitu správy Office 365 a zahrnuje následující pole.

Postupná degradace

Pokud se Azure AI Vyhledávač při zpracování dotazu, například během přechodného výpadku služby Purview, nemůže připojit k Microsoft Purview, přeskočí u daného požadavku vyhodnocení štítku. Chování závisí na tom, jestli požadavek zahrnuje token identity uživatele:

• Požadavky na čtení se zvýšenými oprávněními (x-ms-enable-elevated-read: true): Požadavek selže s 5xx. Azure AI Vyhledávač nevrací označené dokumenty, dokud nemůže nejprve vytvářet protokoly auditu.

• Standardní požadavky vynucované popiskem (s x-ms-query-source-authorization): Požadavek selže s 5xx. Azure AI Vyhledávač nevrací částečné ani nefiltrované výsledky, pokud nedokáže vyhodnotit zásady popisků.

• Volání bez x-ms-query-source-authorization vydaná aplikací, která má alespoň roli Čtenář dat indexu vyhledávání: Požadavek bude úspěšně zpracován a vrátí pouze dokumenty, které nemají popisek citlivých informací. Označené dokumenty jsou z odpovědi vynechány.

Tato degradovaná cesta je určená pouze pro pracovní postupy bez uživatele, které explicitně přijímají neoznačené výsledky. Nespoléhejte na to pro vyhledávání koncových uživatelů.

Úplný seznam kódů chyb vrácených během vyhodnocení popisku citlivosti dotazu najdete v tématu Řešení chyb dotazu.

Vyhledání protokolů auditu se zvýšenými oprávněními ke čtení v Microsoft Purview

Azure AI Vyhledávač nahrává položky auditu do protokolu auditu Microsoft Purview volajícího tenanta. Pro zkoumání zvýšené aktivity čtení:

1. V Portál Microsoft Purview vyberte Solutions>Audit.

2. Vyberte Audit Search a pak vyfiltrujte podle rozsahu kalendářních dat, uživatele nebo typu záznamu Azure AI Vyhledávač.

3. Otevřete položku pro zobrazení standardních polí schématu a vlastních polí Azure AI Vyhledávač, včetně SensitivityLabelName, DocumentDataSourceType a DocumentDataSourceId.

Podrobné pokyny k vyhledávání v protokolu auditu, chování při uchovávání a požadovaným rolím Purview najdete v tématu Vyhledání v protokolu auditu na portálu Microsoft Purview.

Zpracování štítků citlivosti v Azure AI Vyhledávač

Když Azure AI Vyhledávač indexuje obsah dokumentu s popisky citlivosti ze zdrojů, jako jsou SharePoint, Azure blob a další, uloží obsah i metadata popisků. Vyhledávací dotaz vrátí indexovaný obsah spolu s identifikátorem GUID, který identifikuje popisek citlivosti použitý v dokumentu, pouze pokud má uživatel přístup k datům EXTRACT pro daný dokument přiřazený prostřednictvím definice popisku citlivosti. Tento identifikátor GUID jednoznačně identifikuje popisek, ale neobsahuje vlastnosti čitelné pro člověka, jako je název popisku nebo přidružená oprávnění.

Všimněte si, že samotný identifikátor GUID není pro scénáře, které zahrnují uživatelské rozhraní, nedostatečné, protože popisky citlivosti často přenášejí další ovládací prvky zásad vynucené Microsoft Purview Information Protection, například: oprávnění k tisku nebo omezení snímků obrazovky. Azure AI Vyhledávač tyto funkce nezobrazuje.

Pokud chcete zobrazit názvy popisků nebo vynutit omezení specifická pro uživatelské rozhraní, musí vaše aplikace volat koncový bod Microsoft Purview Information Protection, aby načetla úplná metadata popisků a přidružená oprávnění.

Identifikátor GUID vrácený Azure AI Vyhledávač můžete použít k vyřešení vlastností popisku a volání rozhraní API Purview Labels k načtení názvu popisku, popisu a nastavení zásad.

Řešení chyb v dotazech

Pokud vyhodnocení popisku citlivosti v době dotazu selže, Azure AI Vyhledávač vrátí konkrétní kód chyby HTTP, který identifikuje příčinu. Služba nikdy nevrátí částečnou nebo nefiltrovanou sadu výsledků. Pokud zásady popisů nelze vyhodnotit, dotaz selže, místo aby zpřístupnil neoznačený nebo neautorizovaný obsah.

400 – Chybný požadavek

Chyba 400 značí problém s konfigurací indexu nebo hlavičkami požadavku. Před opakováním opravte konfiguraci.

401 Neautorizováno

Chyba 401 značí problém s autorizačním tokenem nebo oprávněními Purview aplikace.

502 – Chybná brána

Chyba 502 značí selhání připojení mezi Azure AI Vyhledávač a Microsoft Purview. Tyto chyby jsou obvykle přechodné.

504 Časový limit brány vypršel

Chyba 504 značí, že Microsoft Purview neodpověděl v povolené době.

Kompletní nastavení testování

Pokud si chcete v Azure AI Vyhledávač ověřit konfiguraci štítků citlivosti, podívejte se na referenční komplexní konfiguraci.

Toto úložiště ukazuje, jak:

• Konfigurace synchronizace a dodržování popisků citlivosti v Azure AI Vyhledávač
• Testovací scénáře vynucování při příjmu a při dotazování pro dokumenty s popisky citlivosti
• Extrahujte název popisku a zpřístupněte ho jako součást citací používaných v aplikacích nebo agentech RAG.