Perbarui referensi kunci eksternal

Halaman ini menunjukkan cara memperbarui referensi kunci eksternal untuk kunci Cloud EKM tanpa merotasi kunci. Referensi kunci baru harus mengarah ke materi kunci yang sama dengan referensi kunci saat ini. Jika materi kunci telah dirotasi di sistem partner pengelolaan kunci eksternal, Anda harus merotasi kunci.

Gunakan petunjuk di halaman ini jika sistem partner pengelolaan kunci eksternal Anda telah mengubah jalur kunci atau URI kunci untuk kunci yang ada. Misalnya, referensi kunci dapat berubah akibat perubahan nama host partner pengelolaan kunci eksternal atau perubahan struktur referensi kuncinya.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk memperbarui referensi kunci eksternal, minta administrator untuk memberi Anda peran IAM Admin Cloud KMS (roles/cloudkms.admin) pada kunci Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditentukan ini berisi izin cloudkms.cryptoKeyVersions.update, yang diperlukan untuk memperbarui referensi kunci eksternal.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengupdate URI untuk versi kunci tanpa rotasi

Guna memperbarui referensi kunci untuk kunci Cloud EKM yang Anda gunakan melalui internet, selesaikan langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Key Management.

    Buka Key Management

  2. Pilih key ring, lalu pilih kunci dan versinya.

  3. Klik More, lalu klik View key URI.

  4. Klik Update key URI.

  5. Masukkan URI kunci baru, lalu klik Save.

gcloud CLI

Untuk mengupdate URI versi kunci, gunakan perintah gcloud kms versions update:

gcloud kms keys versions update KEY_VERSION \
  --key KEY_NAME \
  --keyring KEY_RING \
  --location LOCATION \
  --external-key-uri NEW_KEY_URI

Ganti kode berikut:

  • KEY_VERSION: nomor versi kunci.
  • KEY_NAME: nama kunci.
  • KEY_RING: nama key ring yang berisi kunci.
  • LOCATION: lokasi Cloud KMS key ring.
  • NEW_KEY_URI: URI baru untuk materi kunci eksternal yang ada.

Memperbarui jalur kunci untuk versi kunci tanpa rotasi

Guna memperbarui referensi kunci untuk kunci Cloud EKM yang Anda gunakan melalui jaringan VPC, selesaikan langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Key Management.

    Buka Key Management

  2. Pilih key ring, lalu pilih kunci dan versinya.

  3. Klik More lalu View key path.

  4. Klik Update key path.

  5. Masukkan jalur kunci baru, lalu klik Save.

gcloud CLI

Untuk memperbarui jalur kunci versi kunci, gunakan perintah gcloud kms versions update:

gcloud kms keys versions update KEY_VERSION \
  --key KEY_NAME \
  --keyring KEY_RING \
  --location LOCATION \
  --ekm-connection-key-path NEW_KEY_PATH

Ganti kode berikut:

  • KEY_VERSION: nomor versi kunci.
  • KEY_NAME: nama kunci.
  • KEY_RING: nama key ring yang berisi kunci.
  • LOCATION: lokasi Cloud KMS key ring.
  • NEW_KEY_PATH: jalur baru untuk material kunci eksternal yang ada.