Untuk memperbarui kredensial yang digunakan Pod untuk melakukan autentikasi, Anda dapat merotasi key pair yang digunakan Google Distributed Cloud untuk menandatangani token akun layanan Kubernetes (KSA) yang dikeluarkan untuk Pod di cluster pengguna. Rotasi ini menggantikan kunci pribadi dan publik, menerbitkan ulang token yang ditandatangani oleh kunci pribadi baru, dan memberikan Google Cloud kunci publik baru untuk autentikasi Workload Identity. Rotasi kunci tidak didukung di cluster lanjutan.
Tentang kunci penandatanganan KSA
KSA memberikan identitas untuk proses yang berjalan di Pod. KSA berbeda dengan Google Cloud akun layanan, yang digunakan aplikasi untuk melakukan panggilan resmi ke API Google Cloud .
Google Distributed Cloud menggunakan kunci pribadi untuk menandatangani token KSA yang dikeluarkan untuk Pod, dan kunci publik yang sesuai untuk memvalidasi token saat Pod mengirim permintaan ke server Kubernetes API. Saat Pod menggunakan Workload Identity untuk memanggil API Google Cloud , Google Cloud menggunakan kunci publik yang sama untuk mengautentikasi identitas Pod. Selama pembuatan cluster pengguna, Google Distributed Cloud membuat pasangan kunci, mendaftarkan cluster ke fleet, dan memberikan kunci publik ke Google Cloud.
Token terikat dan token lama
Pod dapat menggunakan token lama atau token terikat untuk autentikasi dan otorisasi saat memanggil server Kubernetes API. Token terikat memiliki masa berlaku terbatas dan didistribusikan ke Pod menggunakan volume yang diproyeksikan. Token lama tidak pernah habis masa berlakunya dan disimpan di Secret Kubernetes. Sebaiknya gunakan token terikat karena lebih aman.
Token terikat dan token lama diperbarui selama rotasi kunci.
Batasan
- Jika Anda membuat cluster dengan
enableAdvancedClusteryang ditetapkan ketrue(yang diperlukan untuk menyiapkan domain topologi), rotasi kunci tidak didukung.
Memulai rotasi kunci
Sebelum Anda memulai rotasi kunci, pertimbangkan poin-poin berikut:
Selama rotasi kunci, Anda tidak dapat memulai rotasi kunci, rotasi certificate authority, atau update cluster lainnya.
Rotasi kunci tidak dapat dijeda atau di-roll back. Semua kunci lama dihapus.
Rotasi kunci akan menghapus node cluster yang ada dan membuat node baru.
Untuk memulai rotasi kunci:
gkectl update credentials ksa-signing-key rotate \
--config USER_CLUSTER_CONFIG \
--kubeconfig ADMIN_KUBECONFIG_FILE \
[--skip-prompt]
Ganti kode berikut:
USER_CLUSTER_CONFIG: Jalur file konfigurasi cluster pengguna
ADMIN_KUBECONFIG_FILE: Jalur file kubeconfig cluster admin
Sertakan --skip-prompt jika Anda tidak ingin diminta.
Melihat status rotasi kunci
Untuk melihat status rotasi kunci:
gkectl update credentials ksa-signing-key status \
--config USER_CLUSTER_CONFIG \
--kubeconfig ADMIN_KUBECONFIG_FILE
Jika rotasi kunci telah selesai, Anda akan melihat pesan seperti ini:
State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: True,
reason: KSASigningKeyRotationCompleted,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[2]}
Jika rotasi kunci penandatanganan KSA masih berlangsung, Anda akan melihat pesan yang mirip dengan ini:
State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: False,
reason: KSASigningKeyRotationProcessedReason,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[1,2]}