Home

>

Tools

>

Strapi

>

Releases

>

4.4.1

Strapi Release: 4.4.1

Tag Name: v4.4.1

Release Date: 9/29/2022

Strapi LogoStrapi

Open-source headless CMS built with Node.js. Provides developers with complete freedom in choosing their favorite tools and frameworks for frontend development.

TL;DR

Strapi v4.4.1 is a security and bug fix release that addresses a vulnerability in the Users & Permissions plugin, fixes issues with user creation and custom admin panel builds, and enhances the Media Library with improved asset card interactions. This release is important for all Strapi users to apply, especially those concerned with security and those using custom admin panel configurations.

Highlight of the Release

    • Security fix for the Users & Permissions plugin addressing a filter parameter vulnerability
    • Improved user creation process by normalizing email addresses to lowercase
    • Fixed build errors when the src/admin folder is missing
    • Enhanced Media Library with clickable asset cards that open in modals

Migration Guide

No specific migration steps are required for this patch release. Simply update your Strapi installation to version 4.4.1 using your package manager:

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

After updating, restart your Strapi application to apply the changes.

Upgrade Recommendations

Priority: High

All Strapi users are strongly encouraged to upgrade to v4.4.1 as soon as possible, especially due to the security fix in the Users & Permissions plugin. This is a patch release that should not introduce any breaking changes to your application.

For users with custom admin panel configurations that might not include a src/admin folder, this update is particularly important as it resolves build errors you may have encountered.

To upgrade:

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

Bug Fixes

Admin Panel Build Error

Fixed an issue where building a custom admin panel would fail if the src/admin folder was missing. The system now properly checks if the folder exists before attempting to access files inside it, making custom admin panel configurations more robust.

User Email Normalization

Resolved an issue with user creation by ensuring email addresses are converted to lowercase. This prevents the creation of duplicate user accounts that differ only in the case of their email addresses (e.g., [email protected] and [email protected]), improving user management consistency.

New Features

Media Library Enhancements

The Media Library has been improved with a new feature that allows users to click on AssetCards to open them in a modal. This enhancement provides a more intuitive and efficient way to interact with media assets in the Strapi admin panel.

  • Implemented a unified AssetCardBase component for consistent behavior
  • Added ability to handle desired actions when interacting with asset cards
  • Included comprehensive tests for the new interaction patterns

Security Updates

in Users & Permissions Plugin

This release addresses an important security vulnerability in the Users & Permissions plugin. The issue was related to an incorrect filter parameter being used with the entityService, which could potentially lead to unauthorized access or data exposure.

The fix ensures that the proper filter parameters are used when interacting with the entityService in the Users & Permissions plugin, strengthening the security of Strapi installations.

Performance Improvements

No specific performance improvements were highlighted in this release. The changes were primarily focused on security fixes, bug fixes, and UI enhancements.

Impact Summary

Strapi v4.4.1 is a security-focused patch release that addresses a vulnerability in the Users & Permissions plugin while also fixing important bugs in the admin panel. The security fix prevents potential unauthorized access through improper filter parameter usage.

The bug fixes resolve issues with custom admin panel builds that don't include a src/admin folder and normalize email addresses during user creation to prevent duplicate accounts. Additionally, the Media Library receives a usability enhancement with clickable asset cards that open in modals.

This release has minimal impact on existing functionality but significantly improves security and stability. All users should upgrade promptly, especially those concerned with security or those using custom admin panel configurations.

Full Release Notes

⚠️ Security Fix

  • [plugin:users-permissions] Fix wrong filter param used with the entityService in UP (#14500) @derrickmehaffy 🚀

🔥 Bug fix

💅 Enhancement

  • [core:upload]: Add ability to click on AssetCard and have it envoke a modal (#14475) @joshuaellis

📚 Update and Migration Guides

  • General update guide can be found here
  • Migration guides can be found here 📚

Statistics:

File Changed56
Line Additions1,045
Line Deletions932
Line Changes1,977
Total Commits15

User Affected:

  • Protected from a security vulnerability in the Users & Permissions plugin
  • Email addresses are now treated as lowercase when creating users, preventing duplicate accounts with different case variations
  • Can build custom admin panels without requiring the src/admin folder

Contributors:

CleberRossijhoward1994joshuaellisConvlyderrickmehaffy