- Decision
- ADR-215
- Date
- 2026-11-03
- Status
- ProposedProposed (owner's requirement 2026-11-03; written and host-checked 2026-11-03 in
freeholdos-platformpasswords/app2b6447c, landed on the build tree 2026-11-03 asvendor/freeholdos/passwords263f237, not built, not on a device) - Part
- Passwords
- Mentions
- ADR-193
- Mentioned by
- ADR-237
1Decision
Amend point (5) of ADR-193 ("fresh biometric or passphrase") for the Passwords app: an unlock or a confirmation, by passphrase or fingerprint, opens a window of 60 seconds in which the actions that ask for a confirmation (show or copy a password, export, delete a password, switching biometrics off, a CSV import, trusting a browser) do not ask again, like sudo's timestamp. The window is fixed from the last authentication and is not renewed by use; every lock of the vault (screen off, device lock, the minute in the background, a forgotten vault) ends it, and it never applies to a locked vault.
2Why and evidence
Owner 2026-11-03 (chat): whoever has just entered the passphrase in the Passwords app must not have to enter it again within 60 seconds, as with sudo, and the same for the fingerprint. Cause of the repeated prompts [verified-in-source: AppController.confirmUser]: every confirming action calls confirmUser, which always opens a biometric prompt or the passphrase dialog, however recent the unlock was.
The window lives in LockPolicy (onAuthenticated, confirmedRecently, constant CONFIRM_GRACE_MS), is started by every unlock and by SessionManager.verifyPassphrase and confirmWithBiometrics, and is read by AppController.confirmUser through SessionManager.confirmedRecently, which is true only in the unlocked state. The monotonic clock is used, so a clock set back changes nothing.
Rejected: a window renewed at every use (sudo does that; here a thief who holds an open phone would extend it without limit, and the vault itself already locks after a minute in the background); a window that survives a lock.
3Consequences
The prompt of Export, Delete password, Import, Trust browser and the eye is skipped for up to 60 seconds after an unlock or a confirmation, so someone who picks up an open phone in that minute can show, copy, export or delete without the passphrase; the vault was open for them already, and the export still asks its own export passphrase. ADR-193 (5) otherwise stands; the page and fill rules of ADR-193 are untouched.
4Review when
Accepted when the device row PWM-025 passes on an image that carries it and the owner has read the consequence; reopen if the window is wanted shorter, off for export and delete, or renewed by use.
Read from docs/governance/decision-log.md, entry ADR-215.