Skip to content

v0.15.3

Choose a tag to compare

@github-actions github-actions released this 07 Nov 07:34
· 75 commits to main since this release
9ccc3b8

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.