From a13ffa6bc7f64bc417add1afa9da3ab0d301d1dd Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Tue, 10 Nov 2026 23:31:21 +0100 Subject: [PATCH] Docs: hostconfiguratie-checklist voor het contactmodule (bron Pi-Main) Co-Authored-By: Claude Sonnet 5.5 --- .../operations/host-config-checklist.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 aidlc-docs/features/redesign-modern-timetravel/construction/contact-form/operations/host-config-checklist.md diff --git a/aidlc-docs/features/redesign-modern-timetravel/construction/contact-form/operations/host-config-checklist.md b/aidlc-docs/features/redesign-modern-timetravel/construction/contact-form/operations/host-config-checklist.md new file mode 100644 index 0000000..cdf02d5 --- /dev/null +++ b/aidlc-docs/features/redesign-modern-timetravel/construction/contact-form/operations/host-config-checklist.md @@ -0,0 +1,20 @@ +# Host configuration for the contact module (source: Pi-Main - Server, 2026-11-11) + +Each .NET app is a systemd user unit of user `gitea-workflow` on Pi-Main, with ONE EnvironmentFile (secrets and non-secrets together, mode 600 gitea-workflow:www-data): + +| Host | Unit | EnvironmentFile | +|---|---|---| +| SLP test :5100 | slpsoftware-test.service | /home/gitea-workflow/apps/slpsoftware/test/shared/env | +| SLP production :5101 | slpsoftware-production.service | /home/gitea-workflow/apps/slpsoftware/production/shared/env | +| ASF test :5200 | andreaslopfotografie-test.service | /home/gitea-workflow/apps/andreaslopfotografie/test/shared/env | +| ASF production | IIS (not on this Pi) | n/a | + +Edit rules: one `NAME=value` per line, double underscore for levels, no `export`, no spaces around `=`, values with spaces in quotes, names containing a dot are silently ignored. Restart after every change (env is read at start): `sudo runuser -u gitea-workflow -- env XDG_RUNTIME_DIR=/run/user/1003 systemctl --user restart .service`. A release deploy leaves the env alone. + +Settings for the contact module: `Contact__Enabled` (default off, may be absent), `Contact__RecipientEmail` (set only when enabling), `Contact__Captcha__Enabled|Provider|Region|SiteKey|Secret` (captcha stays off at go-live until a paid Friendly Captcha plan), `SecurityHeaders__AllowedSiteFrameOrigins__0..2` (ASF only: global, global0, global1 .frcapi.com), `ForwardedHeaders__KnownProxies__0`, `Email__AllowedFromAddresses`. + +Facts and risks: +- The app sees the proxy at 192.168.1.102 (Pi-Entry); TLS stops there. `ForwardedHeaders__KnownProxies__0` is already set for ASF test; for the SLP hosts it must be checked (name only, not the value). +- Per-visitor rate limiting works only if Pi-Entry passes `X-Forwarded-For`/`-Proto` (not verified) and KnownProxies contains 192.168.1.102. +- nginx on Pi-Main is not in the path; security headers come from the app. Whether Pi-Entry adds its own CSP/headers is unknown. +- Announce any REQUIRED new variable in advance: a missing required variable caused a crashloop on ASF on 2026-11-08 (App__PublicBaseUrl). The contact variables are optional (module off by default).