github NeySlim/ultimate-ca-manager v2.254.4
v2.254.4 The Last Stand

35 minutes ago

2.254 is the last stand of UCM 2.x: security fixes will keep coming, new features will not. The next chapter is already being written.

What's Changed

Security

  • SSO: the password reset by e-mail set a local password on an account created by an SSO provider, which then opened without the provider. Such an account gets no reset link any more, and a reset token sets no password on it.

Fixed

  • SSO: an OIDC provider with role mapping rules, such as Microsoft Entra ID whose UserInfo response has no groups, refused every user; the rules now read the groups and roles of the ID token validated for the login together with those of the UserInfo response, and a roles claim no longer hides groups.
  • SSO: a SAML assertion that repeats an attribute name, as Keycloak's role list does with one attribute per role, was refused as invalid; its values are now merged in assertion order, role mapping reads them all and a repeated username or email attribute gives its first value.
  • SSO: LDAP groups read through member or uniqueMember were searched only under the parent of the base DN, so a base DN at the domain root found none and the user was refused. They are searched under that parent when the directory holds it, else under the base DN, and a refused search is tried once more under the base DN.
  • SSO: an LDAP provider with role mapping rules or required groups and no group filter read no group and refused everyone; the groups are now read without one.
  • SSO: an LDAP memberOf value that is not a DN ended the group read and lost the groups listed after it; only that value is skipped now, with a warning in the log.
  • SSO: an LDAP role mapping rule pki-admins did not match the directory group PKI-Admins. LDAP rules and groups now compare ignoring case, edge spaces and inner space runs (OIDC and SAML stay exact), and two rule keys a provider compares equal are refused at save.
  • SSO: an LDAP login whose groups could not be read was refused as "no role mapping rule matches". It is now refused with "your groups could not be read from the directory", in the response, the log and the audit, and does not count as a failed attempt.
  • SSO: the LDAP mapping test read the groups by its own code and showed a resolved role for a user the login refuses. It now gives the login's verdict and the reason of a refusal.
  • SSO: the Active Directory userAccountControl check never read the attribute's value, so the mapping test reported a disabled account as allowed. It now reports it disabled, and a login the directory binds despite that flag is refused.
  • SSO: Link to SSO refused every account already linked or left without provider, the remedy sign-in refusals named, and Unlink then Link made an account without password set one. It now attaches any account to the chosen provider (moving it, or resetting its SSO identity), keeps a password it has, asks none of an account without, can remove its local password, closes the account's sessions whenever its provider, identity or password changes, and its audit entry says where the account came from.
  • SSO: a sign-in whose email belonged to an account of another provider or left without provider by another or an unknown IdP (after a restore, for instance), or to an account an administrator linked while the OIDC IdP marked that email unverified, received a second account with the default role; it is now refused (sso_email_conflict) with an audit entry naming the account.
  • SSO: a sign-in refused over a name gave the same reason for every account; the log and audit entry now say whether the account is local, linked to another provider, bound to another identity or without provider, and what repairs it. A provider with no rule and no default role now says so on the login page (sso_no_default_role).

📜 Recent release history (last 2 versions)

[2.254.3] - 2026-11-16

Security

  • FIPS: the -fips Docker image recomputed the integrity value of the FIPS module at each start, so a fips.so modified after the build still passed its self-tests; the start in FIPS mode now compares it to the value recorded when the image was built and refuses a modified module, a missing or malformed record, or an OPENSSL_MODULES that is not the directory of that module.
  • Restore: with sessions on disk, the session of the operator who restored and any session whose request was in flight were written back once the restore had removed them, and with Redis no session was revoked at all, so they stayed signed in after the accounts were replaced. Each restore now advances an epoch every session carries, so no session begun before it is accepted afterwards, whatever the store.

[2.254.2] - 2026-11-15

Changed

  • Updates: the update check, the update notification and the unattended install now stay within the installed major version, so a later major version is never installed automatically and this line's maintenance releases stay visible (releases are now read 100 per page).
  • Updates: a later major version published as a final release is offered apart as a recommended upgrade with its release notes, installed only on an explicit, confirmed request (major_upgrade: true and its version on POST /api/v2/system/updates/install); system.update_available announces it once per major version, with major_upgrade set.
  • Updates: the Updates page states that this version line is in security maintenance: security fixes will keep coming, new features will not.

Full history: CHANGELOG.md


Installation

Docker (Recommended)

# From Docker Hub
docker pull neyslim/ultimate-ca-manager:2.254.4

# Or from GitHub Container Registry
docker pull ghcr.io/neyslim/ultimate-ca-manager:2.254.4

# Run
docker run -d -p 8443:8443 \
  -e SECRET_KEY=$(openssl rand -hex 32) \
  --name ucm neyslim/ultimate-ca-manager:2.254.4

Debian/Ubuntu

wget https://github.com/NeySlim/ultimate-ca-manager/releases/download/v2.254.4/ucm_2.254.4_all.deb
sudo dpkg -i ucm_2.254.4_all.deb
sudo apt-get install -f

Fedora

wget https://github.com/NeySlim/ultimate-ca-manager/releases/download/v2.254.4/ucm-2.254.4-1.fc43.noarch.rpm
sudo dnf install ./ucm-2.254.4-1.fc43.noarch.rpm

RHEL, AlmaLinux, Rocky Linux 9

wget https://github.com/NeySlim/ultimate-ca-manager/releases/download/v2.254.4/ucm-el9-2.254.4-1.el9.noarch.rpm
sudo dnf install ./ucm-el9-2.254.4-1.el9.noarch.rpm

FIPS mode (preview)

FIPS mode is a preview: feedback is welcome on #399. Full guide: FIPS Mode.

Docker, any Linux host (amd64, arm64):

docker run -d -p 8443:8443 -e UCM_FIPS=1 \
  -v ucm-data:/opt/ucm/data -v ucm-config:/etc/ucm \
  --name ucm neyslim/ultimate-ca-manager:2.254.4-fips

Ubuntu 24.04 with Ubuntu Pro (sudo pro enable fips-updates, then reboot):

sudo apt-get install -y gcc pkg-config python3-dev python3-venv libpq-dev libxml2-dev libxslt1-dev \
    zlib1g-dev libssl-dev libxmlsec1-dev libxmlsec1t64-openssl rustc-1.91 cargo-1.91
sudo install -d -m 750 /etc/ucm && echo 'UCM_FIPS_BUILD=1' | sudo tee /etc/ucm/ucm.env
sudo apt install ./ucm_2.254.4_all.deb

RHEL, AlmaLinux, Rocky Linux 9 (sudo fips-mode-setup --enable, then reboot; on RHEL, enable CodeReady Builder instead of CRB):

sudo dnf config-manager --set-enabled crb
sudo dnf install -y python3.12-devel gcc pkgconf-pkg-config libpq-devel libxml2-devel libxslt-devel \
    openssl-devel xmlsec1-devel xmlsec1-openssl libtool-ltdl-devel rust cargo
sudo install -d -m 750 /etc/ucm && echo 'UCM_FIPS_BUILD=1' | sudo tee /etc/ucm/ucm.env
sudo dnf install ./ucm-el9-2.254.4-1.el9.noarch.rpm

The package builds its crypto libraries against the system OpenSSL (about five minutes), sets UCM_FIPS=1 on a host in FIPS mode and prints a readiness report. Fedora, Debian and other distributions are not supported in FIPS mode: use the Docker image.

Silent/Automated Install

# Skip firewall prompts for CI/automation
sudo UCM_PORT=8443 UCM_FIREWALL=no dpkg -i ucm_2.254.4_all.deb

Default Credentials

  • Username: admin
  • Password: changeme123

Change the password immediately after first login!

Documentation

Don't miss a new ultimate-ca-manager release

NewReleases is sending notifications on new releases.