JWCrypto

Факты и проверки, на которых они основаны

Ничего из приведённого ниже не скопировано из документации. 20 октября 2026 г. проверка content/libraries/verify/jwcrypto/run.sh запустила JWCrypto 1.6.1 в среде cryptography 50.0.2 в образе контейнера python:3.14.8-slim-trixie; содержимое страницы должно совпадать с выводом проверки, а у каждого факта приведены соответствующие строки вывода.

• Алгоритмы JWS

  HS256HS384HS512RS256RS384RS512PS256PS384PS512ES256ES384ES512ES256KEdDSAEd25519Ed448ML-DSA-44ML-DSA-65ML-DSA-87

  Подпись и проверка работают для HS, RS, PS и ES на 256/384/512 бит, ES256K, EdDSA, Ed25519, Ed448 и ML-DSA-44/65/87 (с ключами AKP); все они входят в список разрешённых по умолчанию.

  Что записала проверка

  fact jws-algorithms = HS256, HS384, HS512, RS256, RS384, RS512, PS256, PS384, PS512, ES256, ES384, ES512, ES256K, EdDSA, Ed25519, Ed448, ML-DSA-44, ML-DSA-65, ML-DSA-87
  evidence jws-algorithms: ML-DSA-44: JWK kty AKP
  evidence jws-algorithms: ML-DSA-65: JWK kty AKP
  evidence jws-algorithms: ML-DSA-87: JWK kty AKP
  evidence jws-algorithms: default allowed list: HS256, HS384, HS512, RS256, RS384, RS512, ES256, ES384, ES512, PS256, PS384, PS512, EdDSA, ES256K, Ed25519, Ed448, ML-DSA-44, ML-DSA-65, ML-DSA-87

• Кодировка подписи ES256

  raw

  Подписи ES256 — 64 байта в формате raw r‖s.

  Что записала проверка

  fact jws-ecdsa-encoding = raw

• Подпись в DER внутри JWS

  rejected

  Подпись ES256 в кодировке DER не проходит проверку с ошибкой InvalidJWSSignature: Verification failed for all signatures.

  Что записала проверка

  fact jws-der-signature = rejected
  evidence jws-der-signature: InvalidJWSSignature: Verification failed for all signatures["Failed: [InvalidJWSSignature('Verification failed')]"]

• Список разрешённых алгоритмов

  from-key

  Без algs действует список по умолчанию, а всё решает тип ключа: токен ES256 прошёл проверку с ключом EC, а проверка токена RS256 этим же ключом завершилась ошибкой.

  Что записала проверка

  fact jwt-algorithm-allowlist = from-key
  evidence jwt-algorithm-allowlist: no algs argument: verified; RS256 token with the EC key: InvalidJWSSignature: Verification failed for all signatures["Failed: [InvalidJWSSignature('Verification failed')]"]

• Неподписанные токены (alg none)

  opt-in

  Неподписанный токен по умолчанию отклоняется с ошибкой Algorithm not allowed и проходит проверку только с algs=["none"].

  Что записала проверка

  fact jwt-alg-none = opt-in
  evidence jwt-alg-none: with the EC key: InvalidJWSSignature: Verification failed for all signatures["Failed: [InvalidJWSOperation('Algorithm not allowed')]"]
  evidence jwt-alg-none: algs ['none'] with an empty oct key: verified

• Открытый ключ в роли секрета HMAC

  rejected

  Токен HS256 не прошёл проверку открытым ключом EC в формате JWK; проверку он прошёл только с намеренно созданным JWK типа oct, содержащим текст PEM.

  Что записала проверка

  fact jwt-hmac-public-key = rejected
  evidence jwt-hmac-public-key: HS256 token checked with the EC public JWK: InvalidJWSSignature: Verification failed for all signatures["Failed: [InvalidJWSSignature('Verification failed')]"]
  evidence jwt-hmac-public-key: only an explicit oct JWK made from the PEM text verifies it: True

• Сверка кривой с alg

  enforced

  При подписи ES256 ключом P-384 выбрасывается Curve requested is "P-256", but key curve is "P-384".

  Что записала проверка

  fact jwt-ecdsa-curve-check = enforced
  evidence jwt-ecdsa-curve-check: InvalidJWKValue: Curve requested is "P-256", but key curve is "P-384"

• Допустимое расхождение часов по умолчанию

  60s

  Проверка срока действия по умолчанию допускает расхождение часов в 60 секунд: токен, срок действия которого истёк 57 секунд назад, прошёл проверку, а просроченный на 63 секунды — нет.

  Что записала проверка

  fact jwt-clock-skew = 60s

• Обязательное утверждение о сроке действия

  no

  Токен без exp прошёл проверку; чтобы сделать это утверждение обязательным, укажите exp в check_claims.

  Что записала проверка

  fact jwt-exp-required = no
  evidence jwt-exp-required: verified

Использование

import json
import time

from jwcrypto import jwk, jwt

key = jwk.JWK.generate(kty="EC", crv="P-256", kid="2026-10")
public = jwk.JWK.from_json(key.export_public())

token = jwt.JWT(header={"alg": "ES256", "kid": "2026-10"}, claims={"sub": "user-42", "iss": "https://auth.example.com", "exp": int(time.time()) + 600})
token.make_signed_token(key)

# algs narrows the default list; check_claims makes iss and exp mandatory.
checked = jwt.JWT(
    jwt=token.serialize(),
    key=public,
    algs=["ES256"],
    check_claims={"iss": "https://auth.example.com", "exp": None},
)
print("sub:", json.loads(checked.claims)["sub"])