docs: update algorithms docs

Author: lepture

README.md

@@ -58,6 +58,7 @@ And draft RFCs implementation of:
 
 - [`C20P` and `XC20P`](https://jose.authlib.org/en/dev/guide/algorithms/#c20p-and-xc20p)
 - [Key Agreement with Elliptic Curve Diffie-Hellman One-Pass Unified Model](https://jose.authlib.org/en/dev/guide/algorithms/#ecdh-1pu-algorithms)
+- draft-ietf-jose-deprecate-none-rsa15-02
 
 ## Useful Links
 

README.rst

@@ -13,13 +13,15 @@ This package contains implementation of:
 - 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
 
 And draft RFCs implementation of:
 
-- C20P and XC20P
-- ECDH-1PU algorithms
+- draft-ietf-jose-deprecate-none-rsa15-02
+- draft-amringer-jose-chacha-02
+- draft-madden-jose-ecdh-1pu-04
 
 Usage
 -----

docs/guide/algorithms.rst

@@ -33,25 +33,25 @@ JSON Web Signature
 ``joserfc.jws`` module supports algorithms from RFC7518, RFC8037,
 and RFC8812. You MUST specify the correct key type for each algorithm.
 
-============== ========== ==================
-Algorithm name Key Type      Recommended
-============== ========== ==================
-none           OctKey      :bdg-danger:`No`
-HS256          OctKey      :bdg-success:`Yes`
-HS384          OctKey      :bdg-danger:`No`
-HS512          OctKey      :bdg-danger:`No`
-RS256          RSAKey      :bdg-success:`Yes`
-RS384          RSAKey      :bdg-danger:`No`
-RS512          RSAKey      :bdg-danger:`No`
-ES256          ECKey       :bdg-success:`Yes`
-ES384          ECKey       :bdg-danger:`No`
-ES512          ECKey       :bdg-danger:`No`
-PS256          RSAKey      :bdg-danger:`No`
-PS384          RSAKey      :bdg-danger:`No`
-PS512          RSAKey      :bdg-danger:`No`
-EdDSA          OKPKey      :bdg-danger:`No`
-ES256K         ECKey       :bdg-danger:`No`
-============== ========== ==================
+============== ========== ============================
+Algorithm name Key Type      Requirements
+============== ========== ============================
+none           OctKey      :bdg-danger:`Deprecated`
+HS256          OctKey      :bdg-success:`Recommended`
+HS384          OctKey      :bdg-muted:`Optional`
+HS512          OctKey      :bdg-muted:`Optional`
+RS256          RSAKey      :bdg-success:`Recommended`
+RS384          RSAKey      :bdg-muted:`Optional`
+RS512          RSAKey      :bdg-muted:`Optional`
+ES256          ECKey       :bdg-success:`Recommended`
+ES384          ECKey       :bdg-muted:`Optional`
+ES512          ECKey       :bdg-muted:`Optional`
+PS256          RSAKey      :bdg-muted:`Optional`
+PS384          RSAKey      :bdg-muted:`Optional`
+PS512          RSAKey      :bdg-muted:`Optional`
+EdDSA          OKPKey      :bdg-muted:`Optional`
+ES256K         ECKey       :bdg-muted:`Optional`
+============== ========== ============================
 
 .. note::
     ``EdDSA`` algorithm only accepts ``OKPKey`` with "crv" of "Ed25519" and "Ed448".
@@ -84,27 +84,27 @@ JSON Web Encryption
 ``joserfc.jwe`` module supports algorithms from RFC7518, and drafts of
 ``ECDH-1PU``. You MUST specify the correct key type for each algorithm.
 
-===================  ==========  ==================
-Algorithm name       Key Type    Recommended
-===================  ==========  ==================
-dir                  OctKey      :bdg-success:`Yes`
-A128KW               OctKey      :bdg-success:`Yes`
-A192KW               OctKey      :bdg-danger:`No`
-A256KW               OctKey      :bdg-success:`Yes`
-RSA1_5               RSAKey      :bdg-danger:`No`
-RSA-OAEP             RSAKey      :bdg-success:`Yes`
-RSA-OAEP-256         RSAKey      :bdg-danger:`No`
-ECDH-ES              ECKey       :bdg-success:`Yes`
-ECDH-ES+A128KW       ECKey       :bdg-success:`Yes`
-ECDH-ES+A192KW       ECKey       :bdg-danger:`No`
-ECDH-ES+A256KW       ECKey       :bdg-success:`Yes`
-A128GCMKW            OctKey      :bdg-danger:`No`
-A192GCMKW            OctKey      :bdg-danger:`No`
-A256GCMKW            OctKey      :bdg-danger:`No`
-PBES2-HS256+A128KW   RSAKey      :bdg-danger:`No`
-PBES2-HS384+A192KW   RSAKey      :bdg-danger:`No`
-PBES2-HS512+A256KW   RSAKey      :bdg-danger:`No`
-===================  ==========  ==================
+===================  ==========  ===========================
+Algorithm name       Key Type    Requirements
+===================  ==========  ===========================
+dir                  OctKey      :bdg-success:`Recommended`
+A128KW               OctKey      :bdg-success:`Recommended`
+A192KW               OctKey      :bdg-muted:`Optional`
+A256KW               OctKey      :bdg-success:`Recommended`
+RSA1_5               RSAKey      :bdg-danger:`Deprecated`
+RSA-OAEP             RSAKey      :bdg-success:`Recommended`
+RSA-OAEP-256         RSAKey      :bdg-muted:`Optional`
+ECDH-ES              ECKey       :bdg-success:`Recommended`
+ECDH-ES+A128KW       ECKey       :bdg-success:`Recommended`
+ECDH-ES+A192KW       ECKey       :bdg-muted:`Optional`
+ECDH-ES+A256KW       ECKey       :bdg-success:`Recommended`
+A128GCMKW            OctKey      :bdg-muted:`Optional`
+A192GCMKW            OctKey      :bdg-muted:`Optional`
+A256GCMKW            OctKey      :bdg-muted:`Optional`
+PBES2-HS256+A128KW   RSAKey      :bdg-muted:`Optional`
+PBES2-HS384+A192KW   RSAKey      :bdg-muted:`Optional`
+PBES2-HS512+A256KW   RSAKey      :bdg-muted:`Optional`
+===================  ==========  ===========================
 
 All algorithms defined in RFC7518 for "enc" value are recommended, which
 including:

docs/guide/errors.rst

@@ -6,6 +6,8 @@ Here are some common errors and warnings, and how to handle them.
 SecurityWarning
 ---------------
 
+.. versionadded:: 1.2.0
+
 You may encounter a ``SecurityWarning`` when using potentially
 unsafe algorithms or generating insecure keys. These warnings
 do not interrupt the execution of your application — they are
@@ -28,6 +30,8 @@ they are meant to alert you to potentially insecure practices.
 UnsupportedAlgorithmError
 -------------------------
 
+.. versionadded:: 1.1.0
+
 By default, **ONLY recommended** :ref:`jwa` are allowed. With non recommended
 algorithms, you may encounter the ``UnsupportedAlgorithmError``` error.