AWS kms: Restructure AWS KMS supported cryptographic algorithms guide
Summary
Rewrites the KMS supported-algorithms page, splitting into symmetric and asymmetric key algorithm tables and adding quantum-resistant algorithms (ML-DSA, ML-KEM) and key-spec mappings.
Security assessment
The change documents which cryptographic algorithms KMS keys support, including post-quantum algorithms, guiding users toward secure algorithm selection. It is security documentation but does not address a specific vulnerability or incident.
Evidence
+ML_DSA_SHAKE_256 | Sign and verify | ML_DSA_44, ML_DSA_65, ML_DSA_87
Diff
diff --git a/kms/latest/developerguide/supported-algorithms.md b/kms/latest/developerguide/supported-algorithms.md index fd8a378..8f5d7fb 100644 --- a//kms/latest/developerguide/supported-algorithms.md +++ b//kms/latest/developerguide/supported-algorithms.md @@ -7 +7 @@ -Cryptographic algorithms +Symmetric key algorithmsAsymmetric key algorithms @@ -11 +11 @@ Cryptographic algorithms -## Cryptographic algorithms +AWS KMS supports the following cryptographic algorithms for KMS keys. The algorithms you can use depend on the [key spec](./create-keys.html#key-spec) and [key usage](./create-keys.html#key-usage) of the KMS key. For detailed descriptions of each key spec and the algorithms it supports, see [Key spec reference](./symm-asymm-choose-key-spec.html). @@ -13 +13 @@ Cryptographic algorithms -The following tables summarize the cryptographic algorithms, ciphers, modes, and key sizes that AWS deploys across its services to protect your data. They should not be considered to be an exhaustive list of all cryptography options available in AWS. The algorithms fall into two categories: +For guidance on which algorithms to use and when, see [Cryptography algorithms and AWS services](https://docs.aws.amazon.com/prescriptive-guidance/latest/encryption-best-practices/aws-cryptography-services.html#algorithms). @@ -15 +15 @@ The following tables summarize the cryptographic algorithms, ciphers, modes, and - * _Preferred_ algorithms meet the AWS security and performance standards. +## Symmetric key algorithms @@ -17 +17 @@ The following tables summarize the cryptographic algorithms, ciphers, modes, and - * _Acceptable_ algorithms can be used for compatibility in some applications but are not preferred. +AWS KMS supports the following algorithms for symmetric KMS keys. @@ -19,26 +19 @@ The following tables summarize the cryptographic algorithms, ciphers, modes, and - - - -### Asymmetric cryptography - -The following table lists supported asymmetric algorithms for encryption, key agreement, and digital signatures. - -Type | Algorithm | Status ----|---|--- -Encryption | RSA-OAEP (2048 or 3072-bit modulus) | Acceptable -Encryption | HPKE (P-256 or P-384, HKDF and AES-GCM) | Acceptable -Key Agreement | ML-KEM-768 or ML-KEM-1024 | Preferred (quantum-resistant) -Key Agreement | ECDH(E) with P-384 | Acceptable -Key Agreement | ECDH(E) with P-256, P-521, or X25519 | Acceptable -Key Agreement | ECDH(E) with brainpoolP256r1, brainpoolP384r1, or brainpoolP512r1 | Acceptable -Signatures | ML-DSA-65 or ML-DSA-87 | Preferred (quantum-resistant) -Signatures | SLH-DSA | Preferred (quantum-resistant software/firmware signing) -Signatures | ECDSA with P-384 | Acceptable -Signatures | ECDSA with P-256, P-521, or Ed25519 | Acceptable -Signatures | RSA-2048 or RSA-3072 | Acceptable - -### Symmetric cryptography - -The following table lists supported symmetric algorithms for encryption, authenticated encryption, and key wrapping. - -Type | Algorithm | Status +Supported algorithms for symmetric KMS keys Algorithm | Key usage | Key spec @@ -46,7 +21,6 @@ Type | Algorithm | Status -Authenticated Encryption | AES-GCM-256 | Preferred -Authenticated Encryption | AES-GCM-128 | Acceptable -Authenticated Encryption | ChaCha20/Poly1305 | Acceptable -Encryption Modes | AES-XTS-256 (for block storage) | Preferred -Encryption Modes | AES-CBC / CTR (unauthenticated modes) | Acceptable -Key Wrapping | AES-GCM-256 | Preferred -Key Wrapping | AES-KW or AES-KWP with 256-bit keys | Acceptable +AES-256-GCM | Encrypt and decrypt | SYMMETRIC_DEFAULT +SM4-128 (China Regions only) | Encrypt and decrypt | SYMMETRIC_DEFAULT +HMAC_SHA_224 | Generate and verify MAC | HMAC_224 +HMAC_SHA_256 | Generate and verify MAC | HMAC_256 +HMAC_SHA_384 | Generate and verify MAC | HMAC_384 +HMAC_SHA_512 | Generate and verify MAC | HMAC_512 @@ -54 +28 @@ Key Wrapping | AES-KW or AES-KWP with 256-bit keys | Acceptable -### Cryptographic functions +## Asymmetric key algorithms @@ -56 +30 @@ Key Wrapping | AES-KW or AES-KWP with 256-bit keys | Acceptable -The following table lists supported algorithms for hashing, key derivation, message authentication, and password hashing. +Each asymmetric KMS key has a single [key usage](./create-keys.html#key-usage) that determines which of these algorithms you can use. @@ -58 +32 @@ The following table lists supported algorithms for hashing, key derivation, mess -Type | Algorithm | Status +Supported algorithms for asymmetric KMS keys Algorithm | Key usage | Key spec @@ -60,12 +34,10 @@ Type | Algorithm | Status -Hashing | SHA2-384 | Preferred -Hashing | SHA2-256 | Acceptable -Hashing | SHA3 | Acceptable -Key Derivation | HKDF_Expand or HKDF with SHA2-256 | Preferred -Key Derivation | Counter Mode KDF with HMAC-SHA2-256 | Acceptable -Message Authentication Code | HMAC-SHA2-384 | Preferred -Message Authentication Code | HMAC-SHA2-256 | Acceptable -Message Authentication Code | KMAC | Acceptable -Password Hashing | scrypt with SHA384 | Preferred -Password Hashing | PBKDF2 | Acceptable - -For more details on cryptographic algorithms deployed in AWS, see [Cryptography algorithms and AWS services](https://docs.aws.amazon.com/prescriptive-guidance/latest/encryption-best-practices/aws-cryptography-services.html#algorithms). +RSAES_OAEP_SHA_1, RSAES_OAEP_SHA_256 | Encrypt and decrypt | RSA_2048, RSA_3072, RSA_4096 +RSASSA_PSS_SHA_256, RSASSA_PSS_SHA_384, RSASSA_PSS_SHA_512, RSASSA_PKCS1_V1_5_SHA_256, RSASSA_PKCS1_V1_5_SHA_384, RSASSA_PKCS1_V1_5_SHA_512 | Sign and verify | RSA_2048, RSA_3072, RSA_4096 +ECDSA_SHA_256 | Sign and verify | ECC_NIST_P256 (secp256r1) +ECDSA_SHA_384 | Sign and verify | ECC_NIST_P384 (secp384r1) +ECDSA_SHA_512 | Sign and verify | ECC_NIST_P521 (secp521r1) +ECDSA_SHA_256 | Sign and verify | ECC_SECG_P256K1 (secp256k1) +ED25519_SHA_512, ED25519_PH_SHA_512 | Sign and verify | ECC_NIST_EDWARDS25519 (ed25519) +ML_DSA_SHAKE_256 | Sign and verify | ML_DSA_44, ML_DSA_65, ML_DSA_87 +ECDH | Key agreement | ECC_NIST_P256, ECC_NIST_P384, ECC_NIST_P521 +SM2PKE (encryption), SM2DSA (signing), ECDH (key agreement) | Encrypt and decrypt, sign and verify, or key agreement | SM2 (China Regions only)