Changes 12/9/2025 (v2.5.1)
release(v2.5.1): upgrade vendor libs and enhance OIDC + admin UX
OIDC & Authentication
- Added OIDC admin demotion control:
- New
FR_OIDC_ALLOW_DEMOTEenv/constant andoidc.allowDemoteadmin toggle. - When enabled, if a user loses admin in the IdP they are also downgraded in FileRise on their next OIDC login.
- When disabled (default), once a user is admin in FileRise they are not demoted automatically by the IdP.
- New
- Improved OIDC → local user sync:
ensureLocalOidcUser()now always promotes when the IdP says admin, and only demotes when demotion is explicitly allowed.- Automatically creates OIDC users when
FR_OIDC_AUTO_CREATEis enabled andusers.txtis missing (file is created with locking).
- Reworked OIDC → Pro group mapping:
FR_OIDC_PRO_GROUP_PREFIX = ''now means “map all IdP groups into Pro groups”.- Non-empty prefixes still only map groups starting with the prefix.
- Cleanup logic only removes memberships in groups that are managed by OIDC, avoiding accidental removals.
- Added OIDC debug logging:
- New
FR_OIDC_DEBUGconstant andoidc.debugLoggingadmin toggle. - Logs a redacted summary of provider URL, redirect URI, client ID presence, token auth method and group counts (no secrets/tokens).
- New
- New admin-only OIDC debug snapshot endpoint:
GET /api/admin/oidcDebugInfo.php(admin only, CSRF protected).- Returns a JSON snapshot (no secrets) of OIDC config, login options and relevant request environment for easier support/debugging.
- Exposed in Admin Panel → OIDC as “Effective OIDC configuration snapshot”.
Admin Panel & UX
- Login & WebDAV section refreshed:
- Combined “Login Options” and WebDAV into one tab: “Login Options & WebDAV Access”.
- Switched from “Disable X” checkboxes to enable-style toggles for:
- Login form
- HTTP Basic Auth
- OIDC login
- Added a clear, explicit “Proxy header only (disable built-in logins)” toggle with validation so you can’t accidentally disable all login paths unless proxy-only is enabled.
- Added a better visual structure for admin sections:
- Reusable
.admin-dividerhorizontal rules and.admin-subsection-titleheadings for header title, logo, colors, footer, upload limits, antivirus, etc. - New
fr-toggleswitch styling used consistently across login options, WebDAV, ONLYOFFICE and ClamAV.
- Reusable
- OIDC settings panel:
- Now includes toggles for “Allow OIDC to downgrade FileRise admins” and “Enable OIDC debug logging”.
- Adds inline help text explaining the demotion behavior and the debug logging use-case.
- Provides a debug snapshot button wired to the new
/api/admin/oidcDebugInfo.phpendpoint. - Moves global TOTP template URL into a clearly-labeled “TOTP configuration” subsection.
Sharing & CSRF
- File context menu now supports sharing:
- Added “Share file” entry to the right-click menu (when exactly one file is selected).
- Opens the existing share modal, so sharing is now discoverable from both inline actions and the context menu.
- Share link deletion:
- Folder/file share delete now sends
X-CSRF-Tokenand handles 403 responses with a clear toast message. - Fixes admin share-link deletion failures under stricter CSRF/session setups.
- Folder/file share delete now sends
Editor, search & vendor updates
- Upgraded bundled vendor libraries:
- Bootstrap 4.5.2 → 4.6.2.
- CodeMirror 5.65.5 → 5.65.18.
- DOMPurify 2.4.0 → 3.3.1.
- Fuse.js 6.6.2 → 7.1.0.
- Updated THIRD_PARTY.md to match new versions and paths.
- Editor and search code now point at the new vendor paths:
- CodeMirror base set to
/vendor/codemirror/5.65.18/. - Fuse.js lazy loader updated to
/vendor/fuse/7.1.0/fuse.min.js.
- CodeMirror base set to
Miscellaneous
- Added CSS for the OIDC debug JSON box to keep long snapshots readable in both light and dark modes.
- Updated admin storage “Deep delete” toggle to use the same
fr-togglestyling as other switches. - Docker start script: silenced noisy
freshclamoutput while still logging a clear message if signature updates fail.
v2.5.1
Full Changelog
SHA-256 (zip)
0833c7fbd5e4441848d55150fd30941eef6e19ba8bf18e54ebea5d493279ded9 FileRise-v2.5.1.zip