Enkripsi data dalam penyimpanan sandbox dengan kunci Cloud Key Management Service yang Anda miliki dan kontrol.
Ringkasan
Secara default, Google Cloud mengenkripsi data dalam penyimpanan Anda dengan Google-owned and Google-managed encryption keys. Kunci enkripsi yang dikelola pelanggan (CMEK) memungkinkan Anda membuat dan mengelola kunci enkripsi Cloud KMS sehingga Anda dapat mengaudit penggunaannya, merotasinya, dan menonaktifkan atau menghancurkannya untuk membuat data yang dilindungi tidak dapat dibaca.
Sandbox Gemini Enterprise Agent Platform menjalankan kode, browser, atau container kustom agen Anda di lingkungan yang terisolasi. Lingkungan tersebut menulis konten pelanggan ke disk dan dapat di-checkpoint ke snapshot, yang dilindungi CMEK saat Anda mengaktifkannya di instance Gemini Enterprise Agent Platform induk sandbox.
Anda hanya dapat mengonfigurasi CMEK untuk sandbox Gemini Enterprise Agent Platform saat membuat instance Gemini Enterprise Agent Platform. Kunci CMEK mengamankan instance Gemini Enterprise Agent Platform dan sub-resource-nya, termasuk lingkungan sandbox, template, dan snapshot.
Yang dienkripsi CMEK untuk sandbox
Mengaktifkan CMEK pada instance Gemini Enterprise Agent Platform induk akan mengenkripsi platform dalam penyimpanan sandbox dengan kunci Anda:
- Boot disk node GKE/sistem file root: File yang ditulis sesi saat runtime dan status dalam memori yang di-page ke disk (CMEK boot-disk node).
- Bucket Cloud Storage snapshot: Checkpoint disk dan memori sandbox (snapshot) (enkripsi default bucket).
Metadata resource (nama, label, status, info koneksi), serta variabel lingkungan dan email akun layanan tidak dienkripsi dengan kunci CMEK.
Untuk mengenkripsi image container kustom, tetapkan CMEK di repositori Artifact Registry Anda sendiri.
Batasan dan pertimbangan
- Hanya kunci satu region yang didukung untuk CMEK di Gemini Enterprise Agent Platform. Kunci multi-region, region ganda, dan global tidak didukung.
- Kunci tidak dapat diubah saat Anda membuat instance Gemini Enterprise Agent Platform. Untuk menggunakan kunci yang berbeda, Anda harus membuat instance Gemini Enterprise Agent Platform baru. Rotasi ke versi baru dari kunci yang sama didukung dan diterapkan secara otomatis.
- Jika Anda menonaktifkan atau menghancurkan versi kunci, atau mencabut peran Encrypter/Decrypter, sandbox tidak dapat disediakan atau dilanjutkan, dan penulisan snapshot akan gagal. Pulihkan akses kunci untuk memulihkan resource sandbox.
Sebelum memulai
- Memiliki atau membuat key ring dan kunci Cloud KMS. Sebagai praktik terbaik, simpan kunci di project terpisah dari workload Gemini Enterprise Agent Platform Anda, yang dikelola oleh administrator yang berbeda.
- Pastikan Anda memiliki peran untuk membuat dan mengelola kunci (
roles/cloudkms.admin) serta membuat instance Gemini Enterprise Agent Platform. Buat agen layanan Agent Runtime, jika Anda belum memilikinya:
# Create the service agent if needed gcloud beta services identity create \ --service=aiplatform.googleapis.com \ --project=PROJECT_ID
Membuat kunci Cloud KMS
Buat kunci satu region di region yang sama dengan instance Gemini Enterprise Agent Platform Anda:
# Key ring (once per region)
gcloud kms keyrings create sandbox-keyring \
--location=REGION
# Key
gcloud kms keys create sandbox-key \
--location=REGION \
--keyring=sandbox-keyring \
--purpose=encryption
Ganti kode berikut:
REGION: Region Google Cloud instance Gemini Enterprise Agent Platform Anda (misalnya,us-central1).
Memberi agen layanan Agent Platform akses ke kunci Anda
Berikan peran Cloud KMS CryptoKey Encrypter/Decrypter (roles/cloudkms.cryptoKeyEncrypterDecrypter) pada kunci kepada agen layanan Agent Runtime:
# Grant Encrypter/Decrypter on the key
gcloud kms keys add-iam-policy-binding sandbox-key \
--location=REGION \
--keyring=sandbox-keyring \
--member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com" \
--role="roles/cloudkms.cryptoKeyEncrypterDecrypter"
Ganti kode berikut:
PROJECT_NUMBER: Nomor project Google Cloud Anda.
Mengaktifkan CMEK di instance Agent Platform
Tetapkan encryption_spec.kms_key_name saat Anda membuat instance Gemini Enterprise Agent Platform. Setiap template sandbox dan sandbox yang Anda buat di dalamnya akan mewarisi kunci ini.
Python SDK
import vertexai
client = vertexai.Client(project="PROJECT_ID", location="REGION",
http_options={"api_version": "v1beta1"})
agent_instance = client.agent_engines.create(
config={
"encryption_spec": {
"kms_key_name":
"projects/PROJECT_ID/locations/REGION/keyRings/sandbox-keyring/cryptoKeys/sandbox-key"
}
},
)
REST
Dengan menggunakan REST API, tetapkan nilai yang sama di reasoningEngines.encryptionSpec.kmsKeyName saat pembuatan:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/reasoningEngines \
-d '{
"display_name": "cmek-protected-engine",
"encryption_spec": {
"kms_key_name": "projects/PROJECT_ID/locations/REGION/keyRings/sandbox-keyring/cryptoKeys/sandbox-key"
}
}'
Membuat sandbox dan memverifikasi konfigurasi CMEK
- Buat template sandbox dan sandbox Anda di instance Gemini Enterprise Agent Platform yang dilindungi CMEK.
- Konfirmasi bahwa instance Gemini Enterprise Agent Platform melaporkan kunci Anda di
encryption_spec.kms_key_namedengan mendapatkan detail instance. - Secara opsional, periksa log audit Cloud KMS untuk mengonfirmasi bahwa operasi enkripsi dan dekripsi terjadi saat sandbox dimulai dan snapshot ditulis.
Langkah berikutnya
- Baca CMEK untuk Gemini Enterprise Agent Platform.
- Lihat Men-deploy agen untuk mengaktifkan CMEK di Agent Runtime.
- Tinjau integrasi CMEK dan rotasi kunci di Cloud KMS.
- Baca Ringkasan sandbox dan Mengelola snapshot.