Docs: hostconfiguratie-checklist voor het contactmodule (bron Pi-Main)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
+20
@@ -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 <unit>.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).
|
||||
Reference in New Issue
Block a user