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 umum error.
  • Kolom google.rpc.Status.message menampilkan pesan yang dapat dibaca manusia, termasuk detail tentang tindakan tertentu yang dicoba dan saran dependen konteks untuk memecahkan masalah error.

  • Jika google.rpc.Status.code adalah FAILED_PRECONDITION, struktur google.rpc.PreconditionFailure dapat dibaca mesin. File 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 enkripsi eksternal.

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

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

Dalam referensi ini, pesan dalam google.rpc.Status.message terpotong untuk keterbacaan. Bagian yang terpotong mencakup informasi seperti URI kunci atau jalur kunci eksternal.

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 EKM melalui error VPC.

Error input

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

Kecuali jika dinyatakan lain, error di bagian ini memiliki google.rpc.Status.code dari 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, pastikan jalur ruang crypto sudah benar.
Jika EKM host tidak dapat dikueri, pastikan nama host EKM sudah benar.
Jika e-mail tersebut dieja dengan benar, hubungi dukungan untuk sistem partner pengelolaan kunci enkripsi eksternal.
Key URI has invalid format. EXTERNAL_KEY_URI_INVALID Pastikan URI kunci dalam permintaan ini sudah benar dan coba lagi dengan merotasi kunci EKM Cloud.
Key URI host is not supported. EXTERNAL_KEY_HOST_NOT_WHITELISTED Pastikan URI kunci sudah benar. Jika Anda mengoperasikan deployment sistem partner pengelolaan kunci enkripsi eksternal Anda sendiri, hubungi dukungan Google Cloud. Atau, hubungi dukungan untuk sistem partner pengelolaan kunci eksternal.
Could not resolve the domain name for EKM_ELEMENT. DNS Pastikan URI kunci, jalur kunci, ruang kripto, atau nama host EKM sudah benar. Jika ya, hubungi dukungan untuk sistem partner pengelolaan kunci enkripsi eksternal.

Error yang dapat dicoba ulang

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 enkripsi eksternal.

Kecuali jika dinyatakan lain, error di bagian ini memiliki google.rpc.Status.code dari 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 untuk merespons. Lambatnya performa 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 enkripsi eksternal.

Kecuali jika dinyatakan lain, error di bagian ini memiliki google.rpc.Status.code dari 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.
Hal ini berarti URI kunci valid, tetapi sistem partner pengelolaan kunci eksternal gagal mendekripsi blob yang digabungkan atau data terautentikasi tambahan (AAD).
google.rpc.Status.code adalah INVALID_ARGUMENT.		 DECRYPTION_FAILED

Mendapatkan dukungan

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