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.
Hinweis
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.
Wichtig
Microsoft Purview Aufnahme von Vertraulichkeitsbezeichnungen befindet sich in der öffentlichen Vorschau und unterliegt den ergänzenden Nutzungsbedingungen für Microsoft Azure Previews.
Die für dieses Feature geltenden Vorschaubedingungen finden Sie unter Previewfunktionalität.
Fügen Sie Microsoft Purview Unterstützung für Vertraulichkeitsbezeichnungen (Vorschau) zu einer vorhandenen Foundry IQ (Azure KI-Suche)-Indexerpipeline hinzu. Konfigurieren Sie die Bezeichnungsextraktion, versehen Sie die Zielmetadatenfelder mit Anmerkungen und ordnen Sie diese Werte den einzelnen indizierten Dokumenten oder Blöcken zu. Foundry IQ verwendet die indizierten Bezeichnungen, um den Zugriff auf Dokumentebene zur Abfragezeit gemäß Ihren Microsoft Purview Richtlinien zu erzwingen.
Diese Funktionalität ist für die folgenden Datenquellen verfügbar:
Die Beispiele mit drei Feldern in diesem Artikel verwenden Metadaten, die für SharePoint in Dokumentbibliotheken (Laufwerken) von Microsoft 365 bestätigt wurden. Die Aufnahme von Vertraulichkeitsbezeichnungen unterstützt keine SharePoint-Listenelemente oder Website-Seiten.
Voraussetzungen
Eine vorhandene Datenquelle und ein Indizierungsprogramm, die mithilfe der im vorherigen Abschnitt verknüpften Connectoranleitungen konfiguriert wurden. Wenn Ihre Pipeline Chunks indiziert, konfigurieren Sie das Skillset und die Indexprojektionen, bevor Sie Bezeichnungszuordnungen hinzufügen.
Ein Zielindex, der mit
purviewEnabled: trueerstellt wurde, oder ein Plan, einen neuen Purview-fähigen Index zu erstellen und die vorhandene Pipeline wie in Schritt 4 beschrieben neu zuzuweisen.Konfigurieren Sie Microsoft Purview Vertraulichkeitsbezeichnungsrichtlinien, und wenden Sie sie vor der Indizierung auf Dokumente an.
Verfügen Sie über die Rollen "Globaler Administrator" oder "Administrator für privilegierte Rollen" in Ihrem Microsoft Entra Mandanten, um dem Findry IQ-Dienst Zugriff auf Purview-APIs und Vertraulichkeitsbezeichnungen zu gewähren.
Sowohl der Foundry IQ-Dienst als auch der Benutzer, der die Abfrage ausgibt, muss sich im gleichen Microsoft Entra Mandanten befinden.
Verwenden Sie Quelldokumente mit Dateitypen, die sowohl von Purview-Vertraulichkeitsbezeichnungen unterstützt werden als auch von Foundry IQ Indexern unterstützt werden.
Verwenden Sie DIE REST-API Version 2026-11-01-Preview oder ein entsprechendes Vorschau-SDK-Paket.
Der Foundry IQ-Dienst muss seine vom System zugewiesene verwaltete Identität verwenden, um sich mit Microsoft Purview zu authentifizieren. Dieses Feature unterstützt keine vom Benutzer zugewiesenen verwalteten Identitäten.
Einschränkungen
Dieses Feature wird vom Azure-Portal nicht unterstützt.
AutoVervollständigen- und Vorschlags-APIs werden für Purview-fähige Indizes nicht unterstützt, da sie noch keine bezeichnungsbasierte Zugriffssteuerung erzwingen können.
Gastkonten und mandantenübergreifende Abfragen werden nicht unterstützt.
Die folgenden Indexer-Funktionen unterstützen keine Dokumente mit Vertraulichkeitskennzeichnungen. Wenn Sie eines dieser Features in einem Skillset oder Indexer verwenden, werden Dokumente mit Vertraulichkeitsbezeichnungen nicht verarbeitet.
Wissensspeicher, einschließlich des Ressourcenspeichers, der für die Bildbereitstellung (Vorschau) im agentischen Abruf erforderlich ist. Daher wird die Bereitstellung von Bildern für Wissensquellen, die Vertraulichkeitsbezeichnungen übernehmen, nicht unterstützt.
Funktionsweise der Richtlinienerzwingung
Die Unterstützung von Vertraulichkeitskennzeichnungen erfolgt in zwei Phasen: Indizierung und Durchsetzung zur Abfragezeit.
Indizierung
Der Indexer extrahiert Dokumentinhalte und Metadaten von Vertraulichkeitsbezeichnungen. Bei nachfolgenden Ausführungen werden indizierte Werte aktualisiert, wenn Änderungen an der Bezeichnung, dem Inhalt oder den Metadaten eines Dokuments erkannt werden.
Der Index spiegelt Änderungen an den Bezeichnungen von Quelldokumenten erst nach dem nächsten erfolgreichen Ausführen des Indexers wider.
Durchsetzung zur Abfragezeit
Zur Abfragezeit wertet Foundry IQ Vertraulichkeitsbezeichnungen aus und erzwingt die Zugriffssteuerung auf Dokumentebene basierend auf dem Microsoft Entra ID-Token des Benutzers und den Bezeichnungsrichtlinien von Microsoft Purview. Nur Benutzer, die berechtigt sind, auf Inhalte mit LESE-Nutzungsrecht unter einer bestimmten Bezeichnung zuzugreifen, können entsprechende Dokumente in Suchergebnissen abrufen.
Informationen zu Abfrageauthentifizierungs- und Autorisierungsanforderungen finden Sie unter Einen Index mit Vertraulichkeitsbezeichnungen abfragen. Informationen zu administrativen Untersuchungen und zum Überprüfungsverhalten finden Sie unter Lesezugriff mit erhöhten Rechten.
1. Aktivieren Sie die verwaltete Identität von Foundry IQ
Aktivieren Sie eine vom System zugewiesene verwaltete Identität für Ihren Foundry IQ-Dienst. Der Indexer verwendet die eigene Identität des Diensts, um sich mit Microsoft Purview zu authentifizieren und privilegierte EXTRACT Vorgänge auszuführen, einschließlich des Lesens verschlüsselter Inhalte und Sicherheitsklassifizierungen. Weisen Sie dieser Identität in Schritt 3 die erforderlichen Rollen direkt zu.
2. Aktivieren Sie RBAC auf Ihrem Foundry IQ-Dienst
Aktivieren Sie die rollenbasierte Zugriffssteuerung (RBAC) für Ihren Foundry IQ-Dienst. Purview-fähige Indizes erfordern die RBAC-Authentifizierung für Dokumentvorgänge, einschließlich der Indizierung von Inhalten und des Ausführens von Abfragen. Lassen Sie sowohl RBAC- als auch API-Schlüssel aktiviert, wenn andere Dienstvorgänge auf API-Schlüssel angewiesen sind. Diese Konfiguration lässt keine API-schlüssel-Dokumentvorgänge für Purview-fähige Indizes zu.
3. Zugriff gewähren, um Vertraulichkeitskennzeichnungen zu extrahieren
Der Zugriff auf Microsoft Purview Metadaten von Vertraulichkeitsbezeichnungen umfasst Vorgänge mit hohen Rechten. Binden Sie Ihre Sicherheits- oder Complianceteams ein, und erhalten Sie die Genehmigung über den Governanceprozess Ihrer Organisation, bevor Sie Berechtigungen zuweisen.
Ziehen Sie nach der Genehmigung einen Global Administrator oder einen Privileged Role Administrator hinzu, um diese Rollen der vom Foundry IQ system zugewiesenen verwalteten Identität zuzuweisen:
- Content.SuperUser für Bezeichnungs- und Inhaltsextraktion.
- UnifiedPolicy.Tenant.Read für den Zugriff auf Purview-Richtlinien- und Bezeichnungsmetadaten.
Rollen mithilfe von PowerShell zuweisen
Weisen Sie diese Rollen nur der vom System zugewiesenen verwalteten Identität des Foundry IQ-Diensts zu, nicht einer vom Benutzer zugewiesenen verwalteten Identität, einem separaten Anwendungsdienstprinzipal oder einem einzelnen Benutzerkonto. Das PowerShell-Skript ruft die ID des verwalteten Identitätsobjekts automatisch aus der Dienstressource ab.
Ihr globaler Administrator oder Der Administrator mit privilegierter Rolle sollte das folgende PowerShell-Skript verwenden, um die erforderlichen Berechtigungen zu erteilen. Rufen Sie die Administratorzustimmung für die delegierten Microsoft Graph-Bereiche AppRoleAssignment.ReadWrite.All und Application.Read.All über Ihren genehmigten Governanceprozess ab. Eine Mandantenadministratorrolle allein stellt diese Tokenbereiche nicht zur Verfügung.
Nachdem Sie die im folgenden Abschnitt gezeigten Module installiert haben, richten Sie einen separaten authentifizierten Azure PowerShell Kontext in derselben PowerShell-Sitzung ein, bevor Sie die verbleibenden Befehle ausführen. Verwenden Sie Connect-AzAccount , um sich beim Mandanten des Foundry IQ-Diensts anzumelden, und Set-AzContext , um den richtigen Mandanten und das richtige Abonnement auszuwählen. Das Azure Konto muss über die Berechtigung zum Lesen der Findry IQ-Dienstressource verfügen, z. B. die Rolle "Leser".
Connect-Entra legt diesen Az-Kontext nicht fest.
Ersetzen Sie die Platzhalter durch Ihre tatsächliche Mandanten-ID, Abonnement-ID, Ressourcengruppe und den Namen des Foundry IQ-Diensts.
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"
Referenz: Connect-Entra, Get-AzResource, Get-EntraServicePrincipal, New-EntraServicePrincipalAppRoleAssignment und Microsoft Graph Berechtigungen für die App-Rollenzuweisung.
Das Skript weist anwendungsrollen für die folgenden Ressourcendienstprinzipale der verwalteten Identität des Foundry IQ-Diensts zu:
| App-Kennung | Dienstprinzipal der Ressource |
|---|---|
870c4f2e-85b6-4d43-bdda-6ed9a579b725 |
Microsoft Info Protection-Synchronisierungsdienst |
00000012-0000-0000-c000-000000000000 |
Microsoft-Rechteverwaltungsdienste |
4. Konfigurieren des Indexes zum Aktivieren der Purview-Vertraulichkeitsbezeichnung
Verwenden Sie die REST-API-Version 2026-11-01-preview für die Konfigurationsänderungen in den folgenden Schritten.
Wichtig
Die purviewEnabled Eigenschaft muss auf true festgelegt werden, wenn der Index erstellt wird. Diese Einstellung ist dauerhaft und kann später nicht geändert werden.
Wenn Ihr vorhandener Index purviewEnabled: true nicht enthält, erstellen Sie einen neuen Purview-fähigen Index und leiten Sie den Indexer und alle Projektionsselektoren an diesen weiter. Sie können diese Eigenschaft nicht für einen vorhandenen Index aktivieren.
Bei einem purview-aktivierten Index wird nur die RBAC-Authentifizierung für alle Dokumentvorgänge-APIs unterstützt. Der API-Schlüsselzugriff ist auf den Indexschemaabruf (Liste und Abrufen) beschränkt.
Bei allen unterstützten Datenquellen für Vertraulichkeitsbezeichnungen enthält metadata_sensitivity_label eine Bezeichnungs-ID als GUID-Zeichenfolge. Definieren Sie das Zielindexfeld als Edm.String, keine Auflistung. Der Wert kann nicht vorhanden oder null sein, wenn ein Dokument nicht beschriftet ist oder die Beschriftungsextraktion absichtlich übersprungen wird.
Fügen Sie diese drei Zeichenfolgenfelder zum Zielindex hinzu. Wenn Chunks Ihre durchsuchbaren Dokumente sind, fügen Sie die Felder zum Chunk-Index hinzu.
| Quellmetadatenfeld | Zielindexfeld | Typ und Anmerkung |
|---|---|---|
metadata_sensitivity_label |
sensitivity_label_id |
Edm.String GUID; sensitivityLabelId: true, retrievable: true, filterable: true. |
metadata_sensitivity_label_name |
sensitivity_label_name |
Edm.String Bezeichnername; sensitivityLabelName: true, retrievable: true. |
metadata_source_document_id |
source_document_id |
Edm.String Prüfbezeichner; sourceDocumentId: true, retrievable: true. |
Das source_document_id Feld identifiziert das Quelldokument für das Audit. Es handelt sich nicht um den Suchindexschlüssel oder den übergeordneten Projektionsschlüssel.
Warnung
Die folgenden JSON-Fragmente sind Konfigurationsdeltas, keine vollständigen PUT-Request-Bodies. Integrieren Sie sie in Ihre vollständigen Ressourcendefinitionen, bevor Sie Anfragen senden. Eine create-or-update-PUT-Anfrage ersetzt die Ressourcendefinition. Vorhandene Felder und Arrays, Zuordnungen, Optionen, Selektoren, Anmeldeinformationen und andere Konfigurationen beibehalten; ersetzen Sie keine vollständige Definition oder ein Array durch ein Fragment.
Indexerstellungseigenschaft: Fügen Sie diese Eigenschaft in die vollständige Erstellungsdefinition eines neuen Indexes ein. Wenn der vorhandene Index es bereits enthält, behalten Sie ihn unverändert bei.
{
"purviewEnabled": true
}
Hinzufügungen von Indexfeldern: Fügen Sie diese Objekte an das Array der vollständigen Indexdefinition fields an, wobei das vorhandene Schema und das Indizierungslayout beibehalten werden.
[
{
"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
}
]
Referenz: Indexdefinition.
Folgen Sie Schritt 7 für Zuordnungen auf Dokumentebene. Befolgen Sie für untergeordnete Blöcke Schritt 6.
5. Konfigurieren der Datenquelle
Datenquellenoption delta: Fügen Sie sensitivityLabel in Ihrer konfigurierten Datenquelle zu indexerPermissionOptions hinzu. Wenn andere Berechtigungsoptionen bereits aktiviert sind, behalten Sie sie bei, und fügen Sie diese Option hinzu, anstatt das Array zu ersetzen.
{
"indexerPermissionOptions": ["sensitivityLabel"]
}
Referenz: Datenquellendefinition.
Mit dieser Option wird die Bezeichnungsextraktion aktiviert. Dies unterscheidet sich von den Anmerkungen sensitivityLabelId, sensitivityLabelName und sourceDocumentId der Indexfelder. Behalten Sie die vorhandenen Anmeldeinformationen, die vorhandene Containerauswahl und die anderen Einstellungen des Connectors bei.
6. Konfigurieren von Indexprojektionen in Ihrem Skillset (falls zutreffend)
Wenn Ihre Pipeline Blöcke indiziert, erweitern Sie den vorhandenen Selektor für die Indexprojektion. Wenden Sie die Feldzufügungen und die Purview-fähige Indexanforderung von Schritt 4 auf den Blockindex an.
Ergänzungen zur Projektionszuordnung: Fügen Sie diese Einträge an das mappings-Array des relevanten Selektors innerhalb von indexProjections.selectors an. Diese Ergänzungen sind kein vollständiger Selektor oder Skillset.
[
{
"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"
}
]
Referenz: Skillset-Definition.
Behalten Sie den Selektor targetIndexName, parentKeyFieldName und den Block sourceContext bei, mit Ausnahme der Neuausrichtung eines neuen Indexes bei Bedarf. Behalten Sie andere Selektoren, Inhalte und Vektorzuordnungen sowie den vorhandenen Projektionsmodus bei. Alle untergeordneten Nicht-Schlüsselfelder explizit zuordnen; die oben genannten drei Ergänzungen sind nicht der vollständige Zuordnungssatz.
Diese Pfade auf Root-Ebene kopieren die zugeordneten Zeichenfolgenwerte, die für das übergeordnete Element verfügbar sind, auf jeden Chunk. Projektionen generieren den untergeordneten Schlüssel und die übergeordnete Zuordnung für die Änderungsnachverfolgung. Ordnen Sie generierte Schlüssel wie chunk_id oder parent_id in Projektionen oder das fieldMappings des Block-Indexers nicht manuell zu.
Wenn Ihre Textaufteilungs-Funktion Rohzeichenfolgen unter chunks ausgibt, verwenden Sie /document/chunks/* für die Auswahl-Zuordnung sourceContext und die Inhaltszuordnung, keinen untergeordneten /id- oder /text-Pfad.
Mit skipIndexingParentDocuments befüllt der direkte Indexer fieldMappings untergeordnete Dokumente nicht. Die Bezeichnungs-ID-Projektion ist erforderlich, um Abfrageerzwingung auf Blockebene und zugehörige Metadaten der Label-Antwort zu erzwingen. Informationen zur Antwortbehandlung finden Sie unter Überprüfen von Metadaten für Vertraulichkeitsbezeichnungen in der Antwort.
Verwenden Sie für ein Parent-Child-Layout mit zwei Indizes die direkten Zuordnungen in Schritt 7, um den übergeordneten Index aufzufüllen, und diese Projektionen, um den untergeordneten Index aufzufüllen. Informationen zur Zuordnungssemantik finden Sie unter Feldzuordnungen überprüfen.
7. Konfigurieren des Indexers
Fügen Sie ihrem vorhandenen Indexer für ein Suchdokument pro Quelldokument direkte Metadatenzuordnungen hinzu. Verwenden Sie Roh-Quellfeldnamen ohne /document/ Präfix.
Ergänzungen zur direkten Feldzuordnung: Fügen Sie diese Einträge an das Array des fieldMappings Indexers an. Bewahren Sie die Konnektorschlüsselzuordnung, andere Zuordnungen, Datenquellen- und Skillsetverknüpfung, Zielindex und Konfiguration auf, mit Ausnahme der Neuzuordnung eines neuen Indexes bei Bedarf.
[
{
"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"
}
]
Referenz: Definition des Indexers.
Halten Sie für Chunks den vorhandenen Indexer in Verbindung mit seinem Skillset; die Selektorzuordnungen in Schritt 6 füllen die Metadaten der untergeordneten Elemente.
Einlesen der Beschriftung überprüfen
Führen Sie nach dem Zusammenführen der Änderungen in die vollständigen Ressourcendefinitionen ein initiales Backfill durch, wenn der vorhandene Indexer die Quelldateien bereits verarbeitet hat. Das Aktivieren der Extraktion, das Hinzufügen von Metadatenfeldern oder das Umstellen der Pipeline macht unveränderte Dateien nicht für einen normalen inkrementellen Lauf geeignet. Um diese Dateien erneut zu verarbeiten, setzen Sie den Indexer zurück und führen Sie ihn dann aus. Das Zurücksetzen löscht die Änderungsnachverfolgung und die anschließende Ausführung verarbeitet alle Quelldokumente erneut; berücksichtigen Sie diese Arbeitsauslastung.
Wenn die Dateien noch nicht indiziert sind, führen Sie den Indexer ohne Zurücksetzung aus. Verwenden Sie Indexerstatus abrufen, um zu bestätigen, dass die Ausführung erfolgreich abgeschlossen wurde, und überprüfen Sie Dokumentfehler und Warnungen. Eine akzeptierte Anforderung zur Ausführung ist kein Nachweis für die abgeschlossene Datenaufnahme.
Überprüfen Sie mithilfe einer autorisierten Abfrageidentität und des Abfrageleitfadens ein bekanntes beschriftetes Dokument und die zugehörigen Blöcke:
- Eine beschriftete Datei aus einer beliebigen unterstützten Quelle füllt
sensitivity_label_idmit einer GUID-Zeichenfolge. Überprüfen Sie für eine klassifizierte Datei in einer SharePoint-Dokumentbibliothek (Laufwerk) auch den Namen der Bezeichnung und die Überwachungs-ID des Quelldokuments in den Begleitfeldern. Überprüfen Sie für andere Quellen Begleitwerte, sofern diese Quellmetadaten für die jeweilige Quelle verfügbar sind. - Ein nicht bezeichnetes Dokument oder ein Dokument mit absichtlich übersprungener Beschriftungs-Extraktion weist eine fehlende oder NULL-Label-ID auf.
- Jeder untergeordnete Abschnitt erbt die zugeordneten Metadatenwerte, die für das übergeordnete Element verfügbar sind, und die generierten untergeordneten und übergeordneten Schlüssel bleiben erhalten.
Wenn erwartete Metadaten fehlen, überprüfen Sie die Ausführungsfehler und -warnungen, die Extraktionsoption der Datenquelle in Schritt 5 und die direkten oder Projektionszuordnungen in Schritt 6 und 7. Vergewissern Sie sich, dass der Abgleich die bekannte Datei verarbeitet hat.
Führen Sie bei späterer inkrementeller Aktualisierung den Indexer aus, um erkannte Quelländerungen zu verarbeiten; setzen Sie ihn nicht für jede Bezeichnungsaktualisierung zurück. Änderungen der Quellbezeichnung werden im Index erst angezeigt, wenn sie von einem erfolgreichen Indexerlauf verarbeitet werden. Zur wiederkehrenden Aktualisierung siehe Einen Indexer planen.