From 46ebce02c48e8beacac5f478a769162284201d7e Mon Sep 17 00:00:00 2001 From: Joakim Antman Date: Sat, 28 Sep 2024 22:13:16 +0300 Subject: [PATCH] chore: Readme algo additions (#4) --- README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f58d36f..3a92265 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# JWT::KMS +# JWT::Aws::KMS AWS KMS algorithm extensions for ruby-jwt. @@ -29,6 +29,22 @@ token = JWT.encode(payload, key.key_metadata.key_id, algo) decoded_token = JWT.decode(token, key.key_metadata.key_id, true, algorithm: algo) ``` +## Supported algorithms + +The gem supports the following AWS KMS algorithms: + +| Algorithm Name | Description | JWA Name | +|----------------|--------------------------------------------------|-------------------------| +| RSASSA_PKCS1_V1_5_SHA_256 | RSASSA PKCS1 v1.5 using SHA-256 | RS256 | +| RSASSA_PKCS1_V1_5_SHA_384 | RSASSA PKCS1 v1.5 using SHA-384 | RS384 | +| RSASSA_PKCS1_V1_5_SHA_512 | RSASSA PKCS1 v1.5 using SHA-512 | RS512 | +| RSASSA_PSS_SHA_256 | RSASSA PSS using SHA-256 | PS256 | +| RSASSA_PSS_SHA_384 | RSASSA PSS using SHA-384 | PS384 | +| RSASSA_PSS_SHA_512 | RSASSA PSS using SHA-512 | PS512 | +| ECDSA_SHA_256 | ECDSA using P-256 and SHA-256 | ES256 | +| ECDSA_SHA_384 | ECDSA using P-384 and SHA-384 | ES384 | +| ECDSA_SHA_512 | ECDSA using P-521 and SHA-512 | ES512 | + ## Development [Localstack](https://www.localstack.cloud/) can be used to simulate the AWS KMS environment.