Memverifikasi tanda tangan menggunakan kunci asimetris - Key Management Service

Memverifikasi tanda tangan digital menggunakan kunci asimetris.

Petunjuk operasi

Untuk informasi lebih lanjut tentang spesifikasi kunci dan mode enkripsi, lihat Spesifikasi Kunci untuk Enkripsi Simetris dan Asimetris.

Catatan penggunaan

Setelah semua parameter permintaan dienkripsi menggunakan Protocol Buffers, badan permintaan tidak boleh melebihi 3 MB. Jika badan permintaan melebihi 3 MB, server akan menolak permintaan dan mengembalikan kode status HTTP 413. Untuk pesan besar yang perlu ditandatangani, disarankan untuk menghasilkan digest dari pesan secara lokal, kemudian memanggil operasi Sign atau Verify untuk penandatanganan dan verifikasi.

Parameter permintaan

Parameter	Tipe	Diperlukan	Contoh	Deskripsi
KeyId	string	Ya	1234abcd-12ab-34cd-56ef-12345678****	ID unik global dari kunci. Anda juga dapat menetapkan parameter ini ke alias yang terikat pada kunci.
Algorithm	string	Ya	RSAES_OAEP_SHA_256	Algoritma tanda tangan. Nilai valid: RSA_PSS_SHA_256 RSA_PKCS1_SHA_256 ECDSA_SHA_256 SM2DSA Catatan Algoritma tanda tangan harus konsisten dengan algoritma tanda tangan yang dikembalikan dalam operasi Sign.
MessageType	string	Ya	RAW	Jenis pesan. Nilai valid: RAW: data mentah. Ini adalah nilai default. DIGEST: digest pesan dari data mentah. Key Management Service (KMS) tidak memproses digest pesan dari data mentah. KMS langsung menggunakan kunci privat untuk menandatangani data.
Message	bytes	Ya	Data biner	Pesan untuk ditandatangani. Jika parameter MessageType disetel ke RAW, algoritma hash yang ditentukan oleh parameter Algorithm digunakan untuk menghasilkan digest untuk data mentah. Kemudian, digest tersebut ditandatangani. Jika parameter MessageType disetel ke DIGEST, digest dapat memiliki panjang hingga 32 byte.
Signature	bytes	Ya	Data biner	Nilai tanda tangan yang akan diverifikasi.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
Value	bool	true	Menunjukkan apakah tanda tangan lulus verifikasi. Nilai valid: true false
KeyId	string	1234abcd-12ab-34cd-56ef-12345678****	ID unik global dari kunci. Jika parameter KeyId disetel ke alias dari kunci, ID dari kunci yang mana alias tersebut terikat akan dikembalikan.
Algorithm	string	RSAES_OAEP_SHA_256	Algoritma penandatanganan.
MessageType	string	RAW	Jenis pesan.
RequestId	string	475f1620-b9d3-4d35-b5c6-3fbdd941423d	ID permintaan.

Kode kesalahan

Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.