Strapi Release: 5.12.1

TL;DR

Strapi 5.12.1 is a hotfix release that addresses a critical issue with SSO login functionality introduced in version 5.12.0. The fix resolves JWT formatting problems that were preventing users from successfully logging in via SSO authentication methods.

Highlight of the Release

• Fixed critical SSO login functionality that was broken in version 5.12.0
• Resolved JWT formatting issues affecting authentication
• Restored secure authentication workflows for enterprise environments

Migration Guide

No migration steps are required for this hotfix. Simply update from Strapi 5.12.0 to 5.12.1 to resolve the SSO login issues.

npm install [email protected]
# or
yarn upgrade [email protected]

Upgrade Recommendations

Immediate Upgrade Recommended

If you're running Strapi 5.12.0 and using SSO authentication, an immediate upgrade to 5.12.1 is strongly recommended. This hotfix resolves critical authentication issues that may prevent users from logging in through SSO methods.

For users on versions prior to 5.12.0 who are planning to upgrade, it's advisable to skip version 5.12.0 entirely and upgrade directly to 5.12.1 to avoid encountering the SSO login issues.

Bug Fixes

SSO Login JWT Formatting Issues

This release fixes a critical bug in the SSO login functionality that was introduced in version 5.12.0. The issue was related to JWT (JSON Web Token) formatting problems that prevented users from successfully authenticating through Single Sign-On methods.

The fix ensures that JWT tokens are properly formatted during the SSO authentication process, allowing users to log in successfully again.

New Features

No new features were introduced in this hotfix release. This update focuses exclusively on fixing the SSO login functionality.

Security Updates

While not explicitly labeled as a security fix, the resolution of the SSO login JWT formatting issues indirectly addresses security concerns. Properly functioning authentication is a critical security component, and this fix ensures that the authentication system works as intended, maintaining the security integrity of Strapi installations.

Performance Improvements

No specific performance improvements were included in this hotfix release. The focus was on restoring critical functionality rather than enhancing performance.

Impact Summary

This hotfix release has a high impact for Strapi installations that utilize SSO authentication methods. The fix restores critical login functionality that was broken in the previous release (5.12.0), ensuring that users can once again authenticate properly through Single Sign-On.

The impact is particularly significant for enterprise environments and organizations that rely heavily on SSO for user authentication. Without this fix, affected users would be unable to access their Strapi admin panel or API through SSO authentication methods.

The changes in this release are focused solely on fixing the JWT formatting issues related to SSO login, with no other features or improvements included. This targeted approach ensures a quick resolution to the critical authentication problem without introducing any additional changes that might affect system stability.

Full Release Notes