Membuat kunci enkripsi dengan Cloud KMS
Panduan memulai ini menggunakan command line untuk mengirim permintaan ke Cloud KMS API. Untuk mengetahui contoh pemrograman yang menggunakan library klien untuk mengirim permintaan ke Cloud KMS API, lihat Mengenkripsi dan Mendekripsi.
Sebelum memulai
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Make sure that billing is enabled for your Google Cloud project.
-
Aktifkan API Cloud KMS.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Make sure that billing is enabled for your Google Cloud project.
-
Aktifkan API Cloud KMS.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Key ring dan kunci
Untuk mengenkripsi dan mendekripsi konten, Anda memerlukan kunci Cloud KMS, yang merupakan bagian dari key ring.
Buat key ring bernama test
, dan kunci bernama quickstart
. Lihat ringkasan hierarki objek untuk mengetahui informasi selengkapnya tentang objek ini dan kaitannya.
gcloud kms keyrings create "test" \
--location "global"
gcloud kms keys create "quickstart" \
--location "global" \
--keyring "test" \
--purpose "encryption"
Anda dapat menggunakan opsi list
untuk melihat nama dan metadata kunci yang baru saja dibuat.
gcloud kms keys list \
--location "global" \
--keyring "test"
Anda akan melihat:
NAME PURPOSE PRIMARY_STATE projects/project-id/locations/global/keyRings/test/cryptoKeys/quickstart ENCRYPT_DECRYPT ENABLED
Mengenkripsi data
Setelah memiliki kunci, Anda dapat menggunakan kunci tersebut untuk mengenkripsi teks atau konten biner.
Simpan beberapa teks yang akan dienkripsi dalam file bernama "mysecret.txt".
echo -n "Some text to be encrypted" > mysecret.txt
Untuk mengenkripsi data dengan gcloud kms encrypt
, berikan informasi kunci Anda,
tentukan nama file teks biasa yang akan dienkripsi, dan tentukan nama
file yang akan berisi konten terenkripsi:
gcloud kms encrypt \
--location "global" \
--keyring "test" \
--key "quickstart" \
--plaintext-file ./mysecret.txt \
--ciphertext-file ./mysecret.txt.encrypted
Metode encrypt
menyimpan konten terenkripsi Anda dalam file yang ditentukan oleh flag --ciphertext-file
.
Mendekripsi ciphertext
Untuk mendekripsi data dengan gcloud kms decrypt
, berikan informasi kunci Anda,
tentukan nama file terenkripsi (file ciphertext) yang akan didekripsi, dan tentukan
nama file yang akan berisi konten yang didekripsi:
gcloud kms decrypt \
--location "global" \
--keyring "test" \
--key "quickstart" \
--ciphertext-file ./mysecret.txt.encrypted \
--plaintext-file ./mysecret.txt.decrypted
Metode decrypt
menyimpan konten yang didekripsi dalam file yang ditentukan oleh
tanda --plaintext-file
.
Untuk mendekripsi konten terenkripsi, Anda harus menggunakan kunci yang sama dengan yang digunakan untuk mengenkripsi konten tersebut.
Pembersihan
Agar akun Google Cloud Anda tidak dikenakan biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.
Cantumkan versi yang tersedia untuk kunci Anda:
gcloud kms keys versions list \
--location "global" \
--keyring "test" \
--key "quickstart"
Untuk menghancurkan versi, jalankan perintah berikut, dengan mengganti key-version dengan nomor versi kunci yang akan dihancurkan:
gcloud kms keys versions destroy key-version \ --location "global" \ --keyring "test" \ --key "quickstart"
Langkah selanjutnya
- Mulai menggunakan API.
- Lihat Referensi API.
- Pelajari lebih lanjut cara mengenkripsi data dalam penyimpanan.