Decrypts ciphertext into plaintext. - Key Management Service

İşlem açıklaması

Bu işlemi, AdvanceEncrypt, AdvanceGenerateDataKey, Encrypt veya GenerateDataKey çağrılarıyla şifrelenen metni çözmek için kullanın. Anahtar, yazılım anahtar yönetimi türündeki bir KMS örneğindeki simetrik bir anahtar olmalıdır.

Desteklenen anahtar teknik özellikleri ve şifreleme modları hakkında ayrıntılı bilgi için bkz. Anahtar türleri ve teknik özellikleri.

Kullanım notları

Protokol Arabellekleri (Protocol Buffers) kodlamasından sonra istek gövdesinin 3 MB altında kalmasını sağlayın. İstek gövdesi 3 MB'ı aşarsa sunucu isteği reddeder ve HTTP 413 hatası döndürür.

Tek bir işlemde şifreleme ve şifre çözme için veri boyutunu 6 KB ile sınırlayın. Daha büyük veriler için zarf şifrelemeyi kullanın.

Büyük yükler ağ arızası riskini artırır, iletim süresini uzatır ve KMS işleme gecikme süresini yükseltir.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
CiphertextBlob	bytes	Evet	İkili veri	Çözülecek şifreli metin.
KeyId	string	Hayır	key-hzz62f1cb66fa42qo****	Anahtarın genel olarak benzersiz ID'si veya anahtara bağlı bir takma ad. Yalnızca Encrypt veya GenerateDataKey işlemiyle oluşturulan şifreli metin çözüldüğünde gereklidir.
Algorithm	string	Hayır	AES_GCM	Şifre çözme algoritması. Yalnızca Encrypt veya GenerateDataKey işlemiyle oluşturulan şifreli metin çözüldüğünde gereklidir. Şifreleme sırasında kullanılan algoritmayla eşleşmelidir.
Iv	bytes	Hayır	İkili veri	Başlatma vektörü (IV). Yalnızca Encrypt veya GenerateDataKey işlemiyle oluşturulan şifreli metin çözüldüğünde ve Algorithm değeri AES_GCM veya AES_CBC olarak ayarlandığında gereklidir. Şifreleme sırasında kullanılan IV ile eşleşmelidir. Geçerli uzunluklar: AES_CBC için 16 bayt, AES_GCM için 12 bayt.
Aad	bytes	Hayır	İkili veri	Ek kimlik doğrulama verisi (AAD). Maksimum uzunluk: 8.192 bayt. Yalnızca Algorithm değeri AES_GCM olduğunda ve şifreleme sırasında AAD belirtildiğinde gereklidir. Şifreleme sırasında kullanılan AAD ile eşleşmelidir.
PaddingMode	string	Hayır	PKCS7_PADDING	Dolgu modu. Algorithm değeri AES_CBC veya AES_ECB olduğunda gereklidir. Şifreleme sırasında kullanılan dolgu moduyla eşleşmelidir. Geçerli değerler: PKCS7_PADDING (varsayılan): PKCS#7 dolgusu. Düz metin L baytsa sistem K − (L mod K) bayt dolgu ekler; burada K şifre blok boyutudur. NO_PADDING: Dolgu yok. Düz metin uzunluğu şifre blok boyutunun tam katı olmalıdır.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Plaintext	bytes	İkili veri	Çözülmüş düz metin.
KeyId	string	key-hzz62f1cb66fa42qo****	Şifre çözme için kullanılan anahtarın genel olarak benzersiz ID'si. İstekte bir takma ad belirtilmişse gerçek anahtar ID'si döndürülür.
KeyVersionId	string	key-hzz62f1cb66fa42qo-17kedv	Şifreli metni çözmek için kullanılan anahtar sürümünün ID'si.
Algorithm	string	AES_GCM	Şifre çözme algoritması.
PaddingMode	string	PKCS7_PADDING	Dolgu modu. Yalnızca Algorithm değeri AES_CBC veya AES_ECB olduğunda döndürülür. Diğer durumlarda boştur.
RequestId	string	c0037a6d-7784-4ef2-a692-288fdcbc7b9d	Sorun giderme amacıyla kullanılan istek ID'si.

Hata kodları

HTTP durum kodu	Hata kodu	Hata iletisi	Açıklama
404	Forbidden.OnlySymmetricKeySupported	The key %s is not a symmetric key. The API only supports symmetric keys.	Yalnızca simetrik anahtarlar desteklenir.
500	InternalFailure	Internal Failure.	Olası nedenler: Şifreli metin gereksinimleri karşılamıyor (örneğin, şifreli metin AdvanceEncrypt işlemi çağrılarak oluşturulmamış) veya belirtilen anahtar şifreleme için kullanılan anahtarla eşleşmiyor.

Hata kodlarının tam listesi için bkz. Hizmet hata kodları.