Repository navigation
v0.15.3
v0.15.3: app passwords
App passwords
- An app password is a per-device credential for IMAP, POP3, SMTP submission,
CalDAV and CardDAV. It never signs in to the web interface. - Each password has 24 letters. Bongo shows it once and stores only a hash.
- Settings, Security lists each password with its label, creation date and last
used date. A user can hold up to 10. - Creating a password needs the account password, and a code with 2FA on.
- A successful app password login forgives no failed guesses at the account
password. - A user name with the shape of an app password is not logged.
- Revoking a password refuses its next login and ends the IMAP, POP3 and SMTP
sessions it opened on their next command. - Change password has a box, ticked by default, that also revokes all app passwords.
- An admin can revoke all of a user's app passwords.
Add a device
- Add a device shows a new app password beside the server settings. These match
the autoconfig documents. - Apple devices can download a personal profile with Mail, Calendar, Contacts and
Reminders set up. The profile is unsigned, so the device shows Not Verified. - A QR code holds a one-time link for a phone. The link expires after 5 minutes
and works once.
Require app passwords
- An account with 2FA and at least one app password can turn on Require app
passwords. IMAP, POP3, SMTP submission, CalDAV and CardDAV then refuse the
account password. - Turning it on ends sessions opened with the account password.
- The switch is offered at the end of 2FA enrolment and on the Security page.
Documentation
- docs/caldav-carddav.md, docs/sendmail.md, docs/walkthrough.md and SECURITY.md
cover app passwords and the switch. - docs/design/from-nmap-to-one-binary.md records the move from NMAP agents to one
binary.
Upgrade notes
- No configuration changes.
- Nothing changes for an account until its owner creates an app password or turns
on the switch. - Upgrade every node together. An earlier binary stores the app password touch and
link commands as literal keys, ignores the switch and refuses app passwords.
Known limits
- The Apple profile and QR link have not been checked on real devices.
Full notes: prds/done/prd-app-passwords-v0.15.3.md and prds/verification.md.