Agent Retrieval (sebelumnya Penelusuran Vektor 2.0) memungkinkan Anda melindungi data dalam penyimpanan menggunakan kunci kriptografis yang dikelola melalui Cloud Key Management Service. Integrasi ini memberikan kontrol atas kunci yang digunakan untuk mengenkripsi konten pelanggan inti, termasuk kemampuan untuk merotasi dan mencabut kunci tersebut.
Secara default, data dienkripsi menggunakan default platform yang dikelola Google. CMEK memberi Anda kontrol langsung atas kunci enkripsi.
Untuk mengetahui informasi selengkapnya, buka dokumentasi Kunci enkripsi yang dikelola pelanggan (CMEK).
Prasyarat dan batasan
Prasyarat dan batasan berikut harus dipenuhi untuk menggunakan CMEK dengan Koleksi:
Kunci Cloud KMS harus berada di region yang sama dengan Google Cloud Koleksi yang dilindunginya. Misalnya, Koleksi di region
us-central1harus menggunakan kunci Cloud KMS yang berada dius-central1.Anda harus memberikan peran
cryptoKeyEncrypterDecrypterkepada Akun Layanan Per Produk Per Project (P4) pada kunci Cloud KMS Anda. Akun Layanan P4 mengikuti format ini:service-${CONSUMER_PROJECT_NUMBER}@gcp-sa-vectorsearch.iam.gserviceaccount.com
Membuat Koleksi yang dilindungi CMEK
Setelah memenuhi semua prasyarat, Anda dapat menggunakan gcloud CLI, REST API, atau Python SDK untuk membuat Koleksi baru dengan CMEK yang diaktifkan.
Menggunakan gcloud CLI
Tentukan ID resource yang sepenuhnya memenuhi syarat dari kunci Cloud KMS Anda menggunakan argumen --kms-key:
gcloud vector-search collections create [COLLECTION_ID] \
--kms-key projects/[KMS_PROJECT_ID]/locations/[REGION]/keyRings/[KEY_RING]/cryptoKeys/[KEY]
Menggunakan REST API
Sertakan encryption_spec dalam isi permintaan POST Anda:
{
"encryption_spec": {
"crypto_key_name": "projects/[PROJECT_ID]/locations/[REGION]/keyRings/[KEY_RING]/cryptoKeys/[KEY]"
}
}
Menggunakan Python SDK
Menggunakan Python SDK:
request = vectorsearch_v1beta.CreateCollectionRequest(
parent=f"projects/{PROJECT_ID}/locations/{LOCATION}",
collection_id=collection_id,
collection={
"data_schema": {...},
"vector_schema": {...},
# Specifies the customer-managed encryption key spec for a Collection
"encryption_spec": {
"crypto_key_name": f"projects/{PROJECT_ID}/locations/{LOCATION}/keyRings/{KEY_RING}/cryptoKeys/{KEY}"
}
},
)
operation = vector_search_service_client.create_collection(request=request)
operation.result()
Memigrasikan Objek Data dari Koleksi non-CMEK ke Koleksi yang mendukung CMEK
CMEK tidak dapat diaktifkan untuk Koleksi yang ada. Sebagai gantinya, Anda harus memigrasikan Objek Data ke Koleksi baru dengan CMEK yang diaktifkan.
Untuk melakukannya:
Ekspor Objek Data Anda dari Koleksi yang ada ke bucket Cloud Storage.
Buat Koleksi baru dengan CMEK diaktifkan.
Impor Objek Data Anda ke dalam Koleksi.
Rotasi kunci
Saat kunci dirotasi di Cloud KMS, data baru dienkripsi menggunakan versi kunci utama, sedangkan data yang ada tetap dienkripsi dengan versi sebelumnya. Untuk mengetahui detail selengkapnya, lihat Rotasi kunci.
Pencabutan kunci
Mencabut atau menonaktifkan kunci akan langsung menonaktifkan Koleksi. Indeks ANN terkait akan otomatis dibatalkan deployment-nya dan data dalam memori akan dihapus. Operasi baca, tulis, dan telusur pada Koleksi akan gagal.
Koleksi tidak akan otomatis diaktifkan kembali jika kunci dipulihkan.
Resource yang didukung CMEK
Resource Gemini Enterprise Agent Platform yang dicakup oleh CMEK adalah sebagai berikut. Dukungan CMEK untuk fitur Pratinjau juga sedang dalam status Pratinjau.
| Resource | Material dienkripsi | Link dokumentasi |
|---|---|---|
| Dataset | Semua data yang diimpor pengguna (misalnya, konten teks) untuk DataItems dan Annotations.
Konten buatan pengguna seperti AnnotationSpecs, ColumnSpecs. |
Membuat set data untuk melatih model klasifikasi dan model regresi
Membuat set data untuk melatih model perkiraan |
| Indeks | Semua file data yang digunakan untuk Penelusuran Vektor di indeks Gemini Enterprise Agent Platform yang disimpan di Cloud Storage, Pub/Sub, dan penyimpanan internal. Index dan IndexEndpoint harus dibuat dengan kunci yang sama.
Semua indeks dalam Koleksi harus dibuat dengan kunci yang sama. |
Mengelola indeks di Penelusuran Vektor :
Mengelola indeks di Penelusuran Vektor 2 |
| Koleksi | Koleksi digunakan untuk menyimpan Objek Data terkait. | Mengelola koleksi di Penelusuran Vektor 2 |
| DataObjects | Koleksi menyimpan data sebagai objek JSON individual yang disebut Objek Data. | Mengelola Objek Data di Penelusuran Vektor 2 |