Skip to content

irlume v0.15.0

Choose a tag to compare

@archledger archledger released this 29 Sep 18:19
· 374 commits to main since this release
v0.15.0
4288677

Highlights

  • PAM wiring: irlume login enable --adjust-jumps can 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.