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.
Als unabhängiger Softwareanbieter (ISV), der mehrinstanzenfähige SaaS-Anwendungen entwickelt, können Sie Ihren Kunden Vertrauen in den Datenschutz geben, indem Sie ihnen die Kontrolle über ihre Verschlüsselungsschlüssel geben. Sie hosten Foundry IQ (Azure KI-Suche) in Ihrem Microsoft Entra Mandanten, während Ihr Kunde seinen Schlüssel in Azure Key Vault in ihrem eigenen Mandanten verwaltet. Sie können den Schlüsselzugriff widerrufen, um den Zugriff auf verschlüsselte Daten zu blockieren. Verwenden Sie eine mehrinstanzenfähige Microsoft Entra Anwendung, um die CMK-Verschlüsselung (Customer-Managed Key) für diese Mandanten zu ermöglichen, ohne Ihren Benutzerkonten direkten Zugriff auf den Schlüssel zu gewähren.
Voraussetzungen
Mandant A: Ein Mandant und die erforderlichen Berechtigungen zum Erstellen des Foundry IQ-Diensts und zugeordneter Objekte (Indizes, Synonymlisten, Indexer, Datenquellen, Vektorisierer, Skillsets). Die Unterstützung kundenseitig verwalteter Schlüssel (CMK) erfordert die Basic-Preisstufe oder höher.
Konfigurieren Sie den Foundry IQ-Dienst für den rollenbasierten Zugriff (empfohlen für erhöhte Sicherheit, nicht erforderlich).
Mandant B: Ein separater Kundenmandant mit einem Azure Key Vault und den erforderlichen Berechtigungen für diesen Mandanten:
- Key Vault-Mitwirkender: Diese Rolle ist erforderlich, wenn Sie einen neuen Key Vault erstellen müssen.
- Anwendungsadministrator oder Cloudanwendungsadministrator: Verwenden Sie eine der beiden Rollen, um einen Dienstprinzipal für die mehrinstanzenfähige Anwendung in Mandanten B zu erstellen.
- Key Vault Crypto Officer: Diese Rolle ist erforderlich, um dem key vault einen neuen Schlüssel hinzuzufügen.
-
Key Vault Crypto Service Encryption User: Diese Rolle muss dem Dienstprinzipal zugewiesen werden, der für die installierte mehrinstanzenfähige Anwendung erstellt wurde, um dem Dienstprinzipal Zugriff auf den vom Kunden verwalteten Schlüssel im key vault zu gewähren. Verwenden Sie Key Vault Datenzugriffsadministrator, um diese Rolle zuzuweisen. Informationen zu den Anforderungen für Rollenzuweisungen finden Sie unter Gewähren Sie Anwendungen mithilfe von Azure RBAC Zugriff auf einen Key Vault. Hier können Sie die Dienstprinzipal-GUID (auch als Objekt-ID bezeichnet) anzeigen:
Enterprise applications\<installed multitenant application>\Manage\Properties\Object ID.
Die Azure Key Vault muss auch für rollenbasierten Zugriff konfiguriert sein.
Azure CLI zum Senden von Anfragen.
Auswählen eines Authentifizierungsansatzes
Sie können eine mehrinstanzenfähige Microsoft Entra Anwendung so konfigurieren, dass kundenverwaltete Schlüssel in einem mandantenübergreifenden Szenario verwendet werden, indem Sie einen der folgenden Ansätze verwenden:
Unterstützung der Verbundidentität (empfohlen): Konfigurieren Sie Microsoft Entra Verbundidentitätsanmeldeinformationen (FIC) mit einer vom Benutzer zugewiesenen verwalteten Identität (UAMI). Dieser Ansatz verwendet Tokens für verwaltete Identitäten und tauscht sie gegen Zugriffstoken aus, wodurch langlebige Geheimnisse überflüssig werden und er im Einklang mit den Prinzipien der Workload Identity Federation steht. Dieser Ansatz erfordert die
federatedIdentityClientIdEigenschaft, die ab der Datenebenen-API-Version2026-10-01allgemein verfügbar ist.Geheime Clientschlüssel: Konfigurieren Sie einen geheimen Clientschlüssel mithilfe der
accessCredentialsEigenschaft. Dieser Ansatz ist weniger sicher und erfordert zusätzlichen Verwaltungsaufwand, um das Geheimnis zu rotieren und zu schützen.
Informationen zur Azure Key Vault Managed HSM-Konfiguration finden Sie unter Vom Kunden verwaltete Schlüssel für verschlüsselte Foundry IQ-Daten konfigurieren.
Erstellen einer mehrinstanzenfähigen Microsoft Entra-Anwendung in Mandant A
Verwenden Sie die Azure CLI, um Anforderungen zu senden. Der Mandant des Dienstanbieters, der Foundry IQ enthält, wird als Mandant A bezeichnet.
Abrufen der Mandanten-ID:
az account show --query tenantId --output tsvStellen Sie sicher, dass Sie bei Mandant A angemeldet sind:
az login --tenant <tenant-A-id>Erstellen Sie die Anwendungsregistrierung:
az ad app create --display-name cross-tenant-auth --sign-in-audience AzureADMultipleOrgsSpeichern Sie die App-ID-Ausgabe aus diesem Schritt.
Unterstützung für Verbundidentitäten verwenden
So verwenden Sie eine Verbundidentität zur Unterstützung eines mandantenübergreifenden CMK-Szenarios:
Der Dienstanbieter konfiguriert den Foundry IQ-Dienst in ihrem Mandanten (Mandant A). Anleitungen dazu finden Sie unter Erstellen eines Foundry IQ-Diensts (im Azure-Portal) oder verwenden Sie den az search service create-Befehl in Azure CLI.
Der Dienstanbieter verwendet die mehrinstanzenfähige Microsoft Entra App-Registrierung, die in Mandanten A erstellt wurde. Notieren Sie die Anwendungs-ID (Client-ID).
Der Dienstanbieter richtet eine vom Benutzer zugewiesene verwaltete Identität ein und weist sie dem Foundry IQ-Dienst zu. Anleitungen dazu finden Sie unter Erstellen einer vom Benutzer zugewiesenen verwalteten Identität.
Der Dienstanbieter konfiguriert die benutzerseitig zugewiesene verwaltete Identität in der App als Verbundidentitätsanmeldeinformation. Anleitungen dazu finden Sie unter Konfigurieren einer Anwendung, um einer verwalteten Identität zu vertrauen.
Sobald der Dienstanbieter die App-ID für mehrere Mandanten mitteilt, gewährt der Kunde der App des Dienstanbieters Zugriff auf den Schlüsseltresor in seinem Mandanten (Mandant B). Um die App für Mandant B zu installieren, muss ein Dienstprinzipal mit der mehrinstanzenfähigen App-ID erstellt werden. Um den Dienstprinzipal zu erstellen, erstellen Sie eine URL für die Administratoreinwilligung und erteilen Sie die mandantenweite Administratoreinwilligung, oder verwenden Sie den Befehl az ad sp in der Azure CLI.
Wenn der Kunde noch nicht über einen Schlüsseltresor verfügt, lesen Sie Schnellstart: Erstellen eines Azure-Schlüsseltresors mit dem Azure-Portal oder Schnellstart: Erstellen eines Azure-Schlüsseltresors mit der Azure CLI. Für den Key Vault muss das Berechtigungsmodell auf „rollenbasierte Zugriffssteuerung in Azure (RBAC)“ festgelegt werden, wobei der mandantenfähigen Anwendung des Dienstanbieters durch Zuweisung der Rolle „Key Vault Crypto Service Encryption User“ die erforderliche Berechtigung erteilt wird. Der Kunde kann dann einen Verschlüsselungsschlüssel erstellen. Anleitungen hierzu finden Sie unter Erteilen von Berechtigungen für Anwendungen für den Zugriff auf einen Azure Key Vault mithilfe von Azure RBAC.
Sobald diese Schritte abgeschlossen sind, hat der Dienstanbieter jetzt Folgendes:
Eine Anwendungs-ID für eine mehrmandantenfähige Anwendung, die im Mandanten von Kund*innen installiert ist und der Zugriff auf den vom Kunden verwalteten Schlüssel gewährt wurde.
Eine verwaltete Identität, die als Verbundanmeldeinformation für die mehrinstanzenfähige Anwendung konfiguriert ist.
Den Speicherort des Schlüssels im Schlüsseltresor des Kunden.
Mit diesen drei Parametern kann der Dienstanbieter nun Foundry IQ-Objekte in Mandant A erstellen, die mit dem vom Kunden verwalteten Schlüssel verschlüsselt werden können, der in Mandant B gespeichert ist. Anleitungen zum Konfigurieren von vom Kunden verwalteten Schlüsseln für neue Suchobjekte finden Sie unter Konfigurieren von vom Kunden verwalteten Schlüsseln für verschlüsselte Foundry IQ-Daten.
Überprüfen der mandantenübergreifenden CMK-Konfiguration für die Verbundidentität
Nachdem Sie die mehrinstanzenfähige Microsoft Entra Anwendung konfiguriert und mit der Key Vault des Kunden verbunden haben, überprüfen Sie das Setup, indem Sie ein Testobjekt in Ihrem Foundry IQ-Dienst (Mandant A) erstellen. In diesem Beispiel wird ein Index erstellt, um zu bestätigen, dass der Foundry IQ-Dienst mithilfe der Verbundidentitätsauthentifizierung auf den vom Kunden verwalteten Schlüssel zugreifen kann.
Informationen zum Erstellen eines Foundry IQ-Diensts und eines neuen Indexobjekts mit einem vom Kunden verwalteten Schlüssel finden Sie unter Konfigurieren von vom Kunden verwalteten Schlüsseln .
Bevor Sie den Index erstellen, füllen Sie die folgenden Werte in der
encryptionKeyKonfiguration aus:-
keyVaultUri: Die URI-Adresse des Kunden. -
keyVaultKeyName: Der Schlüsselname des Kunden. -
keyVaultKeyVersion: Die Schlüsselversion des Kunden. -
userAssignedIdentity: Der<subscription-id>und<resource-group>aus Ihrem Mandanten, und der<identity-name>ist der Name der vom Benutzer zugewiesenen verwalteten Identität. -
federatedIdentityClientId: Dieser Eigenschaftswert,<application-client-id>, wird die Multimandantenanwendungs-ID (Client) sein.
{ "name": "cross-tenant-cmk-test", "fields": [ { "name": "id", "type": "Edm.String", "key": true } ], "encryptionKey": { "keyVaultUri": "https://<key-vault-name>.vault.azure.net/", "keyVaultKeyName": "<key-name>", "keyVaultKeyVersion": "<key-version>", "identity": { "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity", "userAssignedIdentity": "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>", "federatedIdentityClientId": "<application-client-id>" } } }-
Überprüfen Sie den Index, indem Sie eine
GETAnforderung senden:GET https://<search-service>.search.windows.net/indexes/cross-tenant-cmk-test?api-version=2026-10-01
Wenn die Anforderung erfolgreich ist, überprüfen Sie, ob encryptionKey die erwartete Schlüssel- und Identitätskonfiguration enthalten ist. Diese Überprüfung bestätigt die gespeicherte Konfiguration, nicht jedoch, dass die Dokumentindizierung und Abfragen funktionieren.
Wenn die Indexerstellung mit einem Schlüsselzugriffsfehler fehlschlägt, überprüfen Sie Folgendes:
- Die vom Benutzer zugewiesene verwaltete Identität ist ordnungsgemäß konfiguriert.
- Der Verbundidentitätsnachweis ist für die App festgelegt.
- Die Key Vault Zugriffsrichtlinie oder RBAC-Rollenzuweisungen sind korrekt.
Verwenden eines geheimen Clientschlüssels (wenn die Verbundidentität keine Option ist)
Wenn die Verbundidentität keine Option ist, können Sie der Mehrinstanzenanwendung einen geheimen Clientschlüssel hinzufügen, um ein mandantenübergreifendes CMK-Szenario zu unterstützen:
Führen Sie den folgenden Befehl aus, um den geheimen Clientschlüssel zur mehrinstanzenfähigen Anwendung in Mandant A hinzuzufügen:
az ad app credential reset --id <multitenant-app-id> --append --end-date <end-date>Der
--appendParameter behält vorhandene Anmeldeinformationen bei.Speichern Sie die Kennwortausgabe aus diesem Schritt. Die Kennwortausgabe ist eine erforderliche Eingabe zum Einrichten von CMK in Foundry IQ.
Geben Sie für
--end-dateein zukünftiges Datum im ISO 8601-Format an, das Ihre Mandantenrichtlinie zulässt. Führen Sie den Befehl zum Zurücksetzen der Anmeldeinformationen nach dem Speichern des Kennworts nicht erneut aus.
Erstellen eines Dienstprinzipals in Mandant B für die mehrinstanzenfähige Anwendung
Wir verweisen auf den Mandanten, der Azure Key Vault enthält, als Mandant B. Erstellen Sie in Mandanten B einen Dienstprinzipal für die mehrinstanzenfähige Anwendung in Mandanten A.
Melden Sie sich bei Mandant B an:
az login --tenant <tenant-B-id>Erstellen Sie den Dienstprinzipal mithilfe der Ausgabe der Mehrinstanzen-App-ID aus dem ersten Schritt:
az ad sp create --id <multitenant-app-id>Der Dienstprinzipal stellt die Anwendung im Mandanten B dar. Wenn Sie die Schlüsseltresorrolle zuweisen, autorisieren Sie diesen Dienstprinzipal, den Schlüssel in Mandant B zu verwenden.
Überprüfen Sie die Verknüpfung zwischen Mandant A und B, indem Sie die "appOwnerOrganizationId" im folgenden Befehl überprüfen:
az ad sp show --id <multitenant-app-id>Mit diesem Befehl werden die Dienstprinzipaldetails in JSON angezeigt. Suchen Sie in der Ausgabe nach dem Feld "appOwnerOrganizationId", um zu bestätigen, dass es mit der ID des Mandanten A übereinstimmt.
Speichern Sie die Objekt-ID des Dienstprinzipals (aus dem
"id"Feld) aus diesem Schritt. Die Objekt-ID ist eine erforderliche Eingabe zum Einrichten von CMK in Foundry IQ.Abrufen der Ressourcen-ID für Azure Key Vault:
az keyvault show --name <key-vault-name> --query id --output tsvWeisen Sie dem neuen Dienstprinzipal die Rolle Key Vault Crypto Service Encryption User im Schlüsseltresor im Mandanten B zu.
az role assignment create --assignee <service-principal-object-id> --role "Key Vault Crypto Service Encryption User" --scope <key-vault-resource-id>Ein Beispiel für diese Aufgabe könnte wie folgt aussehen:
az role assignment create --assignee 00001111-aaaa-2222-bbbb-3333cccc4444 --role "Key Vault Crypto Service Encryption User" --scope /subscriptions/87654321-4321-4321-4321-210987654321/resourceGroups/myKeyVaultRG/providers/Microsoft.KeyVault/vaults/myCompanyKeyVault
Überprüfen der mandantenübergreifenden CMK-Konfiguration des Clientgeheimnisses
Nachdem Sie die mehrinstanzenfähige Microsoft Entra Anwendung konfiguriert und mit der Key Vault des Kunden verbunden haben, überprüfen Sie das Setup, indem Sie ein Testobjekt in Ihrem Foundry IQ-Dienst (Mandant A) erstellen. In diesem Beispiel wird ein Index erstellt, um zu bestätigen, dass der Foundry IQ-Dienst mithilfe des geheimen Clientschlüssels auf den vom Kunden verwalteten Schlüssel zugreifen kann.
Anleitungen zum Erstellen eines Foundry IQ-Diensts und eines neuen Indexobjekts mit einem vom Kunden verwalteten Schlüssel finden Sie unter Konfigurieren von vom Kunden verwalteten Schlüsseln für verschlüsselte Foundry IQ-Daten.
Verwenden Sie einen REST-Client , um eine
Create IndexAnforderung zu senden. Füllen Sie vor dem Erstellen des Indexes die folgenden Felder aus:-
keyVaultUri: Die URI-Adresse des Kunden. -
keyVaultKeyName: Der Schlüsselname des Kunden. -
keyVaultKeyVersion: Die Schlüsselversion des Kunden. -
accessCredentials: DasapplicationIdist etwas wie00001111-aaaa-2222-bbbb-3333cccc4444, und dasapplicationSecretist der Wert, den Sie gerade erstellt haben.
-
{
"name": "cross-tenant-cmk-test",
"fields": [
{
"name": "id",
"type": "Edm.String",
"key": true
}
],
"encryptionKey": {
"keyVaultUri": "https://<key-vault-name>.vault.azure.net/",
"keyVaultKeyName": "<key-name>",
"keyVaultKeyVersion": "<key-version>",
"accessCredentials": {
"applicationId": "<application-client-id>",
"applicationSecret": "<application-client-secret>"
}
}
}
Überprüfen Sie, ob der Index erfolgreich erstellt wurde:
GET https://<search-service>.search.windows.net/indexes/cross-tenant-cmk-test?api-version=2026-10-01
Die Antwort gibt applicationSecret nicht zurück.
Weitere Informationen zum Drehen oder Verwalten von Schlüsseln finden Sie unter Konfigurieren von vom Kunden verwalteten Schlüsseln für die Datenverschlüsselung.