joserfc 1.2.0

The ultimate Python library for JOSE RFCs, including JWS, JWE, JWK, JWA, JWT

joserfc is a Python library that provides a comprehensive implementation of several essential JSON Object Signing and Encryption (JOSE) standards.

This package contains implementation of:

• RFC7515: JSON Web Signature

• RFC7516: JSON Web Encryption

• RFC7517: JSON Web Key

• RFC7518: JSON Web Algorithms

• RFC7519: JSON Web Token

• RFC7520: Examples of Protecting Content Using JSON Object Signing and Encryption

• RFC7638: thumbprint for JWK

• RFC7797: JSON Web Signature (JWS) Unencoded Payload Option

• RFC8037: OKP Key and EdDSA algorithm

• RFC8812: ES256K algorithm

• RFC9278: JWK Thumbprint URI

And draft RFCs implementation of:

• draft-ietf-jose-deprecate-none-rsa15-02

• draft-amringer-jose-chacha-02

• draft-madden-jose-ecdh-1pu-04

Usage

A quick and simple JWT encoding and decoding would look something like this:

>>> from joserfc import jwt
>>> from joserfc.jwk import OctKey
>>> key = OctKey.import_key("secret")
>>> encoded = jwt.encode({"alg": "HS256"}, {"k": "value"}, key)
>>> encoded
'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrIjoidmFsdWUifQ.ni-MJXnZHpFB_8L9P9yllj3RNDfzmD4yBKAyefSctMY'
>>> token = jwt.decode(encoded, key)
>>> token.header
{'alg': 'HS256', 'typ': 'JWT'}
>>> token.claims
{'k': 'value'}
>>> claims_requests = jwt.JWTClaimsRegistry()
>>> claims_requests.validate(token.claims)

Useful Links

1. GitHub: https://github.com/authlib/joserfc

2. Docs: https://jose.authlib.org/en/

License

Licensed under BSD. Please see LICENSE for licensing details.