Kunci enkripsi yang dikelola pelanggan (CMEK) di Agent Retrieval

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-central1 harus menggunakan kunci Cloud KMS yang berada di us-central1.

  • Anda harus memberikan peran cryptoKeyEncrypterDecrypter kepada 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:

  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 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