App passwords; CalDAV / CardDAV server for phones, Thunderbird, macOS

App passwords (SPEC App. D §D.5): one generated password per app, shown once,
revocable on its own, revoked on a password reset; never accepted by the web
sign-in. Settings → Security → App passwords (migration 0024).

CalDAV / CardDAV server (SPEC Appendix E), built in: /dav/ with
/.well-known/caldav|carddav, HTTP Basic with app passwords only (cached checks,
throttled failures). The calendar and contacts plugins serve their own tables as
collections (Plugin(dav=...)):
- calendars as iCalendar: series with overrides, time zones, all-day, attendees
  and RSVP, alarms <-> reminders; MKCALENDAR / PROPPATCH / DELETE of calendars;
  subscriptions read-only; writes to upstream-synced calendars flow on upstream;
- address books as vCard (3.0 served, 3.0/4.0 read), groups as CATEGORIES;
- what a client stores is served back verbatim until the web app edits it;
- sync tokens / CTags from change logs filled by triggers (calendar0008,
  contacts0002), so every write path counts; trimmed nightly after 90 days.
REPORTs: calendar-query (time range), calendar-/addressbook-multiget,
addressbook-query, sync-collection. nginx and the Vite proxy route /dav/.
Settings shows the server and user name to enter; install guide §5.4.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-09 21:49:04 +02:00
co-authored by Claude Opus 5.5
parent fa552392c8
commit 0e3793a4d6
30 changed files with 3968 additions and 4 deletions
+18
View File
@@ -596,6 +596,24 @@ then also needs `https://ultimo.email/.well-known/assetlinks.json` naming the
Android package and its signing-certificate fingerprint — served by nginx
like any other static file.
### 5.4 Calendars and contacts in other apps (CalDAV / CardDAV)
Ultimo serves each user's calendars and address books to standard apps, which
sync two-way with the web app: iPhone/iPad and macOS Calendar & Contacts,
Thunderbird, Android through DAVx⁵, GNOME/Evolution.
- **Server:** `https://ultimo.email/dav/` — most apps also find it from just
`ultimo.email` (`/.well-known/caldav`, `/.well-known/carddav`).
- **User name:** the full Ultimo address. **Password:** an **app password**
(Settings → Security → App passwords) — the account password is refused, so
2FA cannot be bypassed and a lost device is one revocation away. Settings shows
the exact server and user name to type.
- nginx passes `/dav/` and the two well-known paths to the API (in
`docker/nginx-app.conf`). A reverse proxy in front (QNAP, DSM) must pass them
too, with the `Authorization` header — the default.
- HTTPS is required by iOS/macOS for these accounts.
- Repeated wrong passwords are throttled per address and per IP (15 minutes).
---
## 6. Resource usage