Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Note
Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.
Important
Features oder Funktionen, die in diesem Artikel als "Vorschau" gekennzeichnet sind, befinden sich in der öffentlichen Vorschau und unterliegen den ergänzenden Nutzungsbedingungen für Microsoft Azure Previews.
Spezifische Vorschaubedingungen für Foundry IQ (Azure KI-Suche) finden Sie unter Vorschaufunktionen.
SharePoint ACL-Erfassung und Berechtigungsfilterung zur Abfragezeit, ADLS Gen2 ACL/RBAC und Standard-Blobcontainer-RBAC sind mit der Datenebenen-REST-API 2026-10-01 allgemein verfügbar. Push-ACL-Erfassung ist auch allgemein verfügbar. Die Erzwingung von Vertraulichkeitsbezeichnungen in Microsoft Purview bleibt in der Vorschau.
Foundry IQ (Azure KI-Suche) unterstützt die Zugriffssteuerung auf Dokumentebene, sodass Organisationen differenzierte Berechtigungen auf Dokumentebene von der Datenaufnahme über die Abfrageausführung erzwingen können. Diese Funktionalitäten sind unverzichtbar für den Aufbau sicherer KI-Agenten-Systeme, die Daten erden, Retrieval-augmented Generation (RAG)-Anwendungen und Suchlösungen für Unternehmen, die Autorisierungsprüfungen auf Dokumentenebene erfordern.
Ansätze für die Zugriffssteuerung auf Dokumentebene
Foundry IQ bietet fünf primäre Ansätze zum Erzwingen von Berechtigungen auf Dokumentebene, die jeweils für verschiedene Datenquellen und Identitätsmodelle geeignet sind.
| Ansatz | Beschreibung |
|---|---|
| Sicherheitsfilter | Zeichenfolgenvergleich. Ihre Anwendung übergibt eine Benutzer- oder Gruppenidentität als Zeichenfolge, die einen Filter für eine Abfrage auffüllt, wobei alle Dokumente ausgeschlossen werden, die nicht mit der Zeichenfolge übereinstimmen. Sicherheitsfilter sind eine Technik zum Erreichen der Zugriffssteuerung auf Dokumentebene. Dieser Ansatz ist nicht an eine API gebunden, sodass Sie eine beliebige Version oder ein beliebiges Paket verwenden können. |
| POSIX-ähnliche ACL / RBAC-Bereiche | Die Microsoft Entra Identität des delegierten Benutzers wird anhand der unterstützten Berechtigungsmetadaten ausgewertet. ADLS Gen2 ACL- und Erfassung des Container-RBAC-Bereichs, Erfassung des Standard-Blob-Container-RBAC-Bereichs und deren Filterung von Abfrageberechtigungen sind in der REST-API 2026-10-01 allgemein verfügbar. Die vom Kunden verwaltete Push-ACL-Erfassung ist auch allgemein verfügbar. Andere Features behalten ihre dokumentierte Verfügbarkeit bei; nicht alle Speicherautorisierungsrichtlinien werden unterstützt. Api- und SDK-Anleitungen finden Sie unter Abrufen von ACL-Berechtigungsmetadaten. |
| Microsoft Purview Sensitivitätslabels (Vorschau) | Indexer extrahiert Vertraulichkeitsbezeichnungen, die in Microsoft Purview aus unterstützten Datenquellen definiert sind (Azure Blob Storage, ADLS Gen2, SharePoint in Microsoft 365, OneLake). Diese Bezeichnungen werden als Metadaten gespeichert und zur Abfragezeit ausgewertet, um den Benutzerzugriff basierend auf Microsoft Entra-Token und Purview-Richtlinienzuweisungen zu erzwingen. Bezeichnungen werden auch über Wissensquellen und die Antwort zur agentischen Abfrage bereitgestellt, sodass KI-Agenten und Chat-Apps, die eine Wissensdatenbank nutzen, dieselbe kennzeichnungsbasierte Filterung erhalten. Dieser Ansatz bringt die Foundry IQ-Autorisierung mit dem Microsoft Information Protection-Modell Ihres Unternehmens in Einklang. |
| ACLs für SharePoint in Microsoft 365 | Foundry IQ Indexers extrahieren unterstützte Berechtigungsmetadaten und verwenden sie für Abfragezeitzugriffsprüfungen mit REST-API 2026-10-01. Informationen zur indizierten Berechtigungsuntermenge, Gruppenbeschränkungen, Synchronisierungsverhalten und Konfiguration finden Sie unter Verwenden eines SharePoint Indexers zum Aufnehmen von Berechtigungsmetadaten. |
| OneLake-Quellberechtigungen (Vorschau) | Verwendet indizierte Quellspeicherorte und abfragezeitbasierte OneLake-Autorisierung anstelle kopierter Benutzer- und Gruppen-ACLs. Siehe "OneLake-Berechtigungen beibehalten". |
Für indizierte Wissensquellen kann ingestionPermissionOptions nicht mit assetStore kombiniert werden. Aus diesem Grund ist die Bildbereitstellung (Vorschau) nicht verfügbar, wenn die Erfassung systemeigener Berechtigungen auf Dokumentebene aktiviert ist.
Unterstützte Analyse und Inhaltsextraktion für die Berechtigungsaufnahme
Wenn Sie systemeigene Berechtigungen auf Dokumentebene für SharePoint, ADLS Gen2 oder Blob Storage aktivieren, verwenden Sie die standardmäßige oder Standard-Dokumentverarbeitung und Inhaltsextraktion. Bewahren Sie die Berechtigungsmetadaten und den Quellkontext jedes Quellelements während der Aufnahme auf.
Sie können auch die auf Content Understanding basierende Extraktion verwenden, sofern sie von Ihrer Datenquelle und API unterstützt wird. Konfigurieren Sie jeden generierten Block, um die erforderlichen Berechtigungsmetadaten und den Quellkontext beizubehalten. Unterstütztes nachgelagertes Chunking ist nicht dasselbe wie die Auswahl eines speziellen Quellanalysemodus.
Verwenden Sie für die REST-API 2026-10-01die Einstellungen für die Ressource, die Sie konfigurieren:
| Resource | REST-Eigenschaft | Configuration |
|---|---|---|
| SharePoint, ADLS Gen2 oder Blob-Indexer | parameters.configuration.parsingMode |
Verwenden Sie default für die standardmäßige Dokumentanalyse. |
| Blob-Wissensquelle, einschließlich ADLS Gen2 | azureBlobParameters.ingestionParameters.contentExtractionMode |
minimal ist die Standardextraktionsoption; standard wählt die Content-Understanding-basierte Extraktion aus. Bewahren Sie die generierten Berechtigungs- und Quellkontextzuordnungen auf. |
| Indizierte SharePoint Wissensquelle | indexedSharePointParameters.ingestionParameters.contentExtractionMode |
minimal ist die Standardextraktionsoption; verwenden Sie standard für Content-Understanding-basierte Extraktion, sofern unterstützt. Konfigurieren Sie die Extraktion über die Wissensquell-API, nicht durch Ändern der generierten Parsereinstellungen. |
Knowledge-source contentExtractionMode und Indexer parsingMode sind unterschiedliche Einstellungen. Insbesondere handelt es sich bei minimal nicht um einen speziellen Klartext-Analysemodus. Die REST-Definitionen finden Sie unter Indexer – Erstellen und Wissensquellen – Erstellen oder Aktualisieren.
Andere vom Kunden ausgewählte Parsingmodi werden derzeit nicht mit Berechtigungen auf Dokumentebene unterstützt. Nicht auswählen:
- JSON-Parsing (
json). - JSON-Arrayanalyse (
jsonArray) oder Analysieren mehrerer JSON-Dokumente in separate Datensätze. - JSON-Lines-Parsing (
jsonLines). - CSV oder durch Trennzeichen getrenntes Text-Parsing (
delimitedText). - Plain-Text-spezifisches Parsing (
text). - Markdown-spezifische Analyse (
markdown). - Jeder andere Modus, der mehrere logische Datensätze aus einem Quellelement ohne einen unterstützten Vertrag für die Berechtigungsverteilung erstellt, aufteilt, umgestaltet oder zuordnet.
Diese Einschränkungen betreffen die Analysemodi, nicht dateierweiterungen oder das Format extrahierter Inhalte. Beispielsweise verwendet eine mit default verarbeitete Nur-Text-Datei nicht den speziellen text-Modus. Die Markdown-Ausgabe von Content Understanding ist nicht der markdown Quellanalysemodus.
Informationen zu Blockzuordnungen und erforderlichen Quellmetadaten finden Sie in den SharePoint Berechtigungsanleitungen, ADLS Gen2-Berechtigungsanleitungen und Blob-RBAC-Bereichsleitfaden.
Vertrauen Sie der Quelle indizierter Berechtigungen
Die Berechtigungsfilterung zur Abfragezeit wertet die Berechtigungsmetadaten aus, die einem indizierten Datensatz zugeordnet sind. Außerdem muss Ihr Ingestionsdesign festlegen, wer berechtigt ist, die Identität dieses Datensatzes festzulegen und Zugriff auf seine Inhalte zu gewähren. Ein Dokumentschlüssel wählt einen Datensatz für Aktualisierungen oder Zusammenführungen aus. es handelt sich nicht um eine Autorisierungsgrenze.
Befolgen Sie bei der Erfassung über native Konnektoren die quellspezifische Konfiguration und behalten Sie die Zuordnung zwischen Quellinhalten, Identität und von Konnektoren abgeleiteten Berechtigungen bei. Für die vom Kunden verwaltete Push-Erfassung stellt der autorisierte Herausgeber die Schlüssel- und Berechtigungswerte bereit. Die Filterung von anwendungsverwalteten Zeichenfolgen hängt auch von der Authentifizierung und Filtererstellung der Anwendung ab.
Behandeln Sie normale Inhalte mit niedrigerer Vertrauensebene nicht als autorisierte Berechtigungsmetadaten nur, weil ein Feldname übereinstimmt. Überprüfen Sie Quellautoren, Erfassungsadministratoren, implizite und explizite Zuordnungen, Anreicherungsergebnisse und projizierte untergeordnete Elemente. Verwenden Sie für blob-Erfassung die Prüfliste für die Identitäts- und Berechtigungskonfiguration. Diese Überprüfung ist unabhängig von der Aktualität der Berechtigungen.
Auswählen eines Ansatzes
Verwenden Sie die folgenden Kriterien, um den Ansatz zu identifizieren, der ihren Anforderungen an Datenquelle, Identitätsmodell und Compliance am besten entspricht.
| Szenario | Empfohlener Ansatz | Warum? |
|---|---|---|
| Benutzerdefiniertes Identitätssystem oder kein Microsoft-Sicherheitsframework. | Sicherheitsfilter | API-agnostisch, allgemein verfügbar und basierend auf einfachem Zeichenfolgenabgleich. |
| Microsoft Entra Benutzer- und Gruppenberechtigungen, die an einen Index, indizierte ADLS Gen2 ACLs oder indizierte Container-RBAC-Bereiche aus ADLS Gen2 und Azure Blob Storage übertragen wurden. | POSIX-ähnliche ACL / RBAC-Bereiche | Verwendet systemeigene Berechtigungsmetadaten zur Durchsetzung bei Abfragen. Das Schema, die Pushindizierung und die Abfrageerzwingung sind in der REST-API 2026-10-01 allgemein verfügbar; für die quellspezifische Datenaufnahme gelten separate Verfügbarkeitsanforderungen. |
| Unternehmensinhalte unterliegen bereits Microsoft Purview Informationsschutzrichtlinien. | Microsoft Purview Vertraulichkeitsetiketten | Verwendet zentralisierte Klassifizierungen und Richtlinienzuweisungen in Foundry IQ wieder. |
| Inhalte, die aus SharePoint in Microsoft 365 (Bibliotheken, Listen, ASPX-Websiteseiten) stammen. | ACLs für SharePoint in Microsoft 365 | Bewertet die unterstützte Berechtigungsuntermenge, die in Search synchronisiert wird. Vergleichen Sie SharePoint Abrufansätze und Aktualität bei quellseitigem Abruf zur Anforderungszeit oder kundenkontrollierter Aktualisierungsübermittlung. |
Muster für die Sicherheitskürzung mithilfe von Filtern
Verwenden Sie für Szenarien, in denen die native ACL/RBAC-Integration nicht realisierbar ist, Sicherheits-String-Filter, um Ergebnisse anhand von Ausschlusskriterien einzugrenzen. Das Muster enthält die folgenden Komponenten:
- Um Benutzer- oder Gruppenidentitäten zu speichern, erstellen Sie ein Zeichenfolgenfeld im Index.
- Laden Sie den Index mithilfe von Quelldokumenten, die zugeordnete ACLs enthalten.
- Fügen Sie Ihrer Abfragelogik einen Filterausdruck hinzu, um die Zeichenfolge abzugleichen.
- Zur Abfragezeit die Identität des Anrufers abrufen.
- Übergeben Sie die Identität des Aufrufers als Filterzeichenfolge.
- Die Ergebnisse werden gekürzt, um Übereinstimmungen auszuschließen, die die Benutzer- oder Gruppenidentitätszeichenfolge nicht enthalten.
Sie können Push- oder Pullmodell-APIs verwenden. Da dieser Ansatz API-agnostisch ist, müssen Sie nur bestätigen, dass der Index und die Abfrage gültige Zeichenfolgen (Identitäten) für den Filtrationsschritt haben.
Dieser Ansatz ist nützlich für Systeme mit benutzerdefinierten Zugriffsmodellen oder nicht Microsoft Sicherheitsframeworks. Weitere Informationen zu diesem Ansatz finden Sie unter Sicherheitsfilter zum Filtern von Ergebnissen in Foundry IQ.
Muster für systemeigene Unterstützung für POSIX-ähnliche ACL- und RBAC-Bereichsberechtigungen
Die systemeigene Berechtigungsfilterung verwendet indizierte Microsoft Entra Benutzer- und Gruppenobjekt-IDs und Speichercontainer-RBAC-Bereiche.
Azure Data Lake Storage (ADLS) Gen2 unterstützt ACLs für Verzeichnisse und Dateien. Verwenden Sie einen ADLS Gen2-Indexer oder eine Blob-Wissensquelle, die für ADLS Gen2 konfiguriert ist , um unterstützte ACLs und Container-RBAC-Bereiche mit REST-API 2026-10-01aufzunehmen. Für Standard-Blob Storage erfasst der Blob-Indexer oder die Wissensquelle Container-RBAC-Bereiche, nicht dateispezifische ACLs.
Verwenden Sie für ACL-gesicherte Inhalte den Gruppenzugriff über den einzelnen Benutzerzugriff, um die Verwaltung zu erleichtern. Das Muster enthält die folgenden Komponenten:
- Beginnen Sie mit Dokumenten oder Dateien mit ACL-Zuweisungen.
- Aktivieren Sie Berechtigungsfilter im Index.
- Fügen Sie dem entsprechenden String- oder Stringsammlungsfeld in einem Index einen Berechtigungsfilter hinzu.
- Laden Sie den Index mit Quelldokumenten mit zugeordneten ACLs.
- Fragen Sie den Index ab, und fügen Sie
x-ms-query-source-authorizationzum Anforderungsheader hinzu.
Systemeigene, durch Berechtigungen gefilterte Abfragen unterscheiden den Aufrufer vom Benutzer, dessen Dokumentberechtigungen ausgewertet werden:
-
Authorizationträgt das Token des Aufrufers für die Such-RBAC. Ein Anwendungsdienstprinzipal oder eine verwaltete Identität kann Search mit der entsprechenden Rolle aufrufen, z. B. Search Index Data Reader oder Search Index Data Contributor. -
x-ms-query-source-authorizationenthält das Token eines delegierten Benutzers zur Auswertung von Dokumentberechtigungen. Gruppen sind Berechtigungsmetadaten und keine tokenführenden Identitäten.
Eine Anwendung, die die Suche aufrufen kann, wird nicht unbedingt als Subjekt einer Dokumentberechtigung unterstützt. Eine autorisierte Anwendung kann z. B. Leseberechtigungen für einen Nicht-Purview-Index verwenden, diese administrative Umgehung wertet jedoch die ACL-Mitgliedschaft der Anwendung nicht aus. Informationen zu unterstützten Tokenflüssen und vorgangsspezifischen Grenzwerten finden Sie unter Anwendungstokengrenzen.
Verwenden Sie den Push-API-Workflow , um Inhalte und systemeigene Berechtigungsmetadaten zu laden.
Verwenden Sie die Pullmodell-APIs (Indexer) für ADLS Gen2 ACLs und Containerbereiche oder Standard-BLOB-Containerbereiche mit REST-API 2026-10-01.
Abrufen von ACL-Berechtigungsmetadaten während der Aufnahme
Wie Sie ACL-Berechtigungen abrufen, hängt davon ab, ob Sie eine Dokumentnutzlast übertragen oder den ADLS Gen2-Indexer verwenden.
Verwenden Sie für ADLS Gen2 und die standardmäßige Blob-Berechtigungsaufnahme DIE REST-API 2026-10-01. Überprüfen Sie die SDK-Änderungsprotokolle auf Unterstützung für diese API und die erforderlichen Eigenschaften. Die Verfügbarkeit von GA-REST bedeutet nicht, dass das SDK-Paket einsatzbereit ist.
Die Push-ACL-Erfassung ist allgemein verfügbar. Die Pushanleitung enthält einen 2026-10-01 REST-Workflow. Überprüfen Sie SDK-Änderungsprotokolle zur Unterstützung von Berechtigungsfiltern und ACL/RBAC-Erfassung:
-
REST-API
2026-10-01, die in den Beispielen verwendet wird. - Azure SDK für Python Änderungsprotokoll.
- Azure SDK für .NET Änderungsprotokoll.
- Azure SDK für Java Änderungsprotokoll.
Für den Pushmodellansatz:
- Erstellen Sie ein Indexschema mit Berechtigungsfiltern mithilfe der REST-API oder eines Azure SDK-Pakets, das die erforderlichen Eigenschaften unterstützt.
- Erwägen Sie die Verwendung des Microsoft Graph SDK zum Abrufen von Gruppen- oder Benutzeridentitäten.
- Verwenden Sie die Index Documents oder gleichwertige Azure SDK-API, um Dokumente und die zugehörigen Berechtigungsmetadaten in den Suchindex zu übertragen.
Für das Pull-Modell ADLS Gen2 Indexer-Ansatz oder die ADLS Gen2-Wissensquelle:
- Stellen Sie sicher, dass Dateien im Verzeichnis mithilfe des ADLS Gen2-Zugriffssteuerungsmodells gesichert sind.
- Verwenden Sie Indexers – Create (REST-API), Knowledge Sources - Create (REST-API) oder eine entsprechende Azure SDK-API zum Erstellen des Indexers, Indexes und der Datenquelle.
Wenn Ihr Skillset ADLS- oder BLOB-Dokumente in Segmente aufteilt, füllen Sie Berechtigungen für jeden geschützten Block über Indexprojektionen, nicht nur über Indexer-Feldzuordnungen.
Quellmetadaten für die Berechtigungserfassung
Quellkontext und Berechtigungserteilungen dienen verschiedenen Zwecken. Behalten Sie Quellpfade als Rohwerte bei, nicht als codierte Schlüssel, Zitat-URLs oder generierte übergeordnete IDs.
| Quelle und Szenario | Quellmetadaten und Zweck | Zuordnung und Verfügbarkeit |
|---|---|---|
| ADLS benannte Benutzer-/Gruppen-ACLs | Erforderliches metadata_storage_path (Edm.String) identifiziert die Quelle.
metadata_user_ids und metadata_group_ids enthalten effektive ACLs. |
Ordnen Sie ACLs Collection(Edm.String) Feldern mit Anmerkungen userIds und groupIds zu. Behalten Sie den Pfad in Datensätzen und Blöcken bei. GA in 2026-10-01. |
| Nur ADLS-RBAC |
metadata_storage_path ist für die Erfassung von Berechtigungen in ADLS erforderlich, auch ohne ACL-Felder.
metadata_rbac_scope identifiziert den Container. |
Ordnen Sie den Bereich einem Edm.String Feld zu, das mit rbacScope annotiert ist. Der erforderliche Pfad wird nicht zum Kopieren von Rollenzuweisungen verwendet. GA in 2026-10-01. |
| Gemischte ACL/RBAC in ADLS | Quellpfad, effektive Benutzer-/Gruppen-ACLs und Containerbereich. | Bewahren Sie alle konfigurierten Felder in Datensätzen und projizierte Blöcke auf. Jede unterstützte unabhängige Berechtigung kann den Zugriff autorisieren. GA in 2026-10-01. |
| Standard Blob RBAC |
metadata_rbac_scope identifiziert den Container; Ein Dokumentpfad ist nicht erforderlich, um diesen Bereich zu berechnen. Generierte Wissensquell-Pipelines enthalten weiterhin metadata_storage_path. |
Ordnen Sie den skalaren Bereich einem mit rbacScope annotierten Feld für Dokumente und Chunks zu. Keine ADLS-Datei-ACL-Ableitung. GA in 2026-10-01. |
| SharePoint ACLs |
metadata_spo_item_path stellt den Elementkontext bereit; metadata_spo_site_url stellt den Websitekontext bereit. Listen und Seiten verwenden auch metadata_spo_site_asset_item_id. |
Verwenden Sie die quellspezifischen SharePoint Schema- und Projektionsanleitungen. SharePoint Verfügbarkeit und Anforderungen sind unabhängig vom Speicher-GA-Bereich. |
Informationen zu direkten Schemadefinitionen, autoritativen Zuordnungen, generierten Pipelines und Korrekturen vorhandener Datensätze finden Sie unter ADLS permission ingestion und Blob RBAC scope ingestion.
Für ADLS-Quell-ACLs, die breiten Zugriff gewähren, während benannte Identitäten ausgeschlossen werden, siehe Nicht unterstützte implizite blocklistsACLs.
Muster für die Erfassung grundlegender ACL-Berechtigungen für SharePoint in Microsoft 365
Für indizierte SharePoint Inhalte kann Foundry IQ unterstützte Quellberechtigungen als Metadaten speichern und zum Filtern von Abfrageergebnissen verwenden. Verwenden Sie den SharePoint-Indexer in Microsoft 365 mit REST-API 2026-10-01 für diese Berechtigungskonfiguration oder ein SDK-Paket, das das Feature unterstützt.
Informationen zu Berechtigungsanforderungen, unterstützten Gruppenbeziehungen, Berechtigungssynchronisierung und Einschränkungen finden Sie unter Verwenden eines SharePoint Indexers zum Aufnehmen von Berechtigungsmetadaten.
Wenn Ihr Skillset Dokumente gliedert (z. B. mit der Fähigkeit "Textteilung" für die integrierte Vektorisierung), werden die ACL-Felder von Indexerfeldzuordnungen zu Indexprojektionen verschoben. Siehe Auswählen, wo ACL-Felder aufgefüllt werden sollen.
Muster für die Empfindlichkeitsbezeichnungen von Microsoft Purview (in der Vorschau)
Wenn Sie die Bezeichnungsaufnahme aktivieren, extrahiert Foundry IQ Vertraulichkeitsmetadaten aus unterstützten Datenquellen. Zu diesen Datenquellen gehören Azure Blob Storage, Azure Data Lake Storage Gen2 (ADLS Gen2), SharePoint in Microsoft 365 und Microsoft OneLake. Die extrahierten Bezeichnungen werden zusammen mit Dokumentinhalten im Index gespeichert.
Zur Abfragezeit überprüft Foundry IQ die Vertraulichkeitsbezeichnung jedes Dokuments, das Microsoft Entra-Token des Benutzers und die Purview-Richtlinien der Organisation, um den Zugriff zu bestimmen. Das System gibt Dokumente nur zurück, wenn die Identität des Benutzers und seine bezeichnungsbasierten Berechtigungen den Zugriff gemäß den konfigurierten Purview-Richtlinien zulassen.
Dieses Muster enthält die folgenden Komponenten:
- Konfigurieren Sie Ihren Index, die Datenquelle und den Indexer (für Planungszwecke) mithilfe der REST-API
2026-11-01-previewoder eines Vorschau-SDK, das die Aufnahme von Purview-Bezeichnungen unterstützt. - Aktivieren Sie eine vom System zugewiesene verwaltete Identität für Ihren Foundry IQ-Dienst. Benutzerseitig zugewiesene verwaltete Identitäten werden für die Extraktion von Purview-Bezeichnungen nicht unterstützt; die eigene Identität des Diensts muss über die erhöhten Purview-Berechtigungen verfügen. Lassen Sie dann Ihren globalen Mandantenadministrator oder Administrator für privilegierte Rollen den erforderlichen Zugriff gewähren, damit sich der Foundry IQ-Dienst bei Microsoft Purview authentifizieren und Bezeichnungsmetadaten extrahieren kann.
- Übernehmen Sie Vertraulichkeitsbezeichnungen vor der Indizierung für Dokumente, damit das System sie während der Aufnahme erkennen und beibehalten kann.
- Fügen Sie zur Abfragezeit ein gültiges Microsoft Entra-Token über den Header
x-ms-query-source-authorizationan jede Abfrageanforderung an. Foundry IQ wertet das Token und die zugehörigen Labelmetadaten aus, um die labelbasierte Zugriffssteuerung zu erzwingen.
Die Durchsetzung von Purview-Vertraulichkeitsbezeichnungen ist auf Szenarien mit nur einem Mandanten beschränkt und erfordert eine RBAC-Authentifizierung. Während der Vorschau wird sie nur über die REST-API und Azure SDKs unterstützt. AutoVervollständigen- und Vorschlags-APIs sind derzeit nicht für Purview-fähige Indizes verfügbar.
Wo Vertraulichkeitsbezeichnungen angezeigt werden
Bevor das System Kennzeichnungen bei Abfragen erzwingen oder in Abrufantworten zurückgeben kann, müssen Sie zuerst die Metadaten der Kennzeichnungen in den Index synchronisieren. Beide in diesem Abschnitt beschriebenen Verbrauchspfade hängen von diesem Synchronisierungsschritt ab. Sie können Labels synchronisieren, indem Sie einen Foundry IQ-Indexer direkt für eine unterstützte Datenquelle konfigurieren oder die entsprechende Aufnahmeoption aktivieren, wenn Sie eine Knowledge Source erstellen. In beiden Fällen muss Ihre Umgebung die Konfigurationsvoraussetzungen für die Metadatensynchronisierung von Vertraulichkeitsbezeichnungen erfüllen (verwaltete Identität, RBAC für den Foundry IQ-Dienst und die erforderlichen Microsoft Purview- und Datenquellenberechtigungen). Informationen zum Einrichten von End-to-End-Indexer finden Sie unter Verwenden von Foundry IQ Indexern, um Microsoft Purview Vertraulichkeitsbezeichnungen aufzunehmen. Für eine durch Wissensquellen gesteuerte Erfassung legen Sie ingestionPermissionOptions so fest, dass sensitivityLabel bei der Erstellung der Wissensquelle einbezogen wird.
Nachdem Sie Bezeichnungen synchronisiert haben, verwenden zwei Abfragepfade dieselben indizierten Bezeichnungsmetadaten. Wählen Sie den Pfad aus, der dazu passt, wie Ihre Anwendung Foundry IQ aufruft:
Direkte Abfrage-API (
/docs/search): Fügen Sie das Microsoft Entra-Token des Benutzers inx-ms-query-source-authorizationein. Administratoren können auch Anfragen für Lesezugriff mit erhöhten Rechten für nachvollziehbare Untersuchungen stellen. Informationen zur Einrichtung und Beispiele finden Sie unter Durchsetzung der Microsoft Purview-Vertraulichkeitsbezeichnungen zur Abfragezeit.Wissensquellen und agentische Abrufe (MCP): Legen Sie
ingestionPermissionOptionsso fest, dasssensitivityLabelin die Wissensquelle eingeschlossen wird. Die Abrufaktion und das MCP-Toolknowledge_base_retrievegeben Informationen pro VerweissensitivityLabelInfosowie auf Antwortebenemetadata.responseSensitivityLabelInfozurück, die Clients für die Anzeige von Bannern und die Durchsetzung von Richtlinien verwenden können. Informationen zum Einrichten finden Sie unter Erstellen von Wissensquellen und Überprüfen von Metadaten mit Vertraulichkeitsbezeichnungen in Abrufantworten.
Wenn die Wissensquelle auf einen in Chunks unterteilten Index verweist, wie etwa einen, der durch integrierte Vektorisierung oder einen benutzerdefinierten Skill zur Textaufteilung erstellt wird, muss das Skillset auch die Vertraulichkeitsbezeichnung in jede Chunk-Zeile projizieren. Ohne diese Projektion werden Verweise auf Blockebene nicht gefiltert.
Weitere Informationen finden Sie unter Verwenden von Foundry IQ-Indizierern zum Erfassen von Microsoft Purview-Vertraulichkeitsbezeichnungen.
Durchsetzung von Berechtigungen auf Dokumentenebene während der Abfrage
Die tokenbasierte Abfragedurchsetzung ist eine bereichsübergreifende Funktion, die für POSIX-ähnliche ACL- und RBAC-Bereiche, Microsoft-Purview-Vertraulichkeitsbezeichnungen und ACL-Muster in SharePoint in Microsoft 365 gilt. Mithilfe der systemeigenen tokenbasierten Abfrage überprüft Foundry IQ das Microsoft Entra Token des Aufrufers für jede Anforderung und schneidet Resultsets nur auf die Dokumente zu, die der Aufrufer gemäß den Dokument-ACLs lesen darf, solange die Dokument-ACL-Metadaten mit dem Index synchronisiert werden.
Wenn Sie das Token des Benutzers über den x-ms-query-source-authorization Header an eine Abfrageanforderung anfügen, findet foundry IQ:
- Extrahiert die Benutzer-, Gruppen- und Bereichsansprüche aus dem Token.
- Vergleicht diese Ansprüche mit den Berechtigungsmetadaten, die zusammen mit indizierten Dokumenten gespeichert sind (ACL-Einträge, RBAC-Bereiche, Purview-Bezeichnungszuweisungen oder SharePoint ACLs).
- Gibt nur Dokumente zurück, deren synchronisierte Berechtigungsmetadaten den Aufruferzugriff gewähren.
Aktualität von Berechtigungen
Die Erzwingung von Abfragen verwendet gespeicherte Berechtigungsmetadaten, aber die Aktualität hängt vom Berechtigungstyp ab. ADLS-Benutzer- und Gruppen-ACLs sind indizierte Momentaufnahmen: ACL-änderungen verwenden standardmäßig aktivierte, ungefähr tägliche automatische Aktualisierung für berechtigte normale Ausführungen oder eine explizite Erneute Synchronisierung von Berechtigungen. Container-RBAC-Bereiche identifizieren Ressourcen und keine Rollenzuweisungen; Die Autorisierung delegierter Benutzer wird zur Abfragezeit separat unter Berücksichtigung von Propagierung und Caches ausgewertet. Die Auflösung der Gruppenmitgliedschaft verfügt auch über ein eigenes Verteilungs- und Zwischenspeicherungsverhalten.
Bei SharePoint deckt die inkrementelle Verarbeitung erkannte Änderungen auf Elementebene und unterstützte Nicht-Stammordner-Berechtigungsänderungen ab, einschließlich unveränderter untergeordneter Elemente. Andere Bereiche oder verpasste Benachrichtigungen können eine explizite Aktualisierung erfordern. Siehe Synchronisieren von Berechtigungen zwischen indizierten und Quellinhalten für die Szenariotabelle und Zeitliche Einschränkungen.
Die Berechtigungsaktualisierung bietet keinen sofortigen Widerruf oder eine korpusweite Aktualitäts-SLA. Informationen zu Betriebsschritten, Fehlern, Blockkonsistenz und Bereinigung finden Sie unter ADLS-Synchronisierung, Aktualität des Blobbereichs und SharePoint Synchronisierung. Die benutzerdefinierte Push-Erfassung bleibt für die Synchronisierung ihrer eigenen Metadaten verantwortlich.
Die Implementierungsschritte für End-to-End-Abfragen finden Sie unter Abfragezeit-ACL- und RBAC-Erzwingung in Foundry IQ.
Vorteile der Zugriffssteuerung auf Dokumentebene
Die systemeigene Zugriffssteuerung auf Dokumentebene in Foundry IQ bietet konkrete Vorteile gegenüber anwendungsseitiger Filterung:
- Reduziert benutzerdefinierten Berechtigungscode: Foundry IQ behandelt unterstützte Gruppenauflösung und Berechtigungsfilterung während der Abfrageausführung.
- Ist mit vorhandenen Compliance-Steuerelementen abgestimmt: Die Wiederverwendung von Microsoft Entra-, Microsoft Purview- und SharePoint-Berechtigungsmetadaten hilft dabei, Suchergebnisse mit dem Quellidentitätssystem abgestimmt zu halten. Überprüfen Sie das Berechtigungssynchronisierungsmodell für jede Quelle, um ihre Einschränkungen zu verstehen.
- Berücksichtigt Quellberechtigungen nach jeder ACL-Synchronisierung: Bei tokenbasierten Ansätzen (ACL, RBAC-Bereiche, Purview-Bezeichnungen, SharePoint ACLs) verwendet die Abfragezeiterzwingung die Berechtigungsmetadaten, die der dokumentierte quellspezifische Synchronisierungsmechanismus (Indexerausführung, Push-API-Update oder Purview-Aktualisierung) bereits in den Index geschrieben hat.
- Verbessert die Leistung gegenüber dem Kürzen nach der Abfrage: Das Filtern innerhalb der Suchpipeline ist schneller als das Laden größerer Resultsets in Ihre Anwendung und das Kürzen dort, insbesondere bei hohen Abfragevolumes.
- Nutzt Ihre vorhandene Identitätsinfrastruktur weiter: Microsoft Entra und SharePoint-Identitäten bleiben die maßgebliche Quelle für Zugriffsentscheidungen, was die Identitätsduplizierung und den betriebstechnischen Aufwand für die Aufrechterhaltung eines parallelen Berechtigungsspeichers reduziert.
Lernprogramme und Beispiele
Erkunden Sie die Zugriffssteuerung auf Dokumentebene in Foundry IQ mit weiteren Artikeln und Beispielen.
- Lernprogramm: Indizieren von ADLS Gen2-Berechtigungsmetadaten mithilfe eines Indexers
- azure-search-rest-samples/acl
- azure-search-python-samples/Quickstart-Document-Permissions-Push-API
- azure-search-python-samples/Quickstart-Document-Permissions-Pull-API
- Demo-App: Erfassen und Berücksichtigen von Vertraulichkeitsbezeichnungen
Verwandte Inhalte
- Dokument-ACLs mit den Push-REST-APIs indizieren
- Indizieren von Berechtigungen auf Dokumentebene mithilfe des ADLS Gen2-Indexers
- Indizieren von Berechtigungen auf Dokumentebene mithilfe des SharePoint-Indexers in Microsoft 365
- Indizieren von Vertraulichkeitsbezeichnungen mithilfe von Indexern (Vorschau)
- Abfragen eines für Vertraulichkeitsbezeichnungen aktivierten Index (Vorschau)
- Abfragen mithilfe der tokenbasierten Berechtigungen von Microsoft Entra