AdminVerschlüsselungsschlüssel (CMEK)

Azure Key Vault für CMEK konfigurieren

Copy page



Verwende Azure Key Vault, um einen Verschlüsselungsschlüssel für deine Organisation bereitzustellen.

Diese Anleitung führt durch die Konfiguration eines Azure-Key-Vault-Schlüssels als kundenverwalteter Verschlüsselungsschlüssel (customer-managed encryption key, CMEK) für deine Anthropic-Organisation.

Voraussetzungen

• Ein Azure Key Vault mit aktivierter RBAC-Autorisierung (enableRbacAuthorization: true) und erlaubtem öffentlichem Netzwerkzugriff. Anthropic ruft deinen Vault über den öffentlichen Data-Plane-Endpunkt auf; private Endpunkte werden nicht unterstützt.
• Aktivierter Purge-Schutz (enablePurgeProtection: true) auf dem Vault. Ohne ihn kann ein gelöschter Schlüssel während des Soft-Delete-Aufbewahrungszeitraums dauerhaft entfernt werden, was zu einem unwiederbringlichen Verlust deiner CMEK-geschützten Daten führt. Der Purge-Schutz kann nach der Aktivierung nicht mehr deaktiviert werden.
• Berechtigungen zum Erstellen von Schlüsseln im Vault und zum Zuweisen von RBAC-Rollen darauf.
• Berechtigungen zum Erstellen von Dienstprinzipalen in deinem Entra-Mandanten (Application Administrator, Cloud Application Administrator oder eine gleichwertige benutzerdefinierte Rolle).
• Ein Anthropic-Admin-API-Key für deine Organisation.
• Die az-CLI installiert und authentifiziert.
• Diagnoseeinstellungen, die auf dem Vault so konfiguriert sind, dass die Protokollkategorie AuditEvent an Log Analytics, ein Speicherkonto oder einen Event Hub weitergeleitet wird. Azure Key Vault gibt standardmäßig keine Data-Plane-Audit-Protokolle (wie KeyWrap, KeyUnwrap und KeyGet) aus, sodass du ohne dies keinen Audit-Trail für Anthropics Schlüsseloperationen erhältst.

Anthropic-App-Informationen

Damit Anthropic deinen Verschlüsselungsschlüssel verwendet, musst du eine Anthropic-Multitenant-Anwendungs-ID und einen Anzeigenamen konfigurieren. Diese Werte sind:

Einrichtung des Verschlüsselungsschlüssels

1. 1

   Der Anthropic-Multitenant-Anwendung zustimmen

   Dies erstellt einen Dienstprinzipal in deinem Entra-Mandanten für Anthropics CMEK-Client-Anwendung. Die Anwendung fordert keine Microsoft-Graph-Berechtigungen an; sie existiert ausschließlich als Föderationsziel für den Key-Vault-Data-Plane-Zugriff.

   az ad sp create --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87

   

   Erfasse aus der Ausgabe das Feld id. Dies ist die Objekt-ID des Dienstprinzipals in deinem Mandanten, die du verwendest, wenn du die RBAC-Rolle zuweist.

   {
     "appId": "8635ae1a-3e5d-44e8-a4ed-e0f614466f87",
     "displayName": "anthropic-cmek-client-us",
     "id": "<sp-object-id>"
   }

   

   Wenn der Dienstprinzipal bereits in deinem Mandanten existiert (aus einem früheren Versuch oder einer anderen Integration), beendet sich az ad sp create mit einem „already exists"-Fehler. Rufe stattdessen seine Objekt-ID ab:

   az ad sp show --id 8635ae1a-3e5d-44e8-a4ed-e0f614466f87 --query id -o tsv

   

   Dieser Schritt hat kein Portal-Äquivalent. Wenn du die Azure-CLI nicht lokal installiert hast, öffne Cloud Shell über die obere Navigationsleiste des Portals. Nachdem der Befehl erfolgreich war, findest du die Objekt-ID des Dienstprinzipals unter Microsoft Entra ID > Unternehmensanwendungen, indem du den Standardfilter für den Anwendungstyp löschst und nach anthropic-cmek-client-us suchst.

   

2. 2

   Einen RSA-Schlüssel in deinem Vault erstellen

   Azure Key Vault unterstützt kein symmetrisches Schlüssel-Wrapping, daher muss der Schlüssel RSA (3072-Bit oder größer) mit wrapKey und unwrapKey in seinen erlaubten Operationen sein.

   Die Option --tags fügt das Organisations-Tag anthropic-org-<ORGANIZATION_UUID> mit dem Wert true hinzu, wobei <ORGANIZATION_UUID> deine Anthropic-Organisations-ID in Kleinbuchstaben ist. Das Tag ist erforderlich, damit Anthropic den Schlüssel validieren kann.

   az keyvault key create \
     --vault-name <VAULT_NAME> \
     --name <KEY_NAME> \
     --kty RSA --size 3072 \
     --ops wrapKey unwrapKey \
     --tags anthropic-org-<ORGANIZATION_UUID>=true

   

   Für HSM-gestützte Schlüssel verwende --kty RSA-HSM (erfordert einen Vault mit Premium-SKU). Softwaregeschützte RSA-Schlüssel sind für diese Integration akzeptabel.

   Öffne im Portal deinen Key Vault, wähle Keys und dann Generate/Import. Setze den Schlüsseltyp auf RSA und die Größe auf 3072 oder größer. Um den Schlüssel auf Wrap und Unwrap zu beschränken, öffne die Schlüsselversion, scrolle zu Permitted operations und deaktiviere alles außer Wrap Key und Unwrap Key.

   Füge auf der Seite Create a key außerdem das Organisations-Tag unter Tags hinzu.

   

   

   Um einen Schlüssel unter mehreren Anthropic-Organisationen zu teilen, füge für jede Organisation ein solches Tag hinzu. Eine Schlüsselversion kann höchstens 15 Tags tragen, einschließlich deiner eigenen.

3. 3

   Dem Anthropic-Dienstprinzipal Zugriff auf deinen Schlüssel gewähren

   Weise dem Dienstprinzipal aus dem ersten Schritt die Rolle Key Vault Crypto User zu, beschränkt auf den einzelnen Schlüssel statt auf den gesamten Vault.

   VAULT_ID=$(az keyvault show --name <your-vault-name> --query id -o tsv)
   
   az role assignment create \
     --role "Key Vault Crypto User" \
     --assignee-object-id <sp-object-id> \
     --assignee-principal-type ServicePrincipal \
     --scope "${VAULT_ID}/keys/<your-key-name>"

   

   Die integrierte Rolle Key Vault Crypto User gewährt kryptografische Schlüsseloperationen (encrypt, decrypt, wrap, unwrap, sign, verify) sowie Lesezugriff auf den Schlüssel in ihrem zugewiesenen Geltungsbereich. Die Einschränkung --ops wrapKey unwrapKey, die du im vorherigen Schritt auf dem Schlüssel gesetzt hast, grenzt weiter ein, welche dieser Operationen gegen diesen Schlüssel erfolgreich sein können, sodass Anthropic in der Praxis nur wrappen und unwrappen kann.

   Öffne im Portal den Schlüssel (nicht den Vault), wähle seinen Tab Access control (IAM), klicke auf Add > Add role assignment, wähle Key Vault Crypto User und weise ihn dem Dienstprinzipal anthropic-cmek-client-us zu.

   

4. 4

   Deine Vault-Konfiguration überprüfen

   az keyvault show --name <your-vault-name> \
     --query "{rbac:properties.enableRbacAuthorization, purge:properties.enablePurgeProtection, pub:properties.publicNetworkAccess, net:properties.networkAcls.defaultAction, ipRules:properties.networkAcls.ipRules, uri:properties.vaultUri, tenantId:properties.tenantId}"

   

   Bestätige, dass:

   • rbac true ist.
   • purge true ist. Wenn es false oder null ist, aktiviere den Purge-Schutz auf dem Vault, bevor du fortfährst. Ohne ihn kann ein soft-gelöschter Schlüssel während des Aufbewahrungszeitraums dauerhaft entfernt werden, wodurch deine CMEK-geschützten Daten nicht wiederherstellbar werden.
   • pub "Enabled" ist. Wenn es "Disabled" ist, kann Anthropic den Vault nicht über seinen öffentlichen Data-Plane-Endpunkt erreichen und die Validierung schlägt fehl.
   • net "Allow" ist, oder, wenn es "Deny" ist, dass ipRules Anthropics Egress-Bereiche enthalten (kontaktiere Anthropic für die aktuelle Liste).
   • uri die Vault-URI ist, die du verwendest, wenn du den Schlüssel registrierst.
   • tenantId der Mandant ist, der den Vault verwaltet. Verwende diesen Wert als tenant_id, wenn du den Schlüssel registrierst, nicht den Mandanten deines aktuell aktiven Abonnements (die beiden können sich in mandantenübergreifenden Setups unterscheiden).

Den Schlüssel bei Anthropic registrieren

Wie du den Schlüssel registrierst, hängt davon ab, welches Produkt du verwendest.

Terraform

Für Infrastructure-as-Code-Bereitstellungen werden dieselben Schritte auf die Provider azurerm und azuread abgebildet.