Asimetrik bir anahtarla oluşturulan dijital imzayı doğrular.
Kullanım notları
Protokol Arabellekleri (Protocol Buffers) kullanılarak kodlanan tüm istek parametrelerinin toplam boyutu 3 MB'yi aşmamalıdır. İstek gövdesi bu sınırı aşarsa sunucu isteği HTTP 413 hatasıyla reddeder. Büyük mesajlar için yerel olarak bir özet oluşturun ve bunu Message parametresi olarak geçirin; ayrıca MessageType değerini DIGEST olarak ayarlayın veya imzalama ve doğrulama işlemleri için Sign ya da Verify API çağrılarını kullanın.
Desteklenen anahtar teknik özellikleri ve imzalama algoritmaları için bkz. Anahtar türleri ve teknik özellikleri.
İstek parametreleri
| Parametre | Tür | Zorunlu | Örnek | Açıklama |
|---|---|---|---|---|
| KeyId | string | Evet | 1234abcd-12ab-34cd-56ef-12345678**** |
Anahtarın genel olarak benzersiz kimliği. Anahtara bağlı bir takma ad da belirtebilirsiniz. |
| Algorithm | string | Evet | RSAES_OAEP_SHA_256 |
İmzalama algoritması. Geçerli değerler: RSA_PSS_SHA_256, RSA_PKCS1_SHA_256, ECDSA_SHA_256, SM2DSA. Sign işlemi çağrılırken kullanılan algoritmayla eşleşmelidir. |
| MessageType | string | Evet | RAW |
Doğrulanacak mesajın türü. Geçerli değerler: RAW (varsayılan), DIGEST. DIGEST olarak ayarlandığında, Key Management Service (KMS) ham verilerin mesaj özetini işlemez; KMS doğrudan özel anahtar kullanarak verileri imzalar. |
| Message | bytes | Evet | İkili veri | Doğrulanacak mesaj. MessageType değeri RAW ise, Key Management Service (KMS) Algorithm tarafından belirtilen karma algoritmasını uygulayarak bir özet oluşturur ve ardından imzayı doğrular. MessageType değeri DIGEST ise, önceden hesaplanmış ve en fazla 32 bayt uzunluğundaki özeti geçirin. |
| Signature | bytes | Evet | İkili veri | Doğrulanacak imza değeri. |
Yanıt öğeleri
| Parametre | Tür | Örnek | Açıklama |
|---|---|---|---|
| Value | bool | true |
İmzanın geçerli olup olmadığını gösterir. Geçerli değerler: true, false. |
| KeyId | string | 1234abcd-12ab-34cd-56ef-12345678**** |
Doğrulama için kullanılan anahtarın genel olarak benzersiz kimliği. Bir takma ad belirttiyseniz, bu alan takma adın bağlı olduğu anahtarın kimliğini döndürür. |
| Algorithm | string | RSAES_OAEP_SHA_256 |
İmzalama algoritması. |
| MessageType | string | RAW |
Mesaj türü. |
| RequestId | string | 475f1620-b9d3-4d35-b5c6-3fbdd941423d |
İstek kimliği. |
Hata kodları
Hata kodlarının listesi için bkz. Hizmet hata kodları.