AdminCMEK einrichten

Einen Verschlüsselungsschlüssel mit der Admin API hinzufügen und anhängen

Erstelle, validiere und hänge einen kundenverwalteten Verschlüsselungsschlüssel mit drei Admin-API-Aufrufen an.

Diese Aufrufe funktionieren auf der Claude Platform. Folge auf Claude Enterprise oder Claude Platform on AWS deiner Einrichtungsseite.

Das Erstellen eines externen Schlüssels entspricht dem, was Add key in der Claude Console tut, und das Validieren entspricht dem, was Verify tut.

Bevor du beginnst

„Customer-managed encryption keys“ (kundenverwaltete Verschlüsselungsschlüssel), oder CMEK, sind für deine Organisation aktiviert.
Du hast einen Admin-API-Key. Die Beispiele lesen ihn aus ANTHROPIC_API_KEY.
Du hast deinen Schlüssel in AWS KMS, Google Cloud KMS oder Azure Key Vault erstellt und die Werte aufbewahrt, die du laut den Einrichtungsschritten kopieren sollst.
Du hast einen Workspace, der Daten aufbewahrt, idealerweise einen neuen, weil bestehende Daten unter dem Schlüssel von Anthropic bleiben.

Den Schlüssel erstellen, validieren und anhängen

Den externen Schlüssel erstellen

Ersetze <friendly-name> durch einen Anzeigenamen und <key-arn-from-create-key-step> durch die Schlüssel-ARN.

client = anthropic.Anthropic()

external_key = client.organization.external_keys.create(
    display_name="<friendly-name>",
    geo="us",
    provider_config={"type": "aws", "kms_arn": "<key-arn-from-create-key-step>"},
)

print(f"id: {external_key.id}")
print(f"display_name: {external_key.display_name}")

Ersetze <friendly-name> durch einen Anzeigenamen. Ersetze den Wert, der mit projects/ beginnt, durch den vollständigen Ressourcennamen des Schlüssels.

client = anthropic.Anthropic()

external_key = client.organization.external_keys.create(
    display_name="<friendly-name>",
    geo="us",
    provider_config={
        "type": "gcp",
        "key_name": "projects/<your-project-id>/locations/<region>/keyRings/<your-keyring-name>/cryptoKeys/<your-key-name>",
    },
)

print(f"id: {external_key.id}")
print(f"display_name: {external_key.display_name}")

Ersetze die Platzhalter:

<friendly-name>: ein Anzeigename
https://<your-vault-name>.vault.azure.net/: die Vault-URI
<your-key-name>: der Schlüsselname
<your-tenant-id>: die Tenant-ID des Vaults

client = anthropic.Anthropic()

external_key = client.organization.external_keys.create(
    display_name="<friendly-name>",
    geo="us",
    provider_config={
        "type": "azure",
        "vault_uri": "https://<your-vault-name>.vault.azure.net/",
        "key_name": "<your-key-name>",
        "tenant_id": "<your-tenant-id>",
    },
)

print(f"id: {external_key.id}")
print(f"display_name: {external_key.display_name}")

Die id in der Antwort ist die ID des externen Schlüssels. Kopiere sie für die nächsten beiden Schritte.

{
  "type": "external_key",
  "id": "ekey_<id>",
  "display_name": "<friendly-name>"
}

Schlüssel validieren

Ersetze ekey_<id> durch die ID des externen Schlüssels.

client = anthropic.Anthropic()

validation = client.organization.external_keys.validate("ekey_<id>")

print(f"status: {validation.status}")
print(f"error: {validation.error}")

Eine erfolgreiche Antwort sieht so aus:

{ "type": "external_key_validation", "status": "success", "error": null }

Wenn status den Wert failure hat, gibt das Feld error den Grund an. Siehe Fehlerbehebung bei CMEK.

3
Den Schlüssel an einen Workspace anhängen
Das Anhängen eines Schlüssels kann nicht rückgängig gemacht werden. Wenn dein Schlüssel gelöscht wird, kann Anthropic die Daten, die er schützt, nicht wiederherstellen.
Ersetze <workspace-id> durch die Workspace-ID, die mit wrkspc_ beginnt, und ekey_<id> durch die externe Schlüssel-ID.
Python
client = anthropic.Anthropic() workspace = client.organization.workspaces.update( "<workspace-id>", external_key_id="ekey_<id>" ) print(f"id: {workspace.id}") print(f"external_key_id: {workspace.external_key_id}")
Die Antwort zeigt die ID des angehängten Schlüssels in external_key_id. Wenn die Anfrage abgelehnt wird, schlage den Fehler nach.

Bevor du beginnst

Den Schlüssel erstellen, validieren und anhängen

Den externen Schlüssel erstellen

Schlüssel validieren

Den Schlüssel an einen Workspace anhängen

Bevor du beginnst

Den Schlüssel erstellen, validieren und anhängen