Menggunakan kunci enkripsi yang dikelola pelanggan (CMEK)

Secara default, Cloud Scheduler mengenkripsi konten pelanggan dalam penyimpanan. Cloud Scheduler menangani enkripsi untuk Anda tanpa tindakan tambahan dari Anda. Opsi ini disebut Enkripsi default Google.

Jika ingin mengontrol kunci enkripsi, Anda dapat menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) di Cloud KMS dengan layanan yang terintegrasi dengan CMEK, termasuk Cloud Scheduler. Dengan menggunakan kunci Cloud KMS, Anda dapat mengontrol tingkat perlindungan, lokasi, jadwal rotasi, izin penggunaan dan akses, serta batasan kriptografisnya. Dengan Cloud KMS, Anda juga dapat melihat log audit dan mengontrol siklus proses kunci. Bukan Google yang memiliki dan mengelola kunci enkripsi kunci (KEK) simetris yang melindungi data Anda. Andalah yang mengontrol dan mengelola kunci ini di Cloud KMS.

Setelah Anda menyiapkan resource dengan CMEK, pengalaman mengakses resource Cloud Scheduler Anda akan serupa dengan menggunakan enkripsi default Google. Untuk mengetahui informasi selengkapnya tentang opsi enkripsi, lihat Kunci enkripsi yang dikelola pelanggan (CMEK).

Yang dilindungi oleh CMEK

Anda dapat menentukan kunci Cloud KMS per project Google Cloud dan per region Cloud Scheduler yang didukung. Kunci ini digunakan untuk melindungi data berikut dalam project dan region tersebut:

  • Tugas dengan target endpoint HTTP atau HTTPS: isi permintaan HTTP dan header pelanggan.
  • Tugas dengan target topik Pub/Sub: payload dan atribut pesan Pub/Sub.

Sebelum memulai

Sebelum menggunakan CMEK di Cloud Scheduler, selesaikan langkah-langkah prasyarat berikut.

  1. Menyiapkan lingkungan Anda

  2. Update komponen gcloud.

    gcloud components update

  3. Login menggunakan akun Anda.

    gcloud auth login

  4. Aktifkan Cloud KMS API untuk project yang menyimpan kunci enkripsi Anda:

    gcloud services enable cloudkms.googleapis.com \
        --project=KMS_PROJECT_ID

    Ganti KMS_PROJECT_ID dengan ID project yang menyimpan kunci Cloud KMS Anda. Project ini dapat berupa project yang sama dengan tugas Cloud Scheduler Anda atau project terpisah.

  5. Cloud KMS menghasilkan Cloud Audit Logs saat kunci diaktifkan, dinonaktifkan, atau digunakan oleh resource Cloud Scheduler untuk mengenkripsi dan mendekripsi data.

    Pastikan logging diaktifkan untuk Cloud KMS API di project Anda dan Anda telah memutuskan izin dan peran khusus logging yang berlaku untuk kasus penggunaan Anda. Untuk mengetahui informasi selengkapnya, lihat Logging audit Cloud KMS.

Peran yang diperlukan

Agar mendapatkan izin yang diperlukan untuk mengonfigurasi CMEK untuk Cloud Scheduler, minta administrator untuk memberi Anda peran IAM berikut:

  • Beri agen layanan akses ke kunci: Cloud KMS Admin (roles/cloudkms.admin) pada kunci, key ring, atau project yang berisi kunci Cloud KMS
  • Mengaktifkan atau menonaktifkan CMEK: Cloud Scheduler Admin (roles/cloudscheduler.admin) di project Cloud Scheduler
  • Lihat status operasi atau konfigurasi CMEK:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengonfigurasi CMEK untuk Cloud Scheduler. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengonfigurasi CMEK untuk Cloud Scheduler:

  • Beri agen layanan akses ke kunci: cloudkms.cryptoKeys.setIamPolicy pada kunci, key ring, atau project yang berisi kunci Cloud KMS
  • Aktifkan atau nonaktifkan CMEK: cloudscheduler.cmekConfig.update di project Cloud Scheduler
  • Lihat status operasi atau konfigurasi CMEK:
    • cloudscheduler.cmekConfig.get di project Cloud Scheduler
    • cloudscheduler.operations.get di project Cloud Scheduler

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

Membuat key ring dan kunci Cloud KMS

Anda dapat membuat key ring baru atau menggunakan key ring yang sudah ada. Dalam key ring, Anda dapat menambahkan kunci baru atau menggunakan kunci yang ada. Sebaiknya gunakan kunci yang berbeda untuk aplikasi, layanan, atau lingkungan yang berbeda.

  1. Buat key ring.

  2. Buat kunci. Kunci harus menggunakan algoritma enkripsi simetris.

Memberi agen layanan Cloud Scheduler akses ke kunci

Anda harus memberikan peran Identity and Access Management (IAM) Cloud KMS CryptoKey Encrypter/Decrypter kepada agen layanan Cloud Scheduler agar dapat mengakses kunci Cloud KMS. Jika Anda baru saja mengaktifkan Cloud Scheduler API dalam sebuah project dan belum membuat tugas apa pun, Anda mungkin perlu membuat agen layanan terlebih dahulu dengan menjalankan gcloud beta services identity create --service=cloudscheduler.googleapis.com --project=PROJECT_ID.

gcloud kms keys add-iam-policy-binding KEY_NAME \
    --keyring=KEY_RING \
    --location=LOCATION \
    --project=KMS_PROJECT_ID \
    --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-cloudscheduler. \
    --role=roles/cloudkms.cryptoKeyEncrypterDecrypter

Ganti kode berikut:

  • KEY_NAME: nama kunci—misalnya, my-key.
  • KEY_RING: nama key ring—misalnya, my-keyring.
  • LOCATION: lokasi kunci—misalnya, us-central1.
  • KMS_PROJECT_ID: ID project tempat kunci Cloud KMS berada.
  • PROJECT_NUMBER: nomor project dari project Cloud Scheduler Google Cloud Anda. Anda dapat menemukan nomor project di halaman Welcome pada konsol Google Cloud atau dengan menjalankan perintah berikut:

    export PROJECT=$(gcloud info --format='value(config.project)')
    gcloud projects describe ${PROJECT} --format="value(projectNumber)"

Selama agen layanan memiliki peran roles/cloudkms.cryptoKeyEncrypterDecrypter, tugas dalam project Anda dapat mengenkripsi dan mendekripsi datanya menggunakan kunci CMEK. Jika Anda mencabut peran ini, atau jika Anda menonaktifkan atau menghancurkan kunci CMEK, data tersebut tidak dapat diakses. Dalam dokumen ini, lihat Menghapus Cloud KMS.

Mengaktifkan CMEK untuk region Cloud Scheduler

Tentukan kunci Cloud KMS yang akan digunakan untuk enkripsi data di region Cloud Scheduler menggunakan perintah gcloud scheduler cmek-config update:

gcloud scheduler cmek-config update \
    --location=LOCATION \
    --kms-key-name=KEY_NAME \
    --kms-keyring=KEY_RING \
    --kms-project=KMS_PROJECT_ID

Ganti kode berikut:

  • LOCATION: region Cloud Scheduler yang didukung.
  • KEY_NAME: nama kunci—misalnya, my-key.
  • KEY_RING: nama key ring—misalnya, my-keyring.
  • KMS_PROJECT_ID: ID project tempat kunci Cloud KMS yang ingin Anda gunakan berada.

Perhatikan hal berikut:

  • Mengaktifkan, mengubah, atau menonaktifkan kunci CMEK di Cloud Scheduler berjalan secara asinkron dan menampilkan operasi yang berjalan lama (projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID). Anda dapat memeriksa apakah update telah selesai dengan menjalankan perintah gcloud scheduler operations describe.
  • Cloud Scheduler mengenkripsi tugas baru dan yang diupdate di project dan region yang dilindungi dengan kunci yang diaktifkan. Tugas yang ada dan sebelumnya dienkripsi dengan kunci sebelumnya akan dienkripsi ulang dengan kunci baru.
  • Tugas yang ada dan tidak dilindungi akan dienkripsi.
  • Merotasi kunci di Cloud KMS tidak akan otomatis mengenkripsi ulang tugas yang ada atau mengalihkan tugas baru di region tersebut ke versi kunci utama yang baru. Untuk mengetahui informasi selengkapnya, lihat Rotasi kunci CMEK.
  • Jika Anda menonaktifkan CMEK untuk suatu region, tugas yang ada akan dienkripsi menggunakan enkripsi default Google, dan tugas berikutnya akan dibuat tanpa enkripsi CMEK. Dalam dokumen ini, lihat Menonaktifkan CMEK untuk region Cloud Scheduler.

Memverifikasi konfigurasi Cloud KMS

Pastikan CMEK diaktifkan dengan mengambil konfigurasi CMEK untuk region Cloud Scheduler menggunakan perintah gcloud scheduler cmek-config describe:

gcloud scheduler cmek-config describe \
    --location=LOCATION

Outputnya mirip dengan hal berikut ini:

kmsKeyName: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME
name: projects/PROJECT_ID/locations/LOCATION/cmekConfig

Nilai kmsKeyName adalah ID resource kunci Cloud KMS yang digunakan untuk mengamankan tugas di region tersebut.

Menonaktifkan CMEK untuk region Cloud Scheduler

Anda dapat menonaktifkan CMEK untuk region Cloud Scheduler sehingga tugas apa pun yang dibuat di region tersebut dibuat tanpa enkripsi CMEK.

gcloud scheduler cmek-config update \
    --location=LOCATION \
    --clear-kms-key

Tindakan ini akan menonaktifkan CMEK untuk region tertentu dan tugas berikutnya akan dibuat tanpa enkripsi CMEK. Tugas yang ada dienkripsi menggunakan enkripsi default Google.

Menghapus Cloud KMS

Jika ingin mencabut akses data ke tugas, Anda dapat menghapus Cloud KMS dengan salah satu cara berikut:

  • Nonaktifkan atau hancurkan versi kunci yang sesuai dari kunci enkripsi yang dikelola pelanggan. Anda dapat memeriksa apakah versi kunci sedang digunakan. Menonaktifkan versi kunci CMEK akan menangguhkan akses ke semua data yang dilindungi oleh versi kunci tersebut hingga kunci diaktifkan kembali. Menghancurkan versi kunci akan memblokir akses secara permanen dan dapat menyebabkan kehilangan data yang tidak dapat dipulihkan. Keduanya hanya memengaruhi tugas yang terkait dengan versi kunci tertentu.

    Anda tidak dapat melihat resource yang dilindungi oleh versi kunci yang dinonaktifkan atau dihancurkan. Setiap eksekusi tugas yang aktif akan gagal dengan pesan error yang sesuai.

  • Cabut peran IAM roles/cloudkms.cryptoKeyEncrypterDecrypter dari agen layanan Cloud Scheduler. Hal ini memengaruhi semua tugas di project dan regionGoogle Cloud tertentu yang mendukung enkripsi menggunakan CMEK. Anda tidak dapat membuat tugas baru yang terintegrasi dengan CMEK, atau melihat atau mencantumkan tugas yang dienkripsi CMEK (meskipun Anda masih dapat menghapusnya). Setiap eksekusi tugas yang aktif akan gagal dengan pesan error yang sesuai.

Meskipun tidak ada operasi yang menjamin pencabutan akses instan, perubahan IAM umumnya berlaku lebih cepat. Untuk mengetahui informasi selengkapnya, lihat Konsistensi resource Cloud KMS dan Penerapan perubahan akses.

Tentang batasan kebijakan organisasi CMEK

Cloud Scheduler mendukung batasan kebijakan organisasi berikut, yang dapat membantu Anda menerapkan penggunaan CMEK di seluruh organisasi:

  • constraints/gcp.restrictNonCmekServices: gunakan batasan ini untuk mewajibkan penggunaan CMEK guna melindungi semua resource Cloud Scheduler baru dalam organisasi, folder, atau project.

    Jika aktif, kebijakan organisasi ini akan mencegah pembuatan atau pembaruan resource, kecuali jika Anda mengaktifkan kunci Cloud KMS terlebih dahulu. Anda juga tidak dapat menonaktifkan CMEK untuk region Cloud Scheduler.

  • constraints/gcp.restrictCmekCryptoKeyProjects: gunakan batasan ini untuk memastikan bahwa resource Cloud Scheduler yang dilindungi CMEK menggunakan kunci dari project yang disetujui.

    Misalnya, Anda dapat menentukan aturan yang mirip dengan berikut ini: "Untuk semua resource Cloud Scheduler di projects/my-company-data-project, kunci Cloud KMS yang digunakan dalam project ini harus berasal dari projects/my-company-central-keys ATAU projects/team-specific-keys."

Perhatikan hal berikut:

  • Setelah menerapkan kebijakan organisasi CMEK, Anda masih dapat mengakses tugas yang ada yang menggunakan enkripsi default Google. Namun, Anda tidak dapat mengupdatenya kecuali jika Anda mengonfigurasi kunci Cloud KMS yang dapat diterima untuk region Cloud Scheduler terlebih dahulu.

  • Tugas yang menargetkan aplikasi App Engine tidak tunduk pada kebijakan organisasi CMEK. Misalnya, jika Anda menetapkan batasan constraints/gcp.restrictNonCmekServices, Anda masih dapat membuat atau memperbarui tugas yang menargetkan aplikasi App Engine.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi kebijakan organisasi, lihat Kebijakan organisasi CMEK.

Pemecahan masalah

Anda mungkin mengalami error saat menggunakan Cloud KMS dengan Cloud Scheduler. Tabel berikut menjelaskan berbagai masalah dan cara mengatasinya.

Masalah Deskripsi
Izin cloudkms.cryptoKeyVersions.useToEncrypt ditolak

Kunci Cloud KMS yang diberikan tidak ada atau izin tidak dikonfigurasi dengan benar.

Solusi:

Versi kunci tidak diaktifkan

Versi kunci Cloud KMS yang diberikan telah dinonaktifkan.

Solusi: Aktifkan kembali versi kunci Cloud KMS.

Region key ring tidak cocok dengan resource yang akan dilindungi

Region key ring Cloud KMS yang disediakan berbeda dengan region Cloud Scheduler yang dilindungi.

Solusi: Gunakan key ring Cloud KMS dari region yang sama dengan region Cloud Scheduler. Key ring dapat berada di project yang berbeda. Untuk mengetahui informasi selengkapnya, lihat lokasi Cloud KMS dan lokasi Cloud Scheduler.

Project tidak kompatibel dengan CMEK di Cloud Scheduler

Pengaktifan CMEK gagal dengan error FAILED_PRECONDITION dengan pesan: Your project is currently not compatible with CMEK in Cloud Scheduler. Error ini terjadi jika tugas Cloud Scheduler yang ada di project Anda belum dimigrasikan untuk mendukung CMEK. Misalnya, izin agen layanan yang tidak ada atau tugas lama dengan nama topik Pub/Sub yang tidak valid dapat mencegah migrasi.

Solusi:

  1. Tinjau dan perbaiki masalah izin atau konfigurasi tugas di project Anda:
    • Pastikan agen layanan Cloud Scheduler memiliki peran Agen Layanan Cloud Scheduler (roles/cloudscheduler.serviceAgent) di project. Peran ini mencakup izin pubsub.topics.publish untuk topik Pub/Sub dalam project. Untuk mengetahui petunjuknya, lihat Memberikan peran Agen Layanan Cloud Scheduler.
    • Jika roles/cloudscheduler.serviceAgent tidak diberikan pada project atau dibatasi, pastikan agen layanan memiliki peran Pub/Sub Publisher (roles/pubsub.publisher) di setiap topik target.
    • Periksa tugas target Pub/Sub lama dengan nama topik yang tidak valid, lalu update atau hapus tugas tersebut. Nama topik harus menggunakan format projects/PROJECT_ID/topics/TOPIC_ID dalam project yang sama dengan tugas. Untuk aturan penamaan topik, lihat Panduan untuk memberi nama topik, langganan, skema, atau snapshot.
  2. Setelah menyelesaikan masalah izin atau konfigurasi tugas, buka permintaan dukungan di konsol Google Cloud untuk menyelesaikan migrasi sehingga Anda dapat mengaktifkan CMEK untuk project Anda. Memperbaiki izin atau konfigurasi tugas saja tidak akan menghapus error hingga migrasi selesai.

Logging audit

Cloud KMS menghasilkan log audit saat kunci diaktifkan, dinonaktifkan, atau digunakan oleh resource Cloud Scheduler untuk mengenkripsi dan mendekripsi pesan. Untuk mengetahui informasi selengkapnya, lihat Logging audit Cloud KMS.

Error Cloud EKM

Untuk menyelesaikan masalah yang mungkin Anda alami saat menggunakan kunci yang dikelola secara eksternal melalui Cloud External Key Manager (Cloud EKM), lihat Referensi error Cloud EKM.

Status kunci tidak tersedia

Jika karena alasan tertentu Cloud KMS tidak tersedia, Cloud Scheduler mungkin tidak dapat mengambil status kunci Anda dari Cloud KMS.

Jika Cloud KMS tidak tersedia saat tugas dijadwalkan untuk dijalankan, Cloud Scheduler tidak dapat mendekripsi data tugas atau memanggil target tugas. Untuk error Cloud KMS sementara (seperti UNAVAILABLE, RESOURCE_EXHAUSTED, atau kunci Cloud EKM yang tidak dapat dijangkau), Cloud Scheduler akan mencoba kembali dekripsi secara internal dengan backoff eksponensial dan mencatat entri CmekRetryFailure di Cloud Logging di bagian cloudscheduler.googleapis.com/cmek. Untuk error yang tidak dapat dicoba lagi, seperti error izin atau kunci yang dinonaktifkan atau dihancurkan, dekripsi akan langsung gagal tanpa memanggil target.

Kuota Cloud KMS

Saat Anda menggunakan CMEK di Cloud Scheduler, project Anda dapat memakai kuota permintaan kriptografis Cloud KMS. Misalnya, Cloud Scheduler dapat menggunakan kuota ini saat menjalankan tugas, menangani permintaan pengelolaan tugas, atau memperbarui konfigurasi CMEK. Cloud Scheduler menggunakan kembali kunci perantara yang di-cache hingga lima menit per project dan region, sehingga tugas yang sering dijalankan tidak menggunakan kuota. Operasi enkripsi dan dekripsi menggunakan kunci CMEK memengaruhi kuota Cloud KMS hanya jika Anda menggunakan kunci eksternal (Cloud EKM). Untuk informasi selengkapnya, lihat kuota Cloud KMS.

Harga

Integrasi ini tidak menimbulkan biaya tambahan selain operasi kunci Cloud KMS, yang ditagihkan ke project Google Cloud Anda.

Resource pengiriman dasar yang menggunakan kunci Anda melalui pemberian kunci dapat melakukan operasi Cloud KMS tambahan. Untuk membantu memperkirakan penggunaan Cloud KMS untuk operasi Cloud Scheduler langsung, perkirakan tarif operasi kriptografi berikut per project dan region:

  • Eksekusi tugas: Cloud Scheduler menggunakan kembali kunci perantara yang di-cache hingga lima menit per project dan region. Project dengan kurang dari satu eksekusi tugas setiap lima menit melakukan sekitar satu operasi dekripsi Cloud KMS per eksekusi. Project dengan eksekusi yang lebih sering melakukan sekitar satu operasi dekripsi setiap lima menit di seluruh region.
  • Operasi pengelolaan tugas: Permintaan untuk membuat, memperbarui, mendapatkan, mencantumkan, menjeda, atau melanjutkan tugas dengan data yang dilindungi menggunakan kunci perantara yang di-cache secara terpisah selama maksimal lima menit per project dan region.
  • Update konfigurasi CMEK: Mengaktifkan atau mengubah kunci CMEK dengan cmek-config akan menjalankan operasi kunci Cloud KMS tambahan untuk memvalidasi kunci dan mengenkripsi ulang tugas yang dilindungi yang ada di region tersebut. Menonaktifkan CMEK akan mendekripsi tugas yang dilindungi yang ada kembali ke enkripsi default Google.

Untuk mengetahui informasi harga, lihat Harga Cloud KMS.