AdminMenyiapkan CMEK

Menambahkan dan melampirkan kunci enkripsi dengan Admin API

Buat, validasi, dan lampirkan kunci enkripsi yang dikelola pelanggan dengan tiga panggilan Admin API.

Panggilan-panggilan ini berfungsi di Claude Platform. Di Claude Enterprise atau Claude Platform on AWS, ikuti halaman penyiapan Anda.

Membuat kunci eksternal adalah apa yang dilakukan Add key di Claude Console, dan memvalidasinya adalah apa yang dilakukan Verify.

Sebelum Anda memulai

"Customer-managed encryption keys" (kunci enkripsi yang dikelola pelanggan), atau CMEK, telah diaktifkan untuk organisasi Anda.
Anda memiliki kunci API Admin. Contoh-contoh membacanya dari ANTHROPIC_API_KEY.
Anda telah membuat kunci Anda di AWS KMS, Google Cloud KMS, atau Azure Key Vault, dan menyimpan nilai-nilai yang diminta untuk disalin oleh langkah-langkah penyiapan.
Anda memiliki workspace yang menyimpan data, idealnya workspace baru, karena data yang sudah ada tetap berada di bawah kunci milik Anthropic.

Membuat, memvalidasi, dan melampirkan kunci

Buat kunci eksternal

Ganti <friendly-name> dengan nama tampilan dan <key-arn-from-create-key-step> dengan ARN kunci.

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}")

Ganti <friendly-name> dengan nama tampilan. Ganti nilai yang diawali dengan projects/ dengan nama resource kunci lengkap.

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}")

Ganti placeholder berikut:

<friendly-name>: nama tampilan
https://<your-vault-name>.vault.azure.net/: URI vault
<your-key-name>: nama kunci
<your-tenant-id>: ID tenant vault

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}")

id dalam respons adalah ID kunci eksternal. Salin untuk dua langkah berikutnya.

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

Validasi kunci

Ganti ekey_<id> dengan ID kunci eksternal.

client = anthropic.Anthropic()

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

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

Respons yang berhasil terlihat seperti ini:

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

Jika status bernilai failure, field error menyebutkan alasannya. Lihat Memecahkan masalah CMEK.

3
Lampirkan kunci ke workspace
Melampirkan kunci tidak dapat dibatalkan. Jika kunci dihapus, Anthropic tidak dapat memulihkan data yang dilindunginya.
Ganti <workspace-id> dengan ID workspace, yang diawali dengan wrkspc_, dan ekey_<id> dengan ID kunci eksternal.
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}")
Respons menampilkan ID kunci yang dilampirkan di external_key_id. Jika permintaan ditolak, cari errornya.

Sebelum Anda memulai

Membuat, memvalidasi, dan melampirkan kunci

Buat kunci eksternal

Validasi kunci

Lampirkan kunci ke workspace

Sebelum Anda memulai

Membuat, memvalidasi, dan melampirkan kunci