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.
Foundry IQ (Azure KI-Suche) erfasst Containerressourcenbereiche aus Azure Blob Storage und filtert Abfrageergebnisse durch die unterstützte Blob-Read-Autorisierung des delegierten Benutzers. Container-RBAC-Bereichsaufnahme und Abfragezeitfilterung sind in der Regel in DER REST-API 2026-10-01 verfügbar.
Verwenden Sie eine Blob-Indexer - oder Blob-Wissensquelle. Die Standardmäßige BLOB-Erfassung wertet keine ADLS-Datei oder Verzeichnis-ACLs aus. Verwenden Sie für diese Berechtigungen die ADLS Gen2-Konfiguration.
Der RBAC-Bereich wird auf Containerebene festgelegt und über die Berechtigungsvererbung an alle Blobs (Dokumente) weitergeleitet. RBAC-Bereich wird während der Indizierung als Berechtigungsmetadaten erfasst. Sie können die Push-APIs verwenden, um Inhalte und Berechtigungsmetadaten manuell hochzuladen und indizieren (siehe Indizierungsberechtigungen mithilfe der Push-REST-API), oder Sie können einen Indexer oder eine Wissensquelle verwenden, um die Datenaufnahme zu automatisieren. Dieser Artikel konzentriert sich auf die Indizierungsautomatisierung.
Der gespeicherte Bereich identifiziert den Container; es handelt sich nicht um eine kopierte Liste von Rollenzuweisungen oder Sicherheitsprinzipalen.
x-ms-query-source-authorization überträgt zur Abfragezeit das Token des delegierten Benutzers. Foundry IQ wertet die Autorisierung des Benutzers für die gespeicherten Berechtigungsbereiche getrennt von der Suchdatenebenenautorisierung der Anwendung aus.
Dieser Artikel konzentriert sich auf die Indizierungsautomatisierungsansätze, die auf dieser Grundlage basieren:
Azure Storage blobs, die mithilfe der rollenbasierten Zugriffssteuerung (Azure RBAC) gesichert sind. Es gibt keine Unterstützung für die attributbasierte Zugriffssteuerung (Azure ABAC).
Azure Blob-Indexer oder eine Blob-Wissensquelle, die Daten und Metadaten abruft und aufnimmt, einschließlich Berechtigungsfiltern. Verwenden Sie die REST-API
2026-10-01, oder überprüfen Sie die entsprechende SDK-Unterstützung im Paketänderungsprotokoll.Ein Index in Foundry IQ , der die aufgenommenen Dokumente und die entsprechenden Berechtigungen enthält. Berechtigungsmetadaten werden als Felder im Index gespeichert.
Eine Abfrage, die Berechtigungsfilter verwendet mit der REST-API
2026-10-01oder einem SDK, das diese API unterstützt.
Voraussetzungen
Microsoft Entra ID Authentifizierung und Autorisierung. Dienste und Apps müssen sich im selben Mandanten befinden. Benutzende können sich in verschiedenen Mandanten befinden, solange es sich bei allen um Microsoft Entra ID-Mandanten handelt. Rollenzuweisungen werden für jede authentifizierte Verbindung verwendet.
Foundry IQ, jede Region, aber Sie müssen eine abrechnende Ebene (einfach und höher) für die Unterstützung verwalteter Identitäten haben. Der Foundry IQ-Dienst muss für den rollenbasierten Zugriff konfiguriert sein und muss über eine verwaltete Identität (entweder System oder Benutzer) verfügen.
Azure Storage, Standardleistung (general-purpose v2), in den Zugriffsebenen Heiß, Kühl und Kalt mit Container-RBAC-Zugriff.
Sie sollten verstehen, wie Indexer und Wissensquellen funktionieren und wie Sie einen Index erstellen. In diesem Artikel werden die Konfigurationseinstellungen für die Datenquelle und den Indexer erläutert, jedoch keine Schritte zum Erstellen des Indexes bereitgestellt. Weitere Informationen zu Indizes, die für Berechtigungsfilter entwickelt wurden, finden Sie unter Erstellen eines Indexes mit Berechtigungsfilterfeldern.
Einschränkungen
Verwenden Sie standardmäßige oder standardmäßige Dokumentanalyse (
parameters.configuration.parsingMode: "default") oder Inhaltsverständnis-basierte Extraktion, sofern unterstützt. Jeder generierte Block muss die erforderlichen Berechtigungsmetadaten und den Quellkontext beibehalten. Spezialisierte vom Kunden ausgewählte Analysemodi werden nicht unterstützt. Siehe Unterstütztes Parsen und Inhaltsextraktion für die Berechtigungsingestion für die ausgeschlossenen Modi und Wissensquelleneinstellungen.Dieses Feature wird vom Azure-Portal nicht unterstützt.
Die folgenden Indexerfeatures sind nicht mit der Berechtigungsaufnahme von Blob Storage kompatibel:
Konfigurieren von Blob Storage
Überprüfen Sie, ob Ihr BLOB-Container rollenbasierten Zugriff verwendet.
Melden Sie sich beim Azure-Portal an, und suchen Sie Ihr Speicherkonto.
Erweitern Sie Container , und wählen Sie den Container mit den Blobs aus, die Sie indizieren möchten.
Wählen Sie Access Control (IAM) aus, um Rollenzuweisungen zu überprüfen. Benutzer und Gruppen mit Storage Blob Data Reader oder Storage Blob Data Contributor haben Zugriff auf Suchdokumente im Index, nachdem der Container indiziert wurde.
Autorisierung
Für die Indizierungsausführung muss ihre Findry IQ-Dienstidentität über die Berechtigung " Storage Blob Data Reader " verfügen. Weitere Informationen finden Sie unter Connect to Azure Storage using a managed identity.
Konfigurieren von Foundry IQ
Erinnern Sie sich daran, dass der Foundry IQ-Dienst Folgendes haben muss:
Autorisierung
Für die Ausführung von Indizierungen muss der Client, der den API-Aufruf ausführt, die Berechtigung als Beitragender für Suchdienste zum Erstellen von Objekten, die Berechtigung als Beitragender für Suchindexdaten zum Importieren von Daten und die Berechtigung als Leser von Suchindexdaten zum Abfragen eines Indexes haben. Siehe Connect to Foundry IQ using roles.
Konfigurieren einer Wissensquelle
Wenn Sie eine Wissensquelle verwenden, werden Definitionen in der Wissensquelle verwendet, um eine vollständige Indizierungspipeline (Indexer, Datenquelle und Index) zu generieren. Der RBAC-Bereich wird erkannt und automatisch im generierten Index enthalten. Es ist nicht erforderlich, eines der generierten Objekte zu ändern, wenn Sie die Berechtigungsvererbung in Ihrem indizierten Inhalt wünschen.
Wichtige Punkte zu der Konfiguration, die für dieses Szenario geeignet ist:
-
isADLSGen2ist auf „false“ festgelegt, das bedeutet, dass die Datenquelle Azure Blob Storage ist. -
ingestionPermissionOptionsgibt anrbacScope.
# Create / Update Azure Blob Knowledge Source
###
PUT {{url}}/knowledgesources/azure-blob-ks?api-version=2026-10-01
api-key: {{key}}
Content-Type: application/json
{
"name": "azure-blob-ks",
"kind": "azureBlob",
"description": "A sample azure blob knowledge source",
"azureBlobParameters": {
"connectionString": "{{blob-connection-string}}",
"containerName": "blobcontainer",
"folderPath": null,
"isADLSGen2": false,
"ingestionParameters": {
"identity": null,
"embeddingModel": {
"kind": "azureOpenAI",
"azureOpenAIParameters": {
"deploymentId": "{{embedding-deployment}}",
"modelName": "{{embedding-model}}",
"resourceUri": "{{aoai-endpoint}}",
"apiKey": "{{aoai-key}}"
}
},
"chatCompletionModel": null,
"disableImageVerbalization": true,
"ingestionSchedule": null,
"ingestionPermissionOptions": ["rbacScope"],
"contentExtractionMode": "minimal",
"aiServices": {
"uri": "{{ai-endpoint}}",
"apiKey": "{{ai-key}}"
}
}
}
}
Referenz:Erstellen oder Aktualisieren der Wissensquelle (REST API)
Indexbasierte Indizierung konfigurieren
Wenn Sie einen Indexer verwenden, konfigurieren Sie ihn, die Datenquelle und den Index, um Berechtigungsmetadaten aus Blobs abzurufen.
Erstellen der Datenquelle
Der Datenquellentyp muss sein
azureblob.Verwenden Sie den Standardanalysemodus in der Indexerkonfiguration.
Die Datenquelle muss
indexerPermissionOptionsmitrbacScope.Konfigurieren Sie für
rbacScopedie Verbindungszeichenfolge mit dem verwalteten Identitätsformat.Für Verbindungszeichenfolgen mit einer vom Benutzer zugewiesenen verwalteten Identität müssen Sie auch die
identityEigenschaft angeben.
JSON-Beispiel mit vom System verwalteter Identität und indexerPermissionOptions:
{
"name" : "my-blob-datasource",
"type": "azureblob",
"indexerPermissionOptions": ["rbacScope"],
"credentials": {
"connectionString": "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.Storage/storageAccounts/<your storage account name>/;"
},
"container": {
"name": "<your-container-name>",
"query": "<optional-query-used-for-selecting-specific-blobs>"
}
}
JSON-Schemabeispiel mit einer vom Benutzer verwalteten Identität im Verbindungszeichenfolge:
{
"name" : "my-blob-datasource",
"type": "azureblob",
"indexerPermissionOptions": ["rbacScope"],
"credentials": {
"connectionString": "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.Storage/storageAccounts/<your storage account name>/;"
},
"container": {
"name": "<your-container-name>",
"query": "<optional-query-used-for-selecting-specific-blobs>"
},
"identity": {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity": "/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}"
}
}
Erstellen von Berechtigungsfeldern im Index
Stellen Sie in Foundry IQ sicher, dass Ihr Index Felddefinitionen für die Berechtigungsmetadaten enthält. Berechtigungsmetadaten können indiziert werden, wenn indexerPermissionOptions in der Datenquellendefinition angegeben ist.
Für einen direkten Standard-Blob-RBAC-Indexer benötigen Sie metadata_storage_path nicht, um den Containerbereich zu berechnen. Diese Anforderung unterscheidet sich von der ADLS Gen2-Berechtigungsaufnahme, die das Feld auch für die RBAC-nur-Aufnahme erfordert. Generierte Blob-Wissensquellpipelinen enthalten weiterhin den Quellpfad für ihr Schema und den Quellkontext. Siehe die Quellmetadatenmatrix.
Verwenden Sie die folgenden Attribute für den RBAC-Bereich:
- RBAC-Bereichsfeld mit
rbacScopepermissionFilter-Wert. - Eigenschaft
permissionFilterOptionzum Aktivieren der Filterung zur Abfragezeit. - Verwenden von Zeichenfolgenfeldern für Berechtigungsmetadaten
- Setzen Sie
filterableauf 'true' für alle Felder.
Beachten Sie, dass retrievable "false" lautet. Sie können sie während der Entwicklung auf "true" festlegen, um zu überprüfen, ob Berechtigungen vorhanden sind, aber denken Sie daran, sie vor der Bereitstellung in einer Produktionsumgebung auf "false" zurückzustellen, damit Sicherheitsprinzipalidentitäten in Ergebnissen nicht sichtbar sind.
JSON-Schemabeispiel:
{
"name": "my-blob-rbac-index",
"fields": [
{ "name": "id", "type": "Edm.String", "key": true },
{
"name": "RbacScope",
"type": "Edm.String",
"permissionFilter": "rbacScope",
"filterable": true,
"retrievable": false
}
],
"permissionFilterOption": "enabled"
}
Konfigurieren des Indexers
Feldzuweisungen in einem Indexer definieren den Datenpfad zu Feldern in einem Index. Ziel- und Zielfelder, die je nach Name oder Datentyp variieren, erfordern eine explizite Feldzuordnung. Die folgenden Metadatenfelder in Azure Blob Storage benötigen möglicherweise Feldzuordnungen, wenn Sie den Feldnamen variieren:
-
metadata_rbac_scope (
Edm.String) – der Container-RBAC-Bereich.
Geben Sie fieldMappings im Indexer an, um die Berechtigungsmetadaten während der Indizierung an Zielfelder weiterzuleiten.
Verwenden Sie den für diesen unterstützten Aufnahmefluss abgeleiteten metadata_rbac_scope Connector, und überprüfen Sie, wie der Containerbereich dem endgültigen Schlüssel und Inhalt des Dokuments zugeordnet bleibt. Behandeln Sie keinen ähnlich benannten Wert aus gewöhnlichen Inhalten oder benutzerdefinierten Metadaten als Grundlage für die Gewährung von Zugriff. Die permissionFilter Anmerkung gibt an, wie ein gespeicherter Wert ausgewertet wird; es handelt sich nicht um eine Dokumentbesitzprüfung.
Überprüfen Sie, wer Quellinhalte schreiben kann und wer Schlüssel, Zuordnungen und Berechtigungswerte ändern kann. Befolgen Sie die Blob-Identitäts- und Berechtigungs-Checkliste, einschließlich impliziter Schlüsselzuordnungen und projizierter untergeordneter Elemente. Behalten Sie den standardmäßigen Analysemodus bei, der für diesen Ablauf erforderlich ist; JSON-Analysebeispiele belegen keine Unterstützung für die native Erfassung von Blob-Berechtigungen.
JSON-Schemabeispiel:
{
"fieldMappings": [
{ "sourceFieldName": "metadata_rbac_scope", "targetFieldName": "RbacScope" }
]
}
Ausführen des Indexers
Nachdem Sie den Indexer, die Datenquelle und den Index konfiguriert haben, führen Sie den Indexer aus, um den Prozess in Gang zu setzen. Wenn ein Problem mit der Konfiguration oder berechtigungen vorliegt, werden diese Probleme in diesem Schritt angezeigt.
Standardmäßig wird ein Indexer ausgeführt, sobald Sie ihn in einem Foundry IQ-Dienst bereitstellen, aber wenn die Indexerkonfiguration auf "true" festgelegt ist disabled , wird der Indexer in einem deaktivierten Zustand gepostet, sodass Sie den Indexer manuell ausführen können.
Wir empfehlen Ausführung des Indexers aus dem Azure Portal, sodass Sie Status und Nachrichten überwachen können.
Wenn keine Fehler auftreten, wird der Index jetzt ausgefüllt, und Sie können mit Abfragen und Tests fortfahren.
Halten Sie Bereiche und Autorisierung auf dem aktuellen Stand
Änderungen an Speicherrollenzuweisungen wirken sich auf die Autorisierung zur Abfragezeit aus, nicht auf die indizierte Containerressourcen-ID. Speicherautorisierung und anwendbare Caches nach einer Erteilung oder Entfernung zulassen. Erneute Indizierung oder ACL-Neusynchronisierung erzwingen keine Aktualisierung der Autorisierungscaches.
refreshAllAcls gilt für die Erfassung von ADLS-ACLs, nicht für die standardmäßige Erfassung von Blob-RBAC.
Wenn Sie Indexprojektionen verwenden, ordnen Sie /document/metadata_rbac_scope bei jedem geschützten Chunk direkt dem mit rbacScope annotierten Feld zu. Behalten Sie generierte Quellpfadzuordnungen bei, wenn Sie eine Wissensquelle verwenden. Durch korrigieren eines Schemas oder einer Zuordnung werden vorhandene Datensätze nicht aufgefüllt. Betroffene Inhalte nach der Korrektur der Pipeline erneut verarbeiten.
Testen Sie einen zulässigen Benutzer und einen Benutzer ohne unterstützte Container-Berechtigung, und testen Sie dann das Entfernen der Berechtigung getrennt von indizierenden Änderungen. Suchen Sie nach anderen unterstützten Berechtigungen, bevor Sie ein unerwartetes Ergebnis interpretieren. Informationen zu freigegebenen Aktualitäts- und Bereinigungsaspekten finden Sie unter "Synchronisieren von Berechtigungen".
Nachverfolgung von Löschungen
Um blob-Löschung effektiv zu verwalten, stellen Sie sicher, dass Sie die Löschnachverfolgung aktiviert haben, bevor der Indexer zum ersten Mal ausgeführt wird. Mit diesem Feature kann das System gelöschte Blobs aus Ihrer Quelle erkennen und den entsprechenden Inhalt aus dem Index löschen.