Decrypts ciphertext into plaintext. - Key Management Service

İşlem açıklaması

Encrypt veya GenerateDataKey işlemini çağırarak şifreli metin oluşturduktan sonra Decrypt işlemini kullanarak bu metnin şifresini çözebilirsiniz.

Anahtar teknik özellikleri ve şifreleme modları hakkında daha fazla bilgi için bkz. Anahtar yönetimi türleri ve anahtar teknik özellikleri.

Kullanım notları

Tüm istek parametreleri Protocol Buffers ile kodlanır. Elde edilen istek gövdesi 3 MB'ı aşamaz. Veri hacmi 3 MB'ı aşıyorsa sunucu isteği reddeder ve HTTP durum kodu 413 döndürür.

Tek bir şifreleme veya şifre çözme çağrısında verileri aşağıdaki sınırlar içinde tutun:

Anahtar türü	Önerilen maksimum veri hacmi
Simetrik anahtar	6 KB
Asimetrik anahtar	1 KB

Verileriniz bu sınırları aşıyorsa bunun yerine zarf şifrelemeyi kullanın. Daha fazla bilgi için bkz. Zarf şifreleme.

Not

Tek bir çağrıdaki veri hacmi arttıkça ağ aktarım hatası riski yükselir, aktarım daha uzun sürer ve KMS örneğinin veri şifreleme veya şifre çözme işlemini tamamlaması daha fazla zaman alır.

İstek parametreleri

Ad	Tür	Gerekli	Örnek	Açıklama
KeyId	string	Evet	key-hzz62f1cb66fa42qo****	Anahtarın genel olarak benzersiz tanımlayıcısı. Bu parametre için bir anahtar takma adı da belirtebilirsiniz.
Algorithm	string	Hayır	AES_GCM	Şifre çözme algoritması. Önemli Değer, şifrelemede kullanılan algoritmayla aynı olmalıdır.
Iv	bytes	Hayır	İkili veri	Başlatma vektörü. Bu parametre yalnızca şifre çözme algoritması (Algorithm parametresi) AES_GCM, AES_CBC veya ise gereklidir. Şifre çözme algoritması (Algorithm) AES_CBC ise Iv uzunluğu 16 bayttır. Şifre çözme algoritması (Algorithm) AES_GCM veya ise Iv uzunluğu 12 bayttır. Önemli Değer, şifrelemede kullanılan başlatma vektörüyle aynı olmalıdır.
CiphertextBlob	bytes	Evet	İkili veri	Şifresi çözülecek şifreli metin. Not ECIES algoritması kullanılıyorsa şifreli metin formatı SEC 1: Elliptic Curve Cryptography, Version 2.0 standardını takip eder.
Aad	bytes	Hayır	İkili veri	Ek kimlik doğrulama verisi. Uzunluk 8.192 baytı aşamaz. Bu parametre yalnızca şifre çözme algoritması (Algorithm) AES_GCM veya SM4_GCM ise ve şifreleme sırasında ek kimlik doğrulama verisi (Aad) belirtilmişse gereklidir. Önemli Değer, şifrelemede kullanılan ek kimlik doğrulama verisiyle aynı olmalıdır.
PaddingMode	string	Hayır	PKCS7_PADDING	Dolgu modu. Bu parametre yalnızca şifreleme algoritması AES_CBC veya AES_ECB ise gereklidir. Önemli Değer, şifrelemede kullanılan dolgu moduyla aynı olmalıdır. Geçerli değerler: PKCS7_PADDING (varsayılan): PKCS#7 dolgusu. Düz metin uzunluğunun blok şifre algoritmasının blok boyutunun (K bayt) katı olması gerekmez. Girdi düz metin uzunluğu L bayt ise sistem K - (L mod K) bayt dolgu ekler ve her bir dolgulu baytın değeri K - (L mod K) olur. NO_PADDING: Düz metne dolgu uygulanmaz. Düz metin uzunluğu blok şifre algoritmasının blok boyutunun tamsayı katı olmalıdır.

Yanıt verileri

Ad	Tür	Örnek	Açıklama
Plaintext	bytes	İkili veri	Şifresi çözülmüş düz metin.
KeyId	string	key-hzz62f1cb66fa42qo****	Anahtarın genel olarak benzersiz tanımlayıcısı. İstekte KeyId parametresi olarak bir anahtar takma adı kullanılırsa yanıtta bu takma ada karşılık gelen anahtarın genel olarak benzersiz tanımlayıcısı döndürülür.
Algorithm	string	AES_GCM	Şifre çözme algoritması.
PaddingMode	string	PKCS7_PADDING	Dolgu modu.
RequestId	string	475f1620-b9d3-4d35-b5c6-3fbdd941423d	İsteğin ID'si. Alibaba Cloud her istek için benzersiz bir ID oluşturur. Sorun giderme amacıyla bu istek ID'sini kullanabilirsiniz.

Hata kodları

HTTP durum kodu

Hata kodu

Hata iletisi

Açıklama

500

InternalFailure

Internal Failure.

Olası nedenler:

Şifreli metin verileri gereksinimleri karşılamıyor.
Örneğin, RSA şifre çözme (RSAES_OAEP_SHA_256) kullanırken genel anahtarın düz metni şifrelemek için kullandığı özet algoritması SHA-1 ise veya AES_ECB şifre çözme kullanırken şifreli metin veri uzunluğu 16 baytın (AES algoritması blok boyutu) katı değilse bu hata oluşur.
İstek parametrelerinde belirtilen anahtar, şifrelemede kullanılan anahtar değil.

Yukarıdaki nedenler elenirse teknik destekle iletişime geçin.

Hata kodları hakkında daha fazla bilgi için bkz. Ortak hata kodları.