Düz metni şifreli metne dönüştürür.
İşlem açıklaması
Key Management Service (KMS), Encrypt ve AdvanceEncrypt olmak üzere iki şifreleme işlemi sunar. Temel fark, kullanılan anahtar sürümü ve ardından çağrılması gereken şifre çözme işlemidir.
| Encrypt | AdvanceEncrypt | |
|---|---|---|
| Kullanılan anahtar sürümü | İlk sürüm | Birincil sürüm |
| Uyumlu şifre çözme işlemleri | Decrypt veya AdvanceDecrypt | Yalnızca AdvanceDecrypt |
Yazılım tabanlı bir anahtar yönetimi örneğinde simetrik anahtar kullanıyorsanız ve bu yazılım korumalı anahtar için anahtar döndürme etkinleştirilmişse, Encrypt yerine AdvanceEncrypt çağrısını yapın. Aksi takdirde anahtar döndürme özelliği etkili olmaz. Daha fazla bilgi için bkz. Anahtar döndürmeyi yapılandırma.
Anahtar teknik özellikleri, şifreleme modları, gizli anahtar şifrelemesi ve anahtar sürümleri hakkında daha fazla bilgi için bkz. Anahtar türleri ve 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ştığında 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:
|
|
|
|
|
|
|
|
|
Verileriniz bu sınırları aşıyorsa bunun yerine zarf şifrelemeyi kullanın. Daha fazla bilgi için bkz. Zarf şifreleme.
Tek bir çağrıdaki veri hacmi arttıkça ağ iletim hatası riski yükselir, iletim süresi uzar ve KMS örneğinin veri şifreleme veya şifre çözme işlemini tamamlaması daha uzun sürer.
İstek parametreleri
| Parametre | Tür | Zorunlu | Örnek | Açıklama |
|---|---|---|---|---|
| KeyId | string | Evet | key-hzz62f1cb66fa42qo**** | Anahtarın genel olarak benzersiz kimliği. Anahtara bağlı bir takma ad da belirtebilirsiniz. |
| Plaintext | bytes | Evet | İkili veri | Şifrelenecek düz metin. |
| Algorithm | string | Hayır | AES_GCM | Şifreleme algoritması. Belirtilmezse KMS anahtar için varsayılan algoritmayı kullanır. Daha fazla bilgi için bkz. Anahtar türleri ve teknik özellikleri. |
| Iv | bytes | Hayır | İkili veri | Veri şifrelemede kullanılan başlatma vektörü (IV). Yalnızca şifreleme algoritması (Algorithm) AES_GCM, AES_CBC olduğunda geçerlidir. Geçerli uzunluklar: Algorithm değeri AES_CBC ise 16 bayt; Algorithm değeri AES_GCM ise 12 bayt. Belirtilmezse KMS rastgele bir değer oluşturur. Bu parametreyi ayarlamayın ve KMS'nin rastgele oluşturmasına izin verin. |
| Aad | binary | Hayır | İkili veri | Veri şifreleme sırasında GCM modu kimlik doğrulamasında kullanılan ek kimlik doğrulanmış veri (AAD). Anahtar simetrik anahtar olduğunda ve şifreleme algoritması (Algorithm) AES_GCM veya SM4_GCM olduğunda bu parametreyi ayarlayabilirsiniz. Bu parametreyi ayarlarsanız şifrelenmiş verilerin şifresini çözmek için Decrypt çağrısını yaptığınızda aynı değeri iletmeniz gerekir. |
| PaddingMode | string | Hayır | PKCS7_PADDING | Dolgu modu. Yalnızca Algorithm değeri AES_CBC veya AES_ECB olarak ayarlandığında gereklidir. Geçerli değerler: PKCS7_PADDING (varsayılan) ve NO_PADDING. |
PaddingMode değerleri
PKCS7_PADDING(varsayılan): PKCS#7 dolgusu kullanır. Giriş L bayt ise KMS, K'nin şifre blok boyutu olduğu K − (L mod K) sayıda dolgu baytı ekler.NO_PADDING: Dolgu eklenmez. Düz metin uzunluğu şifre blok boyutunun tam katı olmalıdır.
Yanıt öğeleri
| Parametre | Tür | Örnek | Açıklama |
|---|---|---|---|
| Iv | bytes | İkili veri | Veri şifrelemede kullanılan başlatma vektörü (IV). Yalnızca şifreleme algoritması (Algorithm) AES_GCM, AES_CBC olduğunda geçerli bir değer döndürür; diğer tüm durumlarda boş değer döndürür. |
| CiphertextBlob | bytes | İkili veri | Belirtilen anahtarla şifrelendikten sonraki verilerin şifreli metin BLOB değeri. Not: Eliptik Eğri Entegre Şifreleme Şeması (ECIES) algoritması kullanıldığında döndürülen şifreli metin formatı SEC 1: Elliptic Curve Cryptography, Version 2.0 standardına uygundur. |
| KeyId | string | key-hzz62f1cb66fa42qo**** | Anahtarın genel olarak benzersiz tanımlayıcısı. KeyId istek parametresinde bir anahtar takma adı belirttiyseniz bu yanıt öğesi söz konusu takma ada bağlı anahtarın genel olarak benzersiz tanımlayıcısını döndürür. |
| Algorithm | string | AES_GCM | Şifreleme algoritması. |
| PaddingMode | string | PKCS7_PADDING | Dolgu modu. Yalnızca Algorithm değeri AES_CBC veya AES_ECB olduğunda değer döndürür; aksi takdirde boştur. |
| RequestId | string | 475f1620-b9d3-4d35-b5c6-3fbdd941423d | İsteğin kimliği. Alibaba Cloud bu benzersiz tanımlayıcıyı istek için oluşturur. Sorun gidermek ve sorunları konumlandırmak için kullanabilirsiniz. |
Hata kodları
Hata kodlarının listesi için bkz. Hizmet hata kodları.