jose4j

Les faits et les vérifications qui les fondent

Rien de ce qui suit n’est copié d’une documentation. La vérification content/libraries/verify/jose4j/run.sh a exécuté jose4j 0.9.7 dans l’image de conteneur maven:3.9.16-eclipse-temurin-25 le 20 octobre 2026 ; la page doit correspondre à ce que la vérification a affiché, et chaque fait cite les lignes en question.

• Algorithmes JWS

  HS256HS384HS512RS256RS384RS512PS256PS384PS512ES256ES384ES512EdDSA

  Signature et vérification réussies avec HS, RS, PS et ES en 256/384/512 ainsi qu’avec EdDSA ; ES256K, Ed25519 et Ed448 ont levé InvalidAlgorithmException.

  Relevé par la vérification

  fact jws-algorithms = HS256, HS384, HS512, RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, EdDSA
  evidence jws-algorithms: ES256K: InvalidAlgorithmException: ES256K is an unknown, unsupported or unavailable alg algorithm (not one of [none, HS256, HS384, HS512, EdDSA, ES256, ES384, ES512, RS256, RS384, RS512, PS256, PS384, PS512]).
  evidence jws-algorithms: Ed25519: InvalidAlgorithmException: Ed25519 is an unknown, unsupported or unavailable alg algorithm (not one of [none, HS256, HS384, HS512, EdDSA, ES256, ES384, ES512, RS256, RS384, RS512, PS256, PS384, PS512]).
  evidence jws-algorithms: Ed448: InvalidAlgorithmException: Ed448 is an unknown, unsupported or unavailable alg algorithm (not one of [none, HS256, HS384, HS512, EdDSA, ES256, ES384, ES512, RS256, RS384, RS512, PS256, PS384, PS512]).

• Encodage des signatures ES256

  raw

  Les signatures ES256 font 64 octets, en r‖s brut.

  Relevé par la vérification

  fact jws-ecdsa-encoding = raw

• Signature DER dans un JWS

  rejected

  Une signature ES256 encodée en DER échoue avec InvalidJwtSignatureException: JWT rejected due to invalid signature.

  Relevé par la vérification

  fact jws-der-signature = rejected
  evidence jws-der-signature: InvalidJwtSignatureException: JWT rejected due to invalid signature. Additional details: [[9] Invalid JWS Signature:

• Liste d’algorithmes autorisés

  from-key

  Sans contraintes d’algorithme, c’est le type de clé qui décide : un jeton RS256 présenté à une clé EC a échoué avec The given key (algorithm=EC) is not valid for SHA256withRSA.

  Relevé par la vérification

  fact jwt-algorithm-allowlist = from-key
  evidence jwt-algorithm-allowlist: JwtConsumer without algorithm constraints, RS256 token against an EC key: InvalidJwtException: JWT processing failed. Additional details: [[17] Unable to process JOSE object (cause: org.jose4j.lang.InvalidKeyException: The given key (algorithm=EC) is not valid for SHA256withRSA):

• Jetons non signés (alg none)

  opt-in

  Le consommateur par défaut refuse les jetons non signés avec 'none' is a blocked algorithm. ; setDisableRequireSignature() sans contraintes d’algorithme les accepte.

  Relevé par la vérification

  fact jwt-alg-none = opt-in
  evidence jwt-alg-none: default JwtConsumer: InvalidJwtException: JWT processing failed. Additional details: [[17] Unable to process JOSE object (cause: org.jose4j.lang.InvalidAlgorithmException: 'none' is a blocked algorithm.):
  evidence jwt-alg-none: setDisableRequireSignature with no algorithm constraints: verified

• Clé publique utilisée comme secret HMAC

  rejected

  Un jeton HS256 dont la clé est le texte PEM a échoué face à la clé publique EC, mais une HmacKey construite à partir des octets PEM l’a vérifié.

  Relevé par la vérification

  fact jwt-hmac-public-key = rejected
  evidence jwt-hmac-public-key: JwtConsumer with the EC public key: InvalidJwtException: JWT processing failed. Additional details: [[17] Unable to process JOSE object (cause: org.jose4j.lang.InvalidKeyException: class sun.security.ec.ECPublicKeyImpl cannot be used for HMAC verification.):
  evidence jwt-hmac-public-key: JwtConsumer with an HmacKey built from the PEM bytes: verified

• Courbe vérifiée par rapport à alg

  enforced

  Signer en ES256 avec une clé P-384 échoue avec ES256/SHA256withECDSA expects a key using P-256 but was P-384.

  Relevé par la vérification

  fact jwt-ecdsa-curve-check = enforced
  evidence jwt-ecdsa-curve-check: InvalidKeyException: ES256/SHA256withECDSA expects a key using P-256 but was P-384

• Décalage d’horloge toléré par défaut

  0s

  Aucune tolérance au décalage d’horloge par défaut : un jeton expiré depuis trois secondes a été rejeté.

  Relevé par la vérification

  fact jwt-clock-skew = 0s

• Claim d’expiration obligatoire

  no

  Un jeton sans exp a été accepté ; setRequireExpirationTime() rend ce claim obligatoire.

  Relevé par la vérification

  fact jwt-exp-required = no

• Secret HMAC court

  rejected

  HS256 a refusé une clé de 16 octets : A key of the same size as the hash output ... or larger MUST be used.

  Relevé par la vérification

  fact jwt-hmac-short-secret = rejected
  evidence jwt-hmac-short-secret: HS256 with a 16-byte key: InvalidKeyException: A key of the same size as the hash output (i.e. 256 bits for HS256) or larger MUST be used with the HMAC SHA algorithms but this key is only 128 bits

Utilisation

import org.jose4j.jwa.AlgorithmConstraints.ConstraintType;
import org.jose4j.jwk.EcJwkGenerator;
import org.jose4j.jwk.EllipticCurveJsonWebKey;
import org.jose4j.jws.AlgorithmIdentifiers;
import org.jose4j.jws.JsonWebSignature;
import org.jose4j.jwt.JwtClaims;
import org.jose4j.jwt.consumer.JwtConsumer;
import org.jose4j.jwt.consumer.JwtConsumerBuilder;
import org.jose4j.keys.EllipticCurves;

public class Usage {
    public static void main(String[] args) throws Exception {
        EllipticCurveJsonWebKey key = EcJwkGenerator.generateJwk(EllipticCurves.P256);
        JwtClaims claims = new JwtClaims();
        claims.setSubject("user-42");
        claims.setIssuer("https://auth.example.com");
        claims.setExpirationTimeMinutesInTheFuture(10);

        JsonWebSignature jws = new JsonWebSignature();
        jws.setPayload(claims.toJson());
        jws.setAlgorithmHeaderValue(AlgorithmIdentifiers.ECDSA_USING_P256_CURVE_AND_SHA256);
        jws.setKey(key.getPrivateKey());

        // Pin the algorithm and require exp; the defaults would allow any non-'none' alg for the key.
        JwtConsumer consumer = new JwtConsumerBuilder()
            .setJwsAlgorithmConstraints(ConstraintType.PERMIT, AlgorithmIdentifiers.ECDSA_USING_P256_CURVE_AND_SHA256)
            .setVerificationKey(key.getPublicKey())
            .setExpectedIssuer("https://auth.example.com")
            .setRequireExpirationTime()
            .setAllowedClockSkewInSeconds(30)
            .build();
        System.out.println("sub: " + consumer.processToClaims(jws.getCompactSerialization()).getSubject());
    }
}