Repository navigation
irlume v0.15.0
Highlights
- PAM wiring:
irlume login enable --adjust-jumpscan preserve an
administrator's numeric PAM jump while adding Irlume's lines, including the
Fedora fingerprint-to-wallet path. The preview names each proposed change;
the adjustment remains opt-in. - PAM file handling: the reader follows libpam's line and control grammar
more closely. Files it cannot safely interpret are retained with a numbered
explanation, and disable preserves unrelated bytes. - Keyring handling: keyring setup recognizes oo7, preserves the armed
secret kind during reseal, and checks the session and PAM hand-off needed
for the requested operation. - TUI: Overview shows recent account-scoped attempts; Faces groups scans
by camera and records capture dates for new scans. Wallet, Recovery and
Diagnostics have clearer actions, observation states and keyboard navigation. - Account and credential checks: enrollment and sealed state are bound to
account UIDs, replacement state survives interrupted writes, and non-root
diagnostics omit other accounts' authentication activity. - Packaged daemon fixes: AppArmor permits the required ONNX Runtime PCI
discovery and sealed-storage probes. Package upgrades preserve more of the
administrator's service and reconciliation choices. - NixOS recovery staging: the NixOS module stages the self-service retry
password verifier in a root-owned runtime directory before the daemon
starts, preserving the store-trust checks, and documents the activation
path. A regression VM suite covers reset, wrong-password refusal, unsafe
mode and package overrides without the helper. - Dependency correction: the locked chacha20 backend moves off the yanked
0.10.1 release to 0.10.2, correcting the SSE2-only RNG path inherited
through rand.
The full changelog
retains the detailed changes and issue references.
Upgrade notes
Upgrade the daemon, CLI, PAM module and helpers together. Verify that the
running daemon has restarted into the matching version. Keep a working
password/admin session while checking the upgraded login and wallet paths.
Fedora 43/44 users with a GNOME keyring token armed: run
irlume keyring forget before upgrading the operating system to Fedora 45.
Fedora 45's oo7 migration expects the login password. After the first login on
Fedora 45, irlume keyring arm seals that password for oo7.
Some PAM layouts no longer qualify for automatic wiring. Review the command's
output: an enable that finds no suitable anchor can retain lines installed by
an earlier version. Use the documented
disable procedure
when unwiring such a stack, and review any refusal concerning numeric jumps.
NixOS users: on current nixpkgs releases (verified on 26.05) the SDDM
display manager evaluates authentication through a generated login
substack. Irlume's greeter rule runs after that substack, so an
empty-password face attempt cannot complete the login even though the daemon
verifies the face and unseals the sealed password. Face login at the lock
screen is unaffected, and the password fallback always works. The NixOS
module's greeter integration will be revised for this architecture.
On NixOS, Irlume seals only the login password kind of keyring secret. An
account with an existing KDE wallet gets a clear refusal from
irlume keyring arm instead of a partial seal; see
docs/NIXOS.md.
The Plasma System Settings module (services.irlume.kcm.enable) now has a
verified live load on NixOS 26.05.
Scope and limitations
Experimental IR-only authentication remains opt-in and subject to its existing
qualification limits. Support remains tied to the versioned hardware evidence.
ADR-0032 records a proposed administrator-authorized cross-device pairing
design. This release does not enable that design or establish T480 split-pair
face authentication. Automatic camera selection also remains unchanged; the
new pure selection functions are groundwork for later integration.
NixOS greeter face login is subject to the substack limitation above until
the module revision lands. All other surfaces, including lock-screen face
unlock, retry recovery and password fallback, are qualified on NixOS 26.05.
Validation
- Required CI, workflow audit, the seven-job install matrix and the hardware
suite all passed on the release commit
(audit,
install matrix,
hardware suite:
real TPM, IR capture and hardware-inclusive coverage, runners archhost and
minihost). - Native package qualification on the release source: four-stage
upgrade/rollback transactions and passive service-state sweeps on Arch,
Fedora 44, Debian and the Ubuntu PPA lane, with 16 recorded transactions,
32 password outcomes and 48 state transitions. - NixOS: the retry-recovery VM regression suite passed on both the stable
channel and the project flake; an attended live-host acceptance on NixOS
26.05 covered enrollment, camera qualification, lock-screen face unlock,
liveness rejections, greeter password fallback and the KCM. - CodeQL analysis completed with zero findings on the release commit.
Downloads and verification
Packages include the main Arch package, its optional KCM package, and the
universal Debian/Ubuntu package (Debian 12 or newer, Ubuntu 22.04 or newer).
SHA256SUMS and SHA256SUMS.asc cover the packages, six Rust CycloneDX
SBOMs, the Arch KCM native-dependency SBOM, and the OpenVEX document. The
release signing key fingerprint is
F35053398E3C80FE20891B82C10B8492BD7F30C6. Verify with
VERIFY.md.