Konfigurieren von mit vom Kunden verwalteten Schlüsseln verschlüsselten Daten für Foundry IQ (Azure KI-Suche)

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

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.

Vorschaubegriffe speziell für Foundry IQ (Azure KI-Suche) finden Sie unter Vorschaufunktionen.

Durch das Aktivieren von vom Kunden verwalteten Schlüsseln (CMK) wird zusätzlich zur ruhenden Standardverschlüsselung bei Verwendung von Microsoft verwalteten Schlüsseln zusätzliche Sicherheit hinzugefügt. Wenn Sie CMK aktivieren, steuern Sie die Verschlüsselungsschlüssel, die zum Schutz Ihrer Daten verwendet werden, einschließlich der Folgenden:

  • Drehen von Schlüsseln in einem vom Kunden definierten Zeitplan
  • Deaktivieren oder Widerrufen von Schlüsseln zum Blockieren des Zugriffs auf verschlüsselte Inhalte (zwischengespeicherte Schlüssel können bis zu 60 Minuten lang beibehalten werden)
  • Überwachen der Schlüsselverwendung durch Azure Key Vault Protokollierung

Foundry IQ (Azure KI-Suche) verwendet Ihren CMK als Schlüsselverschlüsselungsschlüssel (KEK), um die Datenverschlüsselungsschlüssel einzuschließen und aufzuheben, die Ihre Inhalte schützen. Der CMK wird nicht verwendet, um Inhalte direkt zu verschlüsseln oder zu entschlüsseln.

Sie können Schlüssel erstellen, speichern und verwalten, indem Sie Folgendes verwenden:

  • Azure Key Vault

  • Azure Key Vault Managed HSM (Hardware-Sicherheitsmodul). Ein Azure Key Vault Managed HSM ist ein FIPS 140-2 Level 3 validiertes HSM. Um von Azure Key Vault zu HSM zu migrieren, rotieren Sie Ihre Schlüssel und wählen Sie Managed HSM für die Speicherung aus.

  • Azure Key Vault Managed HSM External Key Management (EKM). Im Gegensatz zu in verwalteten HSM gespeicherten Schlüsseln verbleiben externe Schlüssel in einem vom Kunden betriebenen HSM außerhalb Microsoft Infrastruktur. Verwaltete HSM-Routen leiten Wrap- und Entwrap-Vorgänge zu diesem HSM über einen EKM-Proxy weiter.

In diesem Artikel wird erläutert, wie SIE CMK für zusätzlichen Schutz Ihrer verschlüsselten Daten in Foundry IQ konfigurieren.

Wichtig

  • Das Hinzufügen eines vom Kunden verwalteten Schlüssels (CMK) gilt für die Verschlüsselung ruhender Daten. Wenn Sie die verwendeten Daten schützen müssen, sollten Sie vertrauliche Computer verwenden.

Voraussetzungen

  • Foundry IQ auf einer kostenpflichtigen Stufe (Basic oder höher, in jeder Region).

  • Azure Key Vault und einen Schlüsseltresor mit aktiviertem Schutz vor vorläufigem Löschen und endgültigem Löschen. Oder Azure Key Vault Managed HSM, einschließlich externer Schlüsselverwaltung. Diese Ressource kann sich in einem beliebigen Abonnement und in einem anderen Mandanten befinden. Diese Anweisungen setzen einen einzelnen Mandanten voraus. Informationen zur mandantenübergreifenden Konfiguration finden Sie unter Konfigurieren von vom Kunden verwalteten Schlüsseln in verschiedenen Mandanten.

  • Für die Verwaltung externer Schlüssel sind ein verwaltetes HSM mit aktiviertem EKM in Ihrem Abonnement, ein betriebsbereiter EKM-Proxy und ein RSA-Schlüssel in Ihrem externen HSM erforderlich. Informationen zu Setupanforderungen finden Sie unter Erstellen des ersten externen Schlüssels mithilfe des Azure CLI.

  • Wenn Sie CMK auf Dienstebene konfigurieren möchten, verwenden Sie die Search Management-REST-API-Version 2026-03-01-preview oder neuer. Um zu prüfen, ob ein Objekt einen Schlüssel auf Dienstebene erbt, verwenden Sie die Datenebenen-API, Version 2026-05-01-Preview oder höher.

  • Möglichkeit zum Einrichten von Berechtigungen für den Schlüsselzugriff und zum Zuweisen von Rollen. Um Schlüssel zu erstellen, verwenden Sie Key Vault Crypto Officer in Azure Key Vault oder Managed HSM Crypto User in Azure Key Vault Managed HSM.

    Um Azure Key Vault-Rollen zuzuweisen, müssen Sie entweder Besitzer, Benutzerzugriffsadministrator, Rollenbasierter Zugriffskontrolladministrator sein oder einer benutzerdefinierten Rolle mit Microsoft.Authorization/roleAssignments/write-Berechtigungen zugewiesen sein. Der verwaltete HSM-Schlüsselzugriff erfordert separate lokale RBAC-Rollenzuweisungsberechtigungen.

Konfigurieren von CMK für Foundry IQ-Objekte

Objekte mit verschlüsselten Daten, die mit einem vom Kunden verwalteten Schlüssel (CMK) konfiguriert werden können, umfassen Indizes, Synonymlisten, Indexer, Datenquellen, Vektorisierer und Skillsets. Verschlüsselung ist rechenintensiv zu entschlüsseln, sodass nur vertrauliche Inhalte verschlüsselt werden.

Verschlüsselung erfolgt über:

  • Alle Inhalte in Indizes und Synonymlisten.

  • Vertrauliche Inhalte in Indexern, Datenquellen, Skillsets und Vektorisierern. Vertrauliche Inhalte umfassen Verbindungszeichenfolgen, Beschreibungen, Identitäten, Schlüssel und Benutzereingaben. Beispielsweise können Skillsets Schlüssel für verbundene Dienste enthalten, und einige Fähigkeiten akzeptieren Benutzereingaben, z. B. benutzerdefinierte Entitäten. In beiden Fällen werden Schlüssel und Benutzereingaben verschlüsselt. Alle Verweise auf externe Ressourcen, z. B. Azure Datenquellen oder Azure OpenAI-Modelle, werden ebenfalls verschlüsselt.

Das Hinzufügen eines vom Kunden verwalteten Schlüssels zu einem Objekt muss erfolgen, wenn das Objekt neu erstellt wird. Es ist wichtig, folgendes zu beachten:

  • Sie können CMK nicht rückwirkend zu einem vorhandenen Objekt hinzufügen. Wenn Sie einem vorhandenen Objekt einen vom Kunden verwalteten Schlüssel hinzufügen möchten, müssen Sie dieses Objekt mit aktivierter Verschlüsselung löschen und neu erstellen.

  • Sobald CMK konfiguriert ist, erfolgt die Verschlüsselung jedes Mal, wenn der Dienst Daten schreibt, einschließlich ruhender Daten (langfristiger Speicher) oder temporäre zwischengespeicherte Daten (kurzfristiger Speicher). Bei Objekten wie Datenquellen, Indexern und Skillsets wird die Objektdefinition verschlüsselt. Bei Indizes werden die indizierten Dokumente selbst (nicht nur das Indexschema) verschlüsselt.

  • Sie können eine vorhandene CMK-Konfiguration ändern, einschließlich des Wechsels zu einem anderen Key Vault oder HSM-Speicher. Um einen Key Vault in einem anderen Mandanten zu verwenden, konfigurieren Sie mandantenübergreifende CMK.

  • Die Verschlüsselung mit einem CMK ist unumkehrbar. Sie können Schlüssel drehen und die CMK-Konfiguration ändern, die Indexverschlüsselung dauert jedoch für die Lebensdauer des Indexes. Nach der Verschlüsselung mit CMK ist nur ein Index zugänglich, wenn der Foundry IQ-Dienst Zugriff auf den Schlüssel hat. Wenn Sie den Zugriff auf den Schlüssel widerrufen, indem Sie die Rollenzuweisung löschen oder ändern, kann der Index nicht verwendet werden, und der Dienst kann erst skaliert werden, wenn der Index gelöscht oder der Zugriff auf den Schlüssel wiederhergestellt wird. Wenn Sie Schlüssel löschen oder drehen, wird der neueste Schlüssel für bis zu 60 Minuten zwischengespeichert.

  • Wenn Sie CMK für Ihren Foundry IQ-Dienst benötigen, legen Sie eine Erzwingungsrichtlinie fest.

  • CMK-Erzwingung mithilfe von Azure Policy und die CMK-Konfiguration auf Dienstebene (die sich noch in der Vorschau befindet) sind unabhängige Einstellungen. Sie können je nach Ihren Anforderungen entweder oder beides verwenden. Die CMK-Konfiguration auf Dienstebene wendet einen Standardschlüssel auf neue Objekte an, während Azure Policy Erzwingung sicherstellt, dass alle Objekte Ihren Verschlüsselungsanforderungen entsprechen. Wenn Sie eine CMK-Erzwingungsrichtlinie ohne einen Schlüssel auf Dienstebene aktivieren, müssen alle CMK-fähigen Objekte zum Erstellungszeitpunkt ihren eigenen Verschlüsselungsschlüssel angeben. Objekterstellungsanforderungen, die die CMK-Konfiguration weglassen, schlagen fehl.

CMK auf Dienstebene für neue Objekte standardmäßig aktivieren (Vorschau)

Ab der 2026-03-01-Preview-Version können Sie einen vom Kunden verwalteten Schlüssel auf Serviceebene im Foundry IQ-Dienst selbst konfigurieren. Mit diesem Feature können Sie den Schlüssel einmal konfigurieren und auf alle neu erstellten Objekte standardmäßig anwenden. Dieser Schutz schützt vertrauliche Daten in Ihrem Foundry IQ Service mit einem von Ihnen gesteuerten Schlüssel, ohne dass Sie bei jeder Erstellung eines Objekts wichtige Informationen angeben müssen. In der API-Version 2026-05-01-preview der Datenebene und höher können Sie anhand der isServiceLevelKey Eigenschaft encryptionKey ermitteln, ob ein Objekt den Schlüssel auf Dienstebene erbt oder einen expliziten Schlüssel auf Objektebene verwendet.

Das Aktivieren von CMK auf Dienstebene bedeutet:

  • Alle neuen Objekte, die auf Ihrem Foundry IQ-Dienst erstellt wurden, verwenden standardmäßig automatisch den vom Kunden verwalteten Schlüssel auf Serviceebene, sodass Sie bei jedem Erstellen eines Objekts keine expliziten Verschlüsselungsschlüsseldetails mehr angeben müssen.

  • Dieses Feature ist optional, und Sie können CMK weiterhin pro Objekt konfigurieren. Sie können den Schlüssel auf Dienstebene auch für einzelne Objekte außer Kraft setzen und den Schlüssel auf Dienstebene unabhängig voneinander drehen, sodass Sie bei Bedarf unterschiedliche Schlüssel für unterschiedliche Objekte verwenden können.

Sie können diesen Standardschlüssel überschreiben, indem Sie einen neuen Schlüssel für das objekt angeben, das Sie erstellen. Der Schlüssel auf Objektebene, den Sie angeben, setzt den Standardschlüssel auf Dienstebene für dieses Objekt außer Kraft.

Wählen Sie zwischen CMK auf Dienstebene und Objektebene

Verwenden Sie CMK auf Dienstebene standardmäßig, um einen einzelnen Schlüssel für alle Objekte anzuwenden. Sie konfigurieren den Schlüssel einmal, und neue Objekte erben diesen Schutz automatisch.

Verwenden Sie CMK auf Objektebene für Workloads, die einen unabhängigen Schlüssellebenszyklus erfordern. Vorhandene CMK-Konfigurationen auf Objektebene funktionieren weiterhin ohne Änderungen. CMK auf Dienstebene vereinfacht die Schlüsselverwaltung, ersetzt jedoch keine CMK auf Objektebene.

Ein häufiges Unternehmensmuster besteht darin, für die meisten Objekte (Indizes, Indexer, Datenquellen, Skillsets, Vektorisierer und Synonymzuordnungen) einen Schlüssel auf Dienstebene zu konfigurieren. Workloads mit strengeren Complianceanforderungen können einen objektbezogenen Schlüssel konfigurieren, um Zugriff, Schlüsselrotation und Widerruf unabhängig zu verwalten.

Schritt 1: Erstellen eines Verschlüsselungsschlüssels

Erstellen Sie einen Schlüssel in Azure Key Vault oder Azure Key Vault Managed HSM, oder registrieren Sie einen externen Schlüsselverweis in Managed HSM. Die Foundry IQ-Verschlüsselung unterstützt RSA-Schlüssel der Größen 2048, 3072 und 4096. Diese Anforderungen gelten auch für Fremdschlüssel. Weitere Informationen zu unterstützten Schlüsseltypen finden Sie unter "Informationen zu Schlüsseln".

Es wird empfohlen , diese Tipps zu überprüfen, bevor Sie beginnen.

Der Schlüssel muss Wrap Key- und Unwrap Key-Vorgänge zulassen. Foundry IQ erfordert keine Verschlüsselungs- oder Entschlüsselungsvorgänge für den CMK.

Sie können einen Schlüsseltresor mithilfe des Azure-Portals, Azure CLI oder Azure PowerShell erstellen.

  1. Gehen Sie zu Ihrem Schlüsseltresor im Azure-Portal.

  2. Wählen Sie auf der linken Seite die Schlüssel "Objekte>" aus, und wählen Sie dann "Generieren/Importieren" aus.

  3. Wählen Sie im Bereich " Schlüssel erstellen " in der Liste der Optionen die Option "Generieren " aus, um einen neuen Schlüssel zu erstellen.

  4. Geben Sie einen Namen für Ihren Schlüssel ein, und akzeptieren Sie die Standardwerte für andere Schlüsseleigenschaften.

  5. Legen Sie optional eine Schlüsseldrehungsrichtlinie fest, um die automatische Drehung zu aktivieren.

  6. Wählen Sie "Erstellen" aus, um die Bereitstellung zu starten.

  7. Rufen Sie nach dem Erstellen des Schlüssels den Schlüsselbezeichner ab. Wählen Sie den Schlüssel aus, wählen Sie die aktuelle Version aus, und kopieren Sie dann den Schlüsselbezeichner. Er besteht aus dem Schlüsseltresor-URI, dem Schlüsselnamen und der Schlüsselversion. Sie benötigen den Bezeichner, um einen verschlüsselten Index in Foundry IQ zu definieren.

    Erstellen eines neuen Key Vault-Schlüssels

Schritt 2: Erstellen eines Sicherheitsprinzipals

Erstellen Sie einen Sicherheitsprinzipal, den Ihr Foundry IQ-Dienst für den Zugriff auf den Verschlüsselungsschlüssel verwendet. Sie können eine verwaltete Identität und Rollenzuweisung verwenden, oder Sie können eine Anwendung registrieren und der Foundry IQ-Dienst bei Anforderungen die Anwendungs-ID bereitstellt.

Verwenden Sie eine verwaltete Identität und Rollen. Sie können entweder eine vom System verwaltete Identität oder eine vom Benutzer verwaltete Identität verwenden. Eine verwaltete Identität ermöglicht es Ihrem Foundry IQ-Dienst, sich über Microsoft Entra ID zu authentifizieren, ohne Anmeldeinformationen (ApplicationID oder ApplicationSecret) im Code zu speichern. Der Lebenszyklus dieser Art von verwalteter Identität ist an den Lebenszyklus Ihres Foundry IQ-Diensts gebunden, der nur eine vom System zugewiesene verwaltete Identität aufweisen kann. Weitere Informationen zur Funktionsweise von verwalteten Identitäten finden Sie unter What are managed identities for Azure resources.

Aktivieren Sie die vom System zugewiesene verwaltete Identität für Ihren Foundry IQ-Dienst. Es ist ein Zwei-Klick-Vorgang: Aktivieren und Speichern.

Screenshot der Aktivierung der vom System zugewiesenen verwalteten Identität.

Schritt 3: Erteilen von Berechtigungen

Gewähren Sie dem Sicherheitsprinzipal des Foundry IQ-Diensts die folgenden Mindestberechtigungen für den Schlüsselzugriff: Abrufen (Lesen von Schlüsselmetadaten), Schlüssel verpacken und Schlüssel entpacken. Diese Berechtigungen gelten für Azure Key Vault, Managed HSM und externe Schlüssel, auf die in Managed HSM verwiesen wird.

Die folgenden Rollen stellen diese Schlüsseldatenberechtigungen bereit, ohne Berechtigungen für Encrypt, Decrypt oder die Schlüsselverwaltung zu gewähren:

Schlüsselspeicher Rolle für den Dienstprinzipal des Foundry IQ-Diensts Berechtigungsmodell
Azure Key Vault Key Vault Crypto Service Encryption User Azure RBAC
Verwaltetes HSM, einschließlich externer Schlüsselverwaltung Benutzer für die Verschlüsselung des Managed HSM Crypto Service Lokale RBAC für verwaltetes HSM

Die rollenbasierte Zugriffssteuerung wird gegenüber dem Zugriffsrecht-Modell empfohlen. Für weitere Informationen oder Migrationsschritte beginnen Sie mit Azure rollenbasierten Zugriffssteuerung (Azure RBAC) und Zugriffsrichtlinien (Legacy).

Wenn Sie eine ältere Key Vault Zugriffsrichtlinie verwenden, gewähren Sie nur "Get", "Wrap Key" und "Unwrap Key" dem Sicherheitsprinzipal.

Verwenden Sie für Azure Key Vault die folgenden Schritte, um die Rolle der verwalteten Identität Ihres Foundry IQ-Diensts zuzuweisen:

  1. Gehen Sie zu Ihrem Schlüsseltresor im Azure-Portal.

  2. Wählen Sie Access Control (IAM) und dann "Rollenzuweisung hinzufügen" aus.

  3. Wählen Sie Key Vault Crypto Service Encryption User aus.

  4. Wählen Sie verwaltete Identitäten aus, wählen Sie Mitglieder und dann die verwaltete Identität Ihres Foundry IQ-Diensts aus. Wenn Sie lokal testen, sollten Sie sich diese Rolle ebenfalls zuweisen.

  5. Wählen Sie "Überprüfen" und "Zuweisen" aus.

Warten Sie einige Minuten, bis die Rollenzuweisung betriebsbereit ist.

Weisen Sie für verwaltetes HSM, einschließlich externer Schlüsselverweise, verwalteten HSM Crypto Service Encryption User über verwaltetes HSM-lokales RBAC zu. Sie können die Zuordnung auf /keys/<key-name> beschränken, um nur Zugriff auf den CMK und seine Versionen zu gewähren. Anweisungen zur Rollenzuweisung finden Sie unter Zugriffssteuerung für Managed HSM.

Key Vault Firewall- und virtueller Netzwerkzugriff für CMK

Foundry IQ muss in Ihrer Azure Key Vault auf den Verschlüsselungsschlüssel zugreifen können.

Wenn Ihr Schlüsseltresor eine Firewall oder virtuelle Netzwerkeinschränkungen verwendet, konfigurieren Sie eine der folgenden Optionen:

Wenn die Umgehung vertrauenswürdiger Dienste aktiviert ist, kann Foundry IQ mithilfe der verwalteten Identität auf den Schlüssel als vertrauenswürdiger Dienst zugreifen, auch wenn der Zugriff auf öffentliche Netzwerke eingeschränkt ist.

Wenn die Firewall den Zugriff blockiert und die Umgehung vertrauenswürdiger Dienste nicht aktiviert ist, kann Foundry IQ den Schlüssel nicht abrufen, und CMK-abhängige Vorgänge schlagen fehl.

Schritt 4: Hinzufügen von Verschlüsselungsschlüsselinformationen zu Foundry IQ-Objekten

Wenn Sie ein verschlüsseltes Objekt erstellen, geben Sie den Schlüsseltresor-URI, den Schlüsselnamen und die Schlüsselversion ein. Wenn Sie eine Microsoft Entra ID Anwendung für die Authentifizierung verwenden, geben Sie auch die Anwendungs-ID und den geheimen Schlüssel ein.

Legen Sie für externe Schlüssel die vorhandenen CMK-Eigenschaften auf den verwalteten HSM-Endpunkt (keyVaultUri), den Schlüsselverweisnamen (keyVaultKeyName) und die Version (keyVaultKeyVersion) fest. Verwenden Sie nicht die EKM-Proxy-URL oder den Bezeichner für externe Schlüssel. Konfigurieren Sie externe Schlüssel über die Foundry IQ REST-APIs, nicht über das Portal.

Um einem Suchobjekt einen vom Kunden verwalteten Schlüssel hinzuzufügen, kann es sich um einen Index, einen Indexer, eine Datenquelle, ein Skillset, einen Vektorizer oder eine Synonymzuordnung handeln, sie können den Schlüssel auf Dienstebene oder auf Objektebene konfigurieren.

Dienstebene: Durch das Einrichten eines vom Kunden verwalteten Schlüssels auf Dienstebene wird dieser Schlüssel standardmäßig auf alle neu erstellten Suchobjekte angewendet. Sie gilt nicht für bereits vorhandene Suchobjekte.

Objektebene: Sie können auch einen neuen, eindeutigen Schlüssel auf Objektebene definieren, wenn Sie ein neues Suchobjekt erstellen. Diese Schlüsseldefinition auf Objektebene setzt den Standardschlüssel auf Dienstebene außer Kraft.

Achtung

Wenn Sie eine vom Kunden verwaltete Schlüsselkonfiguration zwischen einer Schlüsseldefinition auf Dienstebene oder Objektebene aktualisieren, behalten Sie Ressourcen aus der vorherigen Konfiguration zur Verfügung, bis das Update über den gesamten Dienst verteilt wird. Das Entfernen von Identitäten, das Löschen von Schlüsseltresorn oder das Widerrufen von Schlüsseln zu früh kann verhindern, dass einige Dienstkomponenten Daten entschlüsseln, die noch auf der vorherigen Konfiguration basieren.

Um CMK für ein Objekt zu konfigurieren, verwenden Sie das Azure Portal, Search Service REST-APIs oder einen Azure SDK.

Wenn Sie ein neues Objekt im Azure Portal erstellen, können Sie einen vordefinierten vom Kunden verwalteten Schlüssel in einem Schlüsseltresor angeben. Mit dem Azure-Portal können Sie die Verschlüsselung mit einem CMK für Folgendes aktivieren:

  • Indizes
  • Datenquellen
  • Indexer

Um das Azure-Portal zu verwenden, muss der Schlüsseltresor und der Schlüssel vorhanden sein, und Sie müssen die vorherigen Schritte ausführen, um autorisierten Zugriff auf den Schlüssel zu erhalten.

Im Azure-Portal werden Skillsets in der JSON-Ansicht definiert. Verwenden Sie den JSON-Code in den REST-API-Beispielen, um einen vom Kunden verwalteten Schlüssel für ein Skillset bereitzustellen.

  1. Wechseln Sie im Azure Portal zu Ihrem Foundry IQ Service.

  2. Wählen Sie unter "Suchverwaltung" die Option "Indizes", " Indexer" oder "Datenquellen" aus.

  3. Fügen Sie ein neues Objekt hinzu. Wählen Sie in der Objektdefinition Microsoft-managed encryption aus.

  4. Wählen Sie vom Kunden verwaltete Schlüssel aus, und wählen Sie Ihr Abonnement, Ihren Tresor, Ihren Schlüssel und Ihre Version aus.

Screenshot der Seite

Wichtig

Verschlüsselter Inhalt in Foundry IQ ist für die Verwendung eines bestimmten Schlüssels mit einer bestimmten Version konfiguriert. Wenn Sie den Schlüssel oder die Version ändern, muss das Objekt aktualisiert werden, damit es verwendet wird, bevor Sie den vorherigen löschen. Wenn dies nicht erfolgt, wird das Objekt unbrauchbar. Sie können den Inhalt nicht entschlüsseln, wenn der Schlüssel verloren geht.

Konfigurieren von CMK auf Dienstebene (Vorschau)

Um die CMK-Konfiguration auf Dienstebene zu aktivieren, verwenden Sie die Rest-API für die Suchverwaltung oder ein Azure SDK Paket, das aktualisiert wird, um die Search Management REST API Version 2026-03-01-preview oder höher zu unterstützen. Das Azure-Portal unterstützt dieses Feature noch nicht. Wenn Sie CMK auf Dienstebene aktivieren, fügen Sie vorhandenen Objekten keine Verschlüsselung hinzu, aber Sie wenden denselben Schlüssel standardmäßig auf alle neu erstellten Objekte im Dienst an, es sei denn, Sie geben einen anderen Schlüssel auf Objektebene an, um den Standardwert auf Dienstebene außer Kraft zu setzen.

Derzeit unterstützt das Azure-Portal keine Verschlüsselung auf Dienstebene. Verwenden Sie die REST-API direkt.

Überprüfen, ob ein Suchobjekt CMK auf Dienstebene erbt

Um zu überprüfen, ob ein Suchobjekt einen vom Kunden verwalteten Schlüssel verwendet, der auf Dienstebene als Standard oder als eindeutiger vom Kunden verwalteter Schlüssel auf Objektebene konfiguriert ist, überprüfen Sie den geerbten Verschlüsselungsstatus mithilfe der isServiceLevelKey Eigenschaft.

Derzeit unterstützt das Azure-Portal keine Verschlüsselung auf Dienstebene. Verwenden Sie die REST-API direkt.

Schritt 5: Testen der Verschlüsselung

Um zu überprüfen, ob die Verschlüsselung funktioniert, widerrufen Sie den Verschlüsselungsschlüssel, fragen Sie den Index ab (er sollte nicht verwendbar sein), und setzen Sie dann den Verschlüsselungsschlüssel wieder ein.

Für schlüssel, die in Azure Key Vault gespeichert sind, verwenden Sie für diesen Test das Azure Portal. Stellen Sie sicher, dass Sie über eine Rollenzuweisung verfügen, die Lesezugriff auf den Schlüssel gewährt.

  1. Wählen Sie auf der Seite Azure Key Vault Objects>Keys aus.

  2. Wählen Sie den von Ihnen erstellten Schlüssel und dann "Löschen" aus.

  3. Wählen Sie auf der Seite „Foundry IQ“ Search management>Indexes aus.

  4. Wählen Sie Ihren Index aus, und verwenden Sie den Such-Explorer, um eine Abfrage auszuführen. Sie sollten eine Fehlermeldung erhalten.

  5. Kehren Sie zur Seite Azure Key Vault Objects>Keys zurück.

  6. Wählen Sie "Gelöschte Schlüssel verwalten" aus.

  7. Wählen Sie Ihren Schlüssel und dann " Wiederherstellen" aus.

  8. Kehren Sie zu Ihrem Index in Foundry IQ zurück, und führen Sie die Abfrage erneut aus. Suchergebnisse sollten angezeigt werden. Wenn keine sofortigen Ergebnisse angezeigt werden, warten Sie eine Minute, und versuchen Sie es erneut.

Einrichtung einer Richtlinie zur Durchsetzung der CMK-Compliance

Azure Richtlinien tragen dazu bei, organisatorische Standards zu erzwingen und die Compliance im großen Maßstab zu bewerten. Foundry IQ verfügt über zwei optionale integrierte Richtlinien im Zusammenhang mit CMK. Diese Richtlinien gelten für neue und bestehende Foundry IQ-Dienste.

Wirkung Beschreibung
AuditIfNotExists Überprüft die Richtlinienkonformität: Haben die Objekte einen kundenspezifisch verwalteten Schlüssel definiert, und ist der Inhalt verschlüsselt? Dieser Effekt gilt für vorhandene Dienste mit Inhalten. Es wird jedes Mal ausgewertet, wenn ein Objekt erstellt oder aktualisiert wird, oder je nach Auswertungszeitplan. Weitere Informationen...
Ablehnen Überprüft die Richtlinienerzwingung: Ist der Foundry IQ-Dienst auf Enabled für SearchEncryptionWithCmk festgelegt. Dieser Effekt gilt nur für neue Dienste, die mit aktivierter Verschlüsselung erstellt werden müssen. Vorhandene Dienste bleiben betriebsbereit, aber Sie können sie nur aktualisieren, wenn Sie den Dienst patchen. Keines der Tools, die für Bereitstellungsdienste verwendet werden, stellt diese Eigenschaft bereit. Beachten Sie daher, dass das Festlegen der Richtlinie Sie auf programmgesteuerte Einrichtung beschränkt.

Zuweisen einer Richtlinie

  1. Navigieren Sie im Azure-Portal zu einer integrierten Richtlinie, und wählen Sie dann Assign aus.

    Hier ist ein Beispiel für die richtlinie AuditIfExists im Azure-Portal:

    Screenshot der Zuweisung der integrierten CMK-Richtlinie.

  2. Legen Sie den Richtlinienbereich fest, indem Sie die Abonnement- und Ressourcengruppe auswählen. Schließen Sie alle Foundry IQ-Dienste aus, für die die Richtlinie nicht gelten sollte.

  3. Übernehmen oder ändern Sie die Standardwerte. Wählen Sie "Überprüfen" und "Erstellen" und dann " Erstellen" aus.

Aktivierung der Durchsetzung von CMK-Richtlinien

Wenn Sie einer Ressourcengruppe in Ihrem Abonnement eine Richtlinie zuweisen, wird sie sofort wirksam. Überwachungsrichtlinien kennzeichnen nicht kompatible Ressourcen, aber Verweigern-Richtlinien verhindern die Erstellung und Aktualisierung nicht konformer Foundry IQ-Dienste. In diesem Abschnitt wird erläutert, wie Sie einen kompatiblen Foundry IQ-Dienst erstellen oder einen Dienst aktualisieren, um ihn kompatibel zu machen. Um Objekte in die Compliance zu bringen, beginnen Sie in Schritt 1 dieses Artikels.

Einen konformen Foundry IQ-Dienst erstellen

Für neue Foundry IQ-Dienste erstellen Sie sie, wobei SearchEncryptionWithCmk auf Enabled festgelegt ist.

Weder das Azure Portal noch die Befehlszeilentools (die Azure CLI und Azure PowerShell) stellen diese Eigenschaft nativ bereit, aber Sie können die Verwaltungs-REST-API verwenden, um einen Foundry IQ-Dienst mit einer CMK-Richtliniendefinition bereitzustellen.

Dieses Beispiel stammt von Manage your Foundry IQ service with REST APIs und wurde so geändert, dass es die Eigenschaft SearchEncryptionWithCmk enthält.

### Create a search service (provide an existing resource group)
@resource-group = my-rg
@search-service-name = my-search
PUT https://management.azure.com/subscriptions/{{subscriptionId}}/resourceGroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2025-05-01 HTTP/1.1
     Content-type: application/json
     Authorization: Bearer {{token}}

    {
        "location": "North Central US",
        "sku": {
            "name": "basic"
        },
        "properties": {
            "replicaCount": 1,
            "partitionCount": 1,
            "hostingMode": "default",
            "encryptionWithCmk": {
                "enforcement": "Enabled"
        }
      }
    }

Aktualisieren eines vorhandenen Foundry IQ-Diensts

Für vorhandene Foundry IQ-Dienste, die jetzt nicht konform sind, patchen Sie sie mithilfe der Dienste – Update-API oder des Azure CLI-Befehls az resource update. Durch das Patchen der Dienste wird die Möglichkeit zum Aktualisieren der Foundry IQ-Diensteigenschaften wiederhergestellt.

PATCH https://management.azure.com/subscriptions/<your-subscription-Id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>?api-version=2025-05-01

{
  "properties": {
      "encryptionWithCmk": {
          "enforcement": "Enabled"
      }
  }
}

Drehen oder Aktualisieren von Verschlüsselungsschlüsseln

Verwenden Sie die folgenden Anweisungen, um Schlüssel zu drehen oder von Azure Key Vault zum Hardware Security Module (HSM) zu migrieren.

Verwenden Sie die Autorotationsfunktionen von Azure Key Vault für die Schlüsseldrehung. Wenn Sie autorotation verwenden, lassen Sie die Schlüsselversion in Objektdefinitionen aus. Der neueste Schlüssel wird anstelle einer bestimmten Version verwendet.

Wenn Sie einen Schlüssel oder dessen Version ändern, aktualisieren Sie jedes Objekt, das den Schlüssel verwendet, um die neuen Werte zu verwenden, bevor Sie die alten Werte löschen. Andernfalls kann das Objekt nicht mehr verwendet werden, da es nicht entschlüsselt werden kann.

Wenn Sie CMK auf Dienstebene konfiguriert haben, gilt die Rotation des Schlüssels auf Dienstebene für neu erstellte Objekte. Objekte, die bereits den vorherigen Schlüssel auf Dienstebene geerbt haben, übernehmen automatisch den neuen Schlüssel, sodass Sie sie nicht aktualisieren müssen. Wenn Sie jedoch Objekte hatten, die mit einem Schlüssel auf Objektebene konfiguriert wurden, den Sie auch drehen möchten, müssen Sie diese Objekte aktualisieren, um den neuen Schlüssel zu verwenden.

Schlüssel werden 60 Minuten zwischengespeichert. Denken Sie daran, wenn Sie Tasten testen und drehen.

  1. Bestimmen Sie den Schlüssel, der von einem Index oder einer Synonymzuordnung verwendet wird.

  2. Erstellen Sie einen neuen Schlüssel im Schlüsseltresor, lassen Sie jedoch den ursprünglichen Schlüssel verfügbar. In diesem Schritt können Sie von Key Vault zu HSM wechseln.

  3. Aktualisieren Sie die EncryptionKey-Eigenschaften für eine Index- oder Synonymzuordnung, um die neuen Werte zu verwenden. Nur Objekte, die ursprünglich mit dieser Eigenschaft erstellt wurden, können aktualisiert werden, um einen anderen Wert zu verwenden.

  4. Deaktivieren oder löschen Sie den vorherigen Schlüssel im Schlüsseltresor. Überwachen Sie den Schlüsselzugriff, um zu überprüfen, ob der neue Schlüssel verwendet wird.

Aus Leistungsgründen zwischenspeichert der Foundry IQ-Dienst den Schlüssel für mehrere Stunden. Wenn Sie den Schlüssel deaktivieren oder löschen, ohne einen neuen Schlüssel bereitzustellen, funktionieren Abfragen auf temporärer Basis, bis der Cache abläuft. Sobald der Foundry IQ-Dienst Inhalte jedoch nicht mehr entschlüsseln kann, erhalten Sie diese Meldung: "Access forbidden. The query key used might have been revoked - please retry."

Tipps für Key Vault

  • Wenn Sie noch nicht mit Azure Key Vault arbeiten, lesen Sie diese Schnellstartanleitung, um grundlegende Aufgaben zu erfahren: Set und Abrufen eines geheimen Schlüssels aus Azure Key Vault mithilfe von PowerShell.

  • Verwenden Sie so viele Schlüsseltresore, wie Sie benötigen. Verwaltete Schlüssel können sich in verschiedenen Schlüsseltresoren befinden. Ein Foundry IQ-Dienst kann mehrere verschlüsselte Objekte haben, die jeweils mit einem anderen vom Kunden verwalteten Verschlüsselungsschlüssel verschlüsselt sind, der in verschiedenen Schlüsseltresoren gespeichert ist.

  • Verwenden Sie denselben Azure Mandant, damit Sie Ihren verwalteten Schlüssel über Rollenzuweisungen abrufen und eine Verbindung über ein System oder eine vom Benutzer verwaltete Identität herstellen können. Weitere Informationen zum Erstellen eines Mandanten finden Sie unter Einrichten eines neuen Mandanten.

  • Wenn Ihr Azure Key Vault mit einer Firewall gesichert ist, müssen Sie zulassen, dass vertrauenswürdige Microsoft-Dienste diese Firewall umgehen können, damit Foundry IQ auf den Schlüssel zugreifen kann.

  • Aktivieren Sie den Löschschutz und das vorläufige Löschen für einen Key Vault. Aufgrund der Art der Verschlüsselung mit vom Kunden verwalteten Schlüsseln kann niemand Ihre Daten abrufen, wenn Ihr Azure Key Vault Schlüssel gelöscht wird. Um Datenverluste zu verhindern, die durch versehentliche Löschungen von Schlüsseln im Key Vault verursacht werden, muss der Soft-Delete- und Löschschutz im Key Vault aktiviert sein. Das vorläufige Löschen ist standardmäßig aktiviert, sodass Sie nur dann Probleme haben, wenn Sie es absichtlich deaktivieren. Der Löschschutz ist standardmäßig nicht aktiviert, ist jedoch für die Verschlüsselung mit einem CMK in Foundry IQ erforderlich.

  • Aktivieren Sie die Protokollierung im Schlüsseltresor, damit Sie die Schlüsselverwendung überwachen können.

  • Aktivieren Sie die automatische Rotation von Schlüsseln oder befolgen Sie strenge Verfahren während der Routinerotation von Schlüsseltresorschlüsseln und Anwendungsgeheimnissen und Registrierungen. Aktualisieren Sie immer alle verschlüsselten Inhalte , um neue Geheimschlüssel und Schlüssel zu verwenden, bevor Sie die alten löschen. Wenn Sie diesen Schritt verpassen, können Ihre Inhalte nicht entschlüsselt werden.

Arbeiten mit verschlüsselten Inhalten

Bei Verwendung von CMK können Sie aufgrund der zusätzlichen Verschlüsselungs-/Entschlüsselungsarbeit Latenz für Indizierung und Abfragen feststellen. Foundry IQ protokolliert keine Verschlüsselungsaktivität, aber Sie können den Schlüsselzugriff über die Schlüsseltresorprotokollierung überwachen.

Es wird empfohlen, die Protokollierung als Teil der Key Vault-Konfiguration zu aktivieren .

  1. Erstellen Sie einen Log Analytics-Arbeitsbereich.

  2. Fügen Sie in Key Vault eine Diagnoseeinstellung hinzu, die den Arbeitsbereich für die Datenaufbewahrung verwendet.

  3. Wählen Sie "Audit " oder "allLogs" für die Kategorie aus, geben Sie der Diagnoseeinstellung einen Namen, und speichern Sie sie.

FAQs

Kann ich ein Suchobjekt zwischen einem vom Kunden verwalteten Schlüssel ändern, der auf Dienstebene definiert ist, und einem vom Kunden verwalteten Schlüssel, der auf Objektebene definiert ist?

  • Yes. Wenn Sie den CMK auf Dienstebene konfigurieren, verwendet jedes neue Suchobjekt diesen Schlüssel standardmäßig. Wenn Sie einen anderen Schlüssel in der Definition auf Objektebene konfigurieren, hat der Schlüssel auf Objektebene Vorrang vor dem Schlüssel auf Dienstebene. Wenn Sie die Schlüsseldefinition auf Objektebene entfernen, wird das Suchobjekt standardmäßig wieder auf den vom Kunden verwalteten Schlüssel zurückgeführt, der auf Dienstebene definiert ist.

Nächste Schritte

Wenn Sie mit Azure Sicherheitsarchitektur nicht vertraut sind, lesen Sie die Azure Sicherheitsdokumentation und insbesondere diesen Artikel: