[1.3.0] Security and quality after 1.2.5: domain-admin send-log authorization, fail-closed sign-in and application delete, level-2 rate-limit race fix, restore Resync, expanded tests, operator docs, release CI, and OFL for IBM Plex. Upgrading from 1.2.x is a tag bump; no migration. Added: - licence: the SIL Open Font License 1.1 text now travels with the IBM Plex - docs: agreed roadmap item **queue-retries** — show this Postfix's retry Security: - The independent security review of the send-log authorization and Fixed: - test (e2e): send-log status scrapers follow the badge markup in - security (panel): the Deliveries list is scoped to a domain administrator's - mail (level-2 rate limit): the ceiling is no longer overshot by messages that - panel (sign-in): a session that cannot be written to the database no longer - panel (applications): deleting an application removes its SASL credentials … (2 more in CHANGELOG) Changed: - docs: operator and as-built docs aligned with the code after a full - docs: [guide.md](docs/guide.md) reorganised into **Installation**, **Instance - docs: the 2026-08-13 full-tree review plan is complete — every phase (P0–P7) - licence: [NOTICE](NOTICE) tells modifiers to update `SourceURL` in - ci: the release image is published only for a **published** GitHub Release … (9 more in CHANGELOG) [1.3.1] Retry policy in the panel, persistent Postfix queue, and self-contained full backups. Mail queue and delivery history show this Postfix's first retry, backoff cap, and queue lifetime. Deferred mail survives container recreate. Full backups now archive `data/`, compose, `.env`, and `certs/`; the archive layout breaks 1.3.0 flat backups (unpack those with `tar xzf backup.tar.gz -C ./data` as before). Upgrading from 1.3.0 is a tag bump; no schema migration. Added: - Mail queue and a delivery's history show this Postfix's retry policy - docs: **Plan checklists** in [development.md](docs/development.md) — format, - docs: **Implementation checklists** with model routing in - docs: roadmap candidates **send-log-retention** (panel Settings for delivery - Postfix queue under `/data/postfix/queue` — deferred and active mail survive … (1 more in CHANGELOG) Changed: - **Breaking:** full-backup archive layout — paths are prefixed with `data/`; - docs: operator guide, architecture, security, and backup UI updated for - docs: HTML mockups for a full panel UI refresh Changed: - docs: panel UI mockups after review — Status restored to live readings - docs: panel UI design system and mockups rebuilt as separate pages - docs: panel UI mockups — add-domain sits in the list card (Domains and Fixed: - ci (GHCR): per-arch package tags (`X.Y.Z-amd64`, `X.Y.Z-arm64`) are dropped Squashed CHANGELOG sections: [1.3.0], [1.3.1]. Full detail: CHANGELOG.md (1.3.0, 1.3.1).
2.5 KiB
2.5 KiB
Plan: dmarc-reports
Status: candidate
Goal
SelfPost receives DMARC aggregate reports on SMTP, parses them inside the
image, and shows summaries in the panel — pass/fail by source, hints when
tighten p= is reasonable. No external DMARC SaaS and no IMAP workflow for the
operator.
Scope
In:
- Inbound SMTP for configured report addresses only (not a general backup-MX).
- gzip + XML aggregate parsing → SQLite summaries per sending domain.
- Panel page and/or per-domain section: recent reports, third-party senders, delivery health of report ingestion.
- Reuse the
dmarc_report_emailsetting (moved off the oldadmintable intosettingsby migration0005) anddomains.dmarc_ruafor DNS templates; when enabled, suggest a SelfPost-hosted report address.
Out:
- Forensic reports (
ruf=). - Full dashboards, APIs, email alerting.
- Mailboxes for people (IMAP/POP3/webmail).
Architecture (sketch)
- Receiving MTAs → SMTP to SelfPost (hub MX).
- Postfix virtual alias or dedicated listener → panel ingest worker.
- Parse XML →
dmarc_reportstable (domain, reporter, counts, date). - Panel reads SQLite; links from domain DNS card.
May share port-25 plumbing with inbound-relay.md but must remain a separate, opt-in feature that does not forward mail upstream.
Done when
- Operator can point
rua=at an address SelfPost accepts and see parsed summaries in the panel within one reporting cycle. - With the feature off, outbound-only behaviour is unchanged.
- Documented in guide.md; migrations are backward-compatible.
Risks
- Attack surface of accepting mail (mitigate: strict recipient allow-list).
- Report volume and retention (mitigate: caps + pruning).
Implementation checklist
Target version cut: 1.7.0 (MINOR). One commit per step; code only after
roadmap status is agreed. Expand the sketch sections above before step 1
if still thin. See development.md § Plan checklists.
- Expand plan: ingest path,
dmarc_reportsschema, retention caps — Sonnet - Opt-in inbound SMTP for report addresses only (allow-list) — Opus
- Worker: gzip/XML parse → SQLite — Opus
- Panel: domain roll-up + parsed report (panel-ui mockups) — Sonnet
- Tie-in
dmarc_report_email/domains.dmarc_rua— Sonnet - Tests and guide.md — Sonnet
- Security review ingest path — Fable
go vet,go teston touched packages — Haiku