Skip to content

Teampass

v3.2.0.6 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 23d Secrets & Credentials
βœ“ No known CVEs patched
Read the diff β†’ Tool health β†’ What is this tool? β†’

✓ No known CVEs patched in this version

Topics

php

Affected surfaces

auth breaking_upgrade

Summary

AI summary

Updates Important, πŸ› οΈ Improvements, and πŸ› Bug fixes across a mixed release.

Full changelog

What's Changed

This maintenance release fixes a data-access issue where some users could see an item but not decrypt it (crossed-out password icon), caused by missing encryption sharekeys. It also adds an admin tool to detect and repair those missing keys.

πŸ› Bug fixes

  • Fix missing sharekeys on folder copy.
    When copying a folder, the copied items relied entirely on the background distribution task to create the per-user encryption keys, and items whose internal reference key (TP_USER) was missing were silently skipped. The copier and the internal reference account now get their sharekey synchronously at copy time, so a copied item is immediately usable and stays recoverable when user keys are regenerated later. Items that genuinely cannot be decrypted are now reported instead of being lost silently.
  • Harden sharekey distribution (resilience).
    Key distribution was all-or-nothing: a single user with an invalid public key raised an exception that aborted the distribution for everyone. Each user is now processed independently β€” a failure is logged and the process continues for the remaining users, without ever deleting existing valid keys.
  • Stop leaking personal-item keys on copy.
    Copying a personal item no longer queues a distribution task that would hand its key to every user; personal items stay private to their owner.

✨ New

  • Admin tool: "Restore missing sharekeys" (Tools page).
    A new maintenance tool detects and recreates missing encryption sharekeys for items, custom fields and files. The analysis is a read-only pass; the repair first restores the missing internal reference keys using your own account, then a background task distributes the missing keys to every user. Only missing keys are created β€” existing keys are never modified, and personal items are excluded. Objects that no account can decrypt are flagged as not automatically recoverable, with guidance to have a user who can still open them re-save the item.

πŸ› οΈ Improvements

  • Background user-key generation steps now log the number of skipped objects (expected for other users' personal items) as warnings, making key-distribution gaps easier to diagnose.
  • Fixed a TypeError that could occur while seeding the internal reference (TP_USER) sharekeys in the repair tool.
  • Documentation updated.

Full Changelog

Full Changelog: https://github.com/nilsteampassnet/TeamPass/compare/3.2.0.5...3.2.0.6

Important

  • Requires at least PHP 8.2

Languages

Please join Teampass v3 translation project on Poeditor and translate it for your language.

Installation

Follow instructions from Documentation.

Upgrade

Follow instructions from Documentation.

Ideas and comments

Are welcome ... please use Discussions.

Breaking Changes

  • Requires at least PHP 8.2

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track Teampass

Get notified when new releases ship.

Sign up free

About Teampass

Password manager dedicated for managing passwords in a collaborative way. One symmetric key is used to encrypt all shared/team passwords and stored server side in a file and the database. works on any server Apache, MySQL and PHP.

All releases β†’

Related context

Earlier breaking changes

  • v3.2.0.8 Enforces folder‑level rights on bulk delete, move, and items_delete operations (#5275).

Beta — feedback welcome: [email protected]