●Change8

Migrating to JWT Libraries v3.1.0

Version v3.1.0 introduces 1 breaking change. This guide details how to update your code.

Released: 6/23/2025

1
Breaking Changes
1
Migration Steps
3
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

JWT::EncodedToken#payloadOpenSSL::PKey::ECOpenSSL::PKey::EC::Point

Breaking Changes

●Issue #1

Accessing JWT::EncodedToken#payload now requires claims to have been verified first. Previously, this could be accessed without verification, potentially leading to insecure usage.

Migration Steps

  1. 1
    If you were accessing JWT::EncodedToken#payload before verifying claims, ensure you call #verify before accessing #payload.

Release Summary

Version 3.1.0 introduces significant security and feature enhancements, including JWK support and stricter key validation for ECDSA, alongside a breaking change requiring claim verification before accessing the token payload.

Need More Details?

View the full release notes and all changes for JWT Libraries v3.1.0.

View Full Changelog