U1 mail-foundation (frontend en documentatie): Mail-kaart bij Instellingen
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
+34
@@ -0,0 +1,34 @@
|
||||
# Infrastructure design - U1 mail-foundation
|
||||
|
||||
## Configuration keys (per environment, on the host)
|
||||
| Key | Where | Example / note |
|
||||
|---|---|---|
|
||||
| `Email__Smtp__Host` | `shared/env` | `mail.slpsoftware.nl` (the SMTP host SimpleDeckApp uses in production, per Bryan). Setting it switches mail ON. |
|
||||
| `Email__Smtp__Port` | `shared/env` | `587` |
|
||||
| `Email__Smtp__EnableSsl` | `shared/env` | `true` (STARTTLS) |
|
||||
| `Email__Smtp__Username`, `Email__Smtp__Password` | `shared/env` (mode 600) | secrets, never committed, never in messages or logs |
|
||||
| `App__PublicBaseUrl` | `shared/env` | `https://test.andreaslop.nl` (https, no path) |
|
||||
| `App__DefaultLanguage` | optional | `nl` (default) or `en` |
|
||||
| `Email__FromAddress`, `Email__FromName` | committed default or env | `no-reply@slpsoftware.nl` / site name (SimpleDeckApp's committed default) |
|
||||
| `Email__AllowedFromAddresses__0..n` | env | extra sender addresses a site may choose in its settings; empty = only `FromAddress` |
|
||||
| `Email__LogoUrl`, `Email__BrandColor` | committed (ASF) or env | `/admin/brand-logo-on-light.png`, `#5f6a58` |
|
||||
|
||||
Start-up validation refuses a broken mail configuration (when a host is set) with a message that never contains the credentials. Without a host nothing changes.
|
||||
|
||||
## Local development
|
||||
smtp4dev (already installed) on `localhost:25`: `Email__Smtp__Host=localhost`, `Email__Smtp__Port=25`, `Email__Smtp__EnableSsl=false`, no username, `App__PublicBaseUrl=http://localhost:5200` (http is accepted for loopback only).
|
||||
|
||||
## ASF test host (Operations will do it, needs Bryan's go for the real test mail)
|
||||
1. Add the keys above to `shared/env` of `andreaslopfotografie-test` (mode 600 stays), restart the unit.
|
||||
2. `Email__FromAddress` stays `no-reply@slpsoftware.nl` (the SMTP service's own domain). A sender on `@andreaslop.nl` only after the check below.
|
||||
3. One real test mail to an address of Bryan before approval.
|
||||
|
||||
## Sender-domain alignment (production checklist item)
|
||||
`From:` domain, SPF and DKIM must agree with the SMTP service that actually sends:
|
||||
- SPF of the `From:` domain must authorise the sending service (today both `slpsoftware.nl` and `andreaslop.nl` publish `v=spf1 a mx include:smtp.spf.ziggo.nl ~all`).
|
||||
- That service must DKIM-sign for the `From:` domain (a `dkim._domainkey` record exists for both domains; whether the service signs with it is not visible from outside).
|
||||
- `mail.slpsoftware.nl` will deliver `@andreaslop.nl` mail properly only if it may send/sign for that domain. DMARC is `p=none` today (monitoring only).
|
||||
- Therefore the sender list is an allowlist: add an `@andreaslop.nl` address to `Email__AllowedFromAddresses` only after this is confirmed.
|
||||
|
||||
## No other infrastructure
|
||||
No new service, port, queue or storage. One additive table (`SiteSettings`) in the existing database.
|
||||
Reference in New Issue
Block a user