Skip to content

Commit

Permalink
chore: Readme additions
Browse files Browse the repository at this point in the history
  • Loading branch information
anakinj committed Sep 28, 2024
1 parent 0ca6880 commit 267faa0
Showing 1 changed file with 17 additions and 1 deletion.
18 changes: 17 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# JWT::KMS
# JWT::Aws::KMS

AWS KMS algorithm extensions for ruby-jwt.

Expand Down Expand Up @@ -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.
Expand Down

0 comments on commit 267faa0

Please sign in to comment.