Halaman ini menunjukkan cara mengambil bagian kunci publik dari versi kunci asimetris yang diaktifkan.
Untuk algoritma komputasi pasca-kuantum (PQC) (Pratinjau), kunci publiknya dalam format yang diidentifikasi dalam standar PQC NIST FIPS-203, FIPS-204, dan FIPS-205. Untuk semua algoritma lainnya (non-PQC), kunci publik dalam format Privacy-enhanced Electronic Mail (PEM). Untuk mengetahui informasi selengkapnya, lihat bagian RFC 7468 untuk Pertimbangan Umum dan Enkode Tekstual Info Kunci Publik Subjek.
Peran yang diperlukan
Untuk mendapatkan izin yang
diperlukan untuk mengambil kunci publik,
minta administrator untuk memberi Anda
Peran IAM Cloud KMS CryptoKey Public Key Viewer (roles/cloudkms.publicKeyViewer
)
di kunci Anda atau resource induk.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk mengambil kunci publik. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengambil kunci publik:
-
cloudkms.cryptoKeyVersions.viewPublicKey
-
cloudkms.locations.get
-
cloudkms.locations.list
-
resourcemanager.projects.get
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Mengambil kunci publik
Anda dapat menentukan format yang diinginkan untuk mengambil kunci publik.
Jika format ditentukan, kunci akan ditampilkan dalam format yang ditentukan
di kolom public_key
respons. Jika tidak, ID tersebut akan ditampilkan di kolom
pem
respons.
Untuk mendownload kunci publik untuk versi kunci asimetris yang diaktifkan:
Konsol
Di Google Cloud console, buka halaman Key Management.
Klik nama key ring yang berisi kunci asimetris yang ingin Anda ambil kunci publiknya.
Klik nama kunci yang ingin Anda ambil kunci publiknya.
Pada baris yang sesuai dengan versi kunci yang ingin Anda ambil kunci publiknya, klik Lihat Selengkapnya
.Klik Dapatkan kunci publik.
Kunci publik ditampilkan dalam perintah. Anda dapat menyalin kunci publik ke papan klip Anda. Untuk mendownload kunci publik, klik Download.
Jika Anda tidak melihat opsi Get public key, verifikasi hal berikut:
- Kunci adalah kunci asimetris.
- Versi kunci diaktifkan.
- Anda memiliki izin
cloudkms.cryptoKeyVersions.viewPublicKey
.
Nama file kunci publik yang didownload dari konsol Google Cloud memiliki bentuk:
KEY_RING-KEY_NAME-KEY_VERSION.pub
Setiap bagian nama file dipisahkan dengan tanda hubung, misalnya
ringname-keyname-version.pub
gcloud
Untuk menggunakan Cloud KMS di command line, Instal atau upgrade ke versi terbaru Google Cloud CLI terlebih dahulu.
gcloud kms keys versions get-public-key KEY_VERSION \ --key KEY_NAME \ --keyring KEY_RING \ --location LOCATION \ --public-key-format PUBLIC_KEY_FORMAT \ --output-file OUTPUT_FILE_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.PUBLIC_KEY_FORMAT
: format yang Anda inginkan untuk mengekspor kunci publik. Untuk algoritma PQC (Pratinjau), gunakannist-pqc
. Untuk semua kunci lainnya, Anda dapat menggunakanpem
atau menghilangkan parameter ini.OUTPUT_FILE_PATH
: jalur tempat Anda ingin menyimpan file kunci publik—misalnya,public-key.pub
.
Untuk mengetahui informasi tentang semua flag dan kemungkinan nilai, jalankan perintah dengan flag --help
.
C#
Untuk menjalankan kode ini, siapkan lingkungan pengembangan C# terlebih dahulu dan instal SDK C# Cloud KMS.
Go
Untuk menjalankan kode ini, siapkan lingkungan pengembangan Go terlebih dahulu dan instal Cloud KMS Go SDK.
Java
Untuk menjalankan kode ini, siapkan lingkungan pengembangan Java terlebih dahulu dan instal Cloud KMS Java SDK.
Node.js
Untuk menjalankan kode ini, siapkan lingkungan pengembangan Node.js terlebih dahulu dan instal Cloud KMS Node.js SDK.
PHP
Untuk menjalankan kode ini, pelajari terlebih dahulu cara menggunakan PHP di Google Cloud dan instal Cloud KMS PHP SDK.
Python
Untuk menjalankan kode ini, siapkan lingkungan pengembangan Python terlebih dahulu dan instal Cloud KMS Python SDK.
Ruby
Untuk menjalankan kode ini, siapkan lingkungan pengembangan Ruby terlebih dahulu dan instal Cloud KMS Ruby SDK.
API
Contoh ini menggunakan curl sebagai klien HTTP untuk menunjukkan penggunaan API. Untuk mengetahui informasi selengkapnya tentang kontrol akses, lihat Mengakses Cloud KMS API.
Ambil kunci publik dengan memanggil metode CryptoKeyVersions.getPublicKey.
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME/cryptoKeyVersions/KEY_VERSION/publicKey?public_key_format=PUBLIC_KEY_FORMAT" \ --request "GET" \ --header "authorization: Bearer TOKEN"
Ganti kode berikut:
PROJECT_ID
: ID project yang berisi key ring.LOCATION
: lokasi Cloud KMS key ring.KEY_RING
: nama key ring yang berisi kunci.KEY_NAME
: nama kunci.KEY_VERSION
: nomor versi kunci.PUBLIC_KEY_FORMAT
: format yang Anda inginkan untuk mengekspor kunci publik. Untuk algoritma PQC (Pratinjau), gunakanNIST_PQC
. Untuk semua kunci lainnya, Anda dapat menggunakanPEM
atau menghilangkan parameter ini.
Jika format kunci publik dihilangkan untuk kunci non-PQC, outputnya akan mirip dengan berikut ini:
{ "pem": "-----BEGIN PUBLIC KEY-----\nQ29uZ3JhdHVsYXRpb25zLCB5b3UndmUgZGlzY292ZX JlZCB0aGF0IHRoaXMgaXNuJ3QgYWN0dWFsbHkgYSBwdWJsaWMga2V5ISBIYXZlIGEgbmlj ZSBkYXkgOik=\n-----END PUBLIC KEY-----\n", "algorithm": "ALGORITHM", "pemCrc32c": "2561089887", "name": "projects/PROJECT_ID/locations/LOCATION/keyRings/ KEY_RING/cryptoKeys/KEY_NAME/cryptoKeyVersions/ KEY_VERSION", "protectionLevel": "PROTECTION_LEVEL" }
Untuk algoritma PQC dengan format kunci publik NIST_PQC
, outputnya mirip dengan
berikut:
{ "publicKeyFormat": "NIST_PQC", "publicKey": { "crc32cChecksum": "1985843562", "data": "kdcOIrFCC5kN8S4i0+R+AoSc9gYIJ9jEQ6zG235ZmCQ=" } "algorithm": "ALGORITHM", "name": "projects/PROJECT_ID/locations/LOCATION/keyRings/ KEY_RING/cryptoKeys/KEY_NAME/cryptoKeyVersions/ KEY_VERSION", "protectionLevel": "PROTECTION_LEVEL" }