Kunci Enkripsi yang Dikelola Pelanggan (CMEK) di Pengambilan Agen

Pengambilan Agen (sebelumnya Vector Search 2.0) memungkinkan Anda melindungi data yang tidak aktif menggunakan kunci kriptografi 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 agar dapat menggunakan CMEK dengan Koleksi:

  • Kunci Cloud KMS harus berada di Google Cloud region yang sama dengan Koleksi yang dilindunginya. Misalnya, Koleksi di region us-central1 harus menggunakan kunci KMS yang berlokasi di us-central1.

  • Anda harus memberikan peran cryptoKeyEncrypterDecrypter kepada Akun Layanan Per-Produk-Per-Project (P4) di kunci 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 diaktifkan.

Menggunakan gcloud CLI

Tentukan ID resource yang sepenuhnya memenuhi syarat dari kunci 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 di 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 diaktifkan.

Untuk melakukannya:

  1. Ekspor Objek Data Anda dari Koleksi yang ada ke bucket Cloud Storage.

  2. Buat Koleksi baru dengan CMEK diaktifkan.

  3. Impor Objek Data Anda ke Koleksi.

Rotasi kunci

Saat kunci dirotasi di 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 di-un-deploy dan data dalam memori akan dihapus. Operasi baca, tulis, dan penelusuran di Koleksi akan gagal.

Koleksi tidak akan otomatis diaktifkan kembali jika kunci dipulihkan.

Resource yang didukung CMEK

Resource Vertex AI saat ini 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 yang dibuat pengguna seperti AnnotationSpecs, ColumnSpecs.		 Membuat set data untuk klasifikasi pelatihan dan model regresi

Membuat set data untuk melatih model perkiraan
Indeks Semua file data yang digunakan untuk indeks Penelusuran Vektor yang disimpan di Cloud Storage, Pub/Sub, dan penyimpanan internal. Indeks 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