Referensi error Cloud EKM

Topik ini membantu Anda menafsirkan dan memecahkan masalah error yang mungkin terjadi saat menggunakan Cloud External Key Manager (Cloud EKM).

Struktur error

Struktur pesan error memberikan perincian sebanyak mungkin untuk membantu Anda mendiagnosis dan memecahkan masalah. Error ditampilkan dalam struktur google.rpc.Status. Dalam struktur tersebut:

  • Kolom google.rpc.Status.code menunjukkan kategori luas error.
  • Kolom google.rpc.Status.message menampilkan pesan yang dapat dibaca manusia, termasuk detail tentang tindakan spesifik yang dicoba dan saran yang bergantung pada konteks untuk memecahkan masalah error.

  • Jika google.rpc.Status.code adalah FAILED_PRECONDITION, struktur google.rpc.PreconditionFailure dapat dibaca mesin. Respons ini berisi dua struktur violation.

    • violation[0] berisi informasi tentang status kunci Cloud EKM.

    • violation[1] berisi informasi tentang upaya untuk menghubungi sistem partner pengelolaan kunci eksternal.

      violation[1].type berisi informasi tentang jenis error. Cloud EKM menyebut informasi ini sebagai "domain error".

      Jika error ini berlanjut, hubungi dukungan untuk partner pengelolaan kunci eksternal.

Dalam referensi ini, pesan dalam google.rpc.Status.message dipangkas agar mudah dibaca. Bagian yang dipangkas mencakup informasi seperti URI kunci eksternal atau jalur kunci.

Pemecahan masalah

Error yang terjadi saat menggunakan Cloud EKM dapat disebabkan oleh masalah pada error input, Cloud EKM, sistem partner pengelolaan kunci eksternal, komunikasi di antara keduanya, atau faktor lainnya. Anda dapat membaca informasi pemecahan masalah tertentu di bagian untuk setiap jenis error.

Bergantung pada jenis error, Anda mungkin perlu menghubungi dukungan Cloud EKM atau dukungan untuk sistem partner pengelolaan kunci eksternal.

Jika error Anda tidak tercantum dalam tabel di bawah, lihat Memecahkan masalah error EKM melalui VPC.

Error input

Ikuti saran pemecahan masalah di kolom google.rpc.Status.message error. Jika masalah berlanjut, hubungi Google Cloud dukungan.

Kecuali dinyatakan lain, error di bagian ini memiliki google.rpc.Status.code FAILED_PRECONDITION.

google.rpc.Status.message violation[1].type
(Domain error)		 Pemecahan masalah
Permission was denied when accessing the EKM_ELEMENT. EXTERNAL_PERMISSION_DENIED Jika EKM_ELEMENT adalah key, Cloud EKM juga akan menonaktifkan versi kunci. Berikan izin yang sesuai di pengelola kunci eksternal Anda, lalu coba lagi dengan merotasi kunci Cloud EKM.
Jika EKM_ELEMENT adalah crypto space atau EKM host, berikan peran atau izin yang sesuai ke akun layanan, lalu coba lagi.
Could not find a EKM_ELEMENT atau Could not query EKM host. EXTERNAL_NOT_FOUND Jika EKM_ELEMENT adalah key, periksa apakah URI kunci eksternal atau jalur kunci sudah benar.
Jika EKM_ELEMENT adalah crypto space, periksa apakah jalur ruang kripto sudah benar.
Jika EKM host tidak dapat dikueri, periksa apakah nama host EKM sudah benar.
Jika dieja dengan benar, hubungi dukungan untuk sistem partner pengelolaan kunci eksternal.
Key URI has invalid format. EXTERNAL_KEY_URI_INVALID Pastikan URI kunci dalam permintaan ini sudah benar, lalu coba lagi dengan merotasi kunci Cloud EKM.
Key URI host is not supported. EXTERNAL_KEY_HOST_NOT_WHITELISTED Pastikan URI kunci sudah benar. Jika Anda mengoperasikan deployment sendiri dari sistem partner pengelolaan kunci eksternal, hubungi Google Cloud dukungan. Atau, hubungi dukungan untuk sistem partner pengelolaan kunci eksternal.
Could not resolve the domain name for EKM_ELEMENT. DNS Periksa apakah URI kunci, jalur kunci, ruang kripto, atau nama host EKM sudah benar. Jika ya, hubungi dukungan untuk sistem partner pengelolaan kunci eksternal.

Error yang dapat dicoba lagi

Ikuti saran pemecahan masalah di kolom google.rpc.Status.message error. Jika Anda sering mengalami waktu tunggu habis atau error jaringan, pastikan lokasi geografis kunci Cloud EKM Anda sedekat mungkin dengan region yang Anda gunakan untuk kunci eksternal. Jika masalah berlanjut, hubungi dukungan untuk partner pengelolaan kunci eksternal.

Kecuali dinyatakan lain, error di bagian ini memiliki google.rpc.Status.code FAILED_PRECONDITION. EKM_ELEMENT dapat berupa salah satu nilai berikut: key, crypto space, atau EKM host.

google.rpc.Status.message violation[1].type
(Domain error)
Throttled when trying to access key URI. EXTERNAL_RESOURCE_EXHAUSTED
Could not reach the EKM_ELEMENT due to an external networking error. UNREACHABLE_NETWORK
Could not reach the EKM_ELEMENT because the external key manager reports that it is overloaded. OVERLOADED_EKM
Timed out when trying to access the EKM_ELEMENT. TIMEOUT
Error ini biasanya terjadi saat EKM terlalu lambat merespons. Kelambatan dapat disebabkan oleh EKM yang menerima lebih banyak permintaan daripada yang dapat ditanganinya atau oleh latensi jaringan yang terlalu tinggi. REQUEST_CANCELLED

Error sistem pengelolaan kunci eksternal

Jika Anda mengalami error ini dan error tersebut berlanjut, hubungi dukungan untuk partner pengelolaan kunci eksternal.

Kecuali dinyatakan lain, error di bagian ini memiliki google.rpc.Status.code FAILED_PRECONDITION. EKM_ELEMENT dapat berupa salah satu nilai berikut: key, crypto space, atau EKM host.

google.rpc.Status.message violation[1].type
(Domain error)
Could not validate the TLS server certificate for the EKM_ELEMENT. TLS_CERT
Got garbled or unusable response when trying to access the EKM_ELEMENT. UNEXPECTED_RESPONSE
External server error when trying to access the EKM_ELEMENT. EXTERNAL_SERVER_ERROR
The external key manager indicated they have not implemented the appropriate method to support Cloud KMS's EKM_API.
 EKM_API dapat berupa salah satu dari AsymmetricSign, CheckCryptoSpacePermissions, CreateKey, Decrypt, DestroyKey, Encrypt, GetInfo, atau GetPublicKey 		EXTERNAL_NOT_IMPLEMENTED
Got unexpected error when trying to access the EKM_ELEMENT. UNEXPECTED_ERROR
Decryption failed: The EKM reports that decryption failed.
Artinya, URI kunci valid, tetapi sistem partner pengelolaan kunci eksternal gagal mendekripsi blob yang di-wrap atau data tambahan yang diautentikasi (AAD).
google.rpc.Status.code adalah INVALID_ARGUMENT.		 DECRYPTION_FAILED

Mendapatkan dukungan

Jika Anda mengalami error yang tidak tercantum dalam referensi ini, hubungi Google Cloud dukungan.