go-jose

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/go-jose/run.sh a exécuté go-jose 4.1.6 dans l’image de conteneur golang:1.27.3-trixie 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 bits et EdDSA ; ES256K, Ed25519 et Ed448 échouent avec unknown/unsupported algorithm.

  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: go-jose/go-jose: unknown/unsupported algorithm
  evidence jws-algorithms: Ed25519: go-jose/go-jose: unknown/unsupported algorithm
  evidence jws-algorithms: Ed448: go-jose/go-jose: unknown/unsupported algorithm

• 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 go-jose/go-jose: error in cryptographic primitive.

  Relevé par la vérification

  fact jws-der-signature = rejected
  evidence jws-der-signature: go-jose/go-jose: error in cryptographic primitive

• Liste d’algorithmes autorisés

  required

  jwt.ParseSigned exige la liste des algorithmes autorisés ; une liste vide échoue avec no signature algorithms specified.

  Relevé par la vérification

  fact jwt-algorithm-allowlist = required
  evidence jwt-algorithm-allowlist: ParseSigned with an empty algorithm list: go-jose/go-jose: no signature algorithms specified

• Jetons non signés (alg none)

  rejected

  Avec none dans la liste, un jeton non signé est analysé, mais Claims() échoue avec une clé EC comme avec un secret HMAC ; seul UnsafeClaimsWithoutVerification permet de le lire.

  Relevé par la vérification

  fact jwt-alg-none = rejected
  evidence jwt-alg-none: ParseSigned with none in the list: <nil>
  evidence jwt-alg-none: Claims(*ecdsa.PublicKey): go-jose/go-jose: error in cryptographic primitive
  evidence jwt-alg-none: Claims([]uint8): go-jose/go-jose: error in cryptographic primitive
  evidence jwt-alg-none: UnsafeClaimsWithoutVerification: <nil>, sub fact-check

• Clé publique utilisée comme secret HMAC

  rejected

  Un jeton HS256 dont la clé HMAC était le texte PEM a échoué face à la clé *ecdsa.PublicKey ; il n’a été vérifié que lorsque les octets PEM eux-mêmes ont été passés comme clé.

  Relevé par la vérification

  fact jwt-hmac-public-key = rejected
  evidence jwt-hmac-public-key: Claims with the *ecdsa.PublicKey: go-jose/go-jose: error in cryptographic primitive
  evidence jwt-hmac-public-key: Claims with the PEM bytes as key: <nil>

• Courbe vérifiée par rapport à alg

  enforced

  La signature ES256 avec une clé P-384 échoue avec expected 256 bit key, got 384 bits instead.

  Relevé par la vérification

  fact jwt-ecdsa-curve-check = enforced
  evidence jwt-ecdsa-curve-check: go-jose/go-jose: expected 256 bit key, got 384 bits instead

• Claims validés au décodage

  no

  Claims() a renvoyé sans erreur les claims d’un jeton expiré depuis une heure ; les contrôles de dates et d’émetteur n’ont lieu que dans Validate.

  Relevé par la vérification

  fact jwt-claims-validated-on-decode = no
  evidence jwt-claims-validated-on-decode: Claims() on a token expired an hour ago: <nil>

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

  60s

  Validate tolère jwt.DefaultLeeway, soit une minute : un jeton expiré depuis 57 secondes a été accepté et un jeton expiré depuis 63 secondes a été refusé.

  Relevé par la vérification

  fact jwt-clock-skew = 60s
  evidence jwt-clock-skew: jwt.DefaultLeeway = 1m0s

• Claim d’expiration obligatoire

  no

  Un jeton sans exp a passé Validate ; vérifiez vous-même que Expiry n’est pas nil.

  Relevé par la vérification

  fact jwt-exp-required = no

Utilisation

package main

import (
	"crypto/ecdsa"
	"crypto/elliptic"
	"crypto/rand"
	"fmt"
	"time"

	jose "github.com/go-jose/go-jose/v4"
	"github.com/go-jose/go-jose/v4/jwt"
)

func main() {
	key, _ := ecdsa.GenerateKey(elliptic.P256(), rand.Reader)
	signer, _ := jose.NewSigner(jose.SigningKey{Algorithm: jose.ES256, Key: key}, (&jose.SignerOptions{}).WithType("JWT"))
	raw, _ := jwt.Signed(signer).Claims(jwt.Claims{Subject: "user-42", Issuer: "https://auth.example.com", Expiry: jwt.NewNumericDate(time.Now().Add(10 * time.Minute))}).Serialize()

	// v4 requires the allowed algorithms when parsing.
	token, _ := jwt.ParseSigned(raw, []jose.SignatureAlgorithm{jose.ES256})
	claims := jwt.Claims{}
	sigErr := token.Claims(&key.PublicKey, &claims) // checks the signature only
	// Validate checks exp, nbf and iss (with jwt.DefaultLeeway of one minute).
	valErr := claims.Validate(jwt.Expected{Issuer: "https://auth.example.com", Time: time.Now()})
	fmt.Println("valid:", sigErr == nil && valErr == nil && claims.Expiry != nil, "sub:", claims.Subject)
}