From 1e908b3af09831685b8bfbcc81f220e186fc8f26 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Thu, 19 Nov 2026 00:17:16 +0100 Subject: [PATCH] Docs: productie is IIS in-process zonder proxy; ForwardedHeaders uit, HTTPS/www/client-IP gecontroleerd, canoniek adres zonder www Co-Authored-By: Claude Sonnet 5.5 --- .../asf-iis-production-config.md | 55 +++++++++++++++---- 1 file changed, 45 insertions(+), 10 deletions(-) diff --git a/aidlc-docs/features/andreaslop-site-hosting/asf-iis-production-config.md b/aidlc-docs/features/andreaslop-site-hosting/asf-iis-production-config.md index ee077ed..b48e276 100644 --- a/aidlc-docs/features/andreaslop-site-hosting/asf-iis-production-config.md +++ b/aidlc-docs/features/andreaslop-site-hosting/asf-iis-production-config.md @@ -35,7 +35,7 @@ Legenda: **V** = verplicht (de host start niet of werkt niet zonder), **A** = aa |---|---|---|---| | `Website:Mode` | V (staat al goed) | nee | `PrerenderedPages` staat in de committed `appsettings.json`; niet overschrijven. | | `Website:NoIndex` | V | nee | **`false`** op productie (committed standaard is `true` = geen zoekmachines). Pas zetten op het release-moment, na Bryans go. | -| `Website:PublicBaseUrl` | A | nee | Leeg op productie is toegestaan (de site wordt geserveerd met het adres waarmee hij is gebouwd). Wil je het expliciet: `https://www.andreaslop.nl` (zonder slash). Moet gelijk zijn aan `Website:AuthoredBaseUrl` of die vervangt het. | +| `Website:PublicBaseUrl` | A | nee | Leeg op productie is toegestaan (de site wordt geserveerd met het adres waarmee hij is gebouwd). Wil je het expliciet: `https://andreaslop.nl` (zonder slash). Moet gelijk zijn aan `Website:AuthoredBaseUrl` of die vervangt het. | | `Website:AuthoredBaseUrl` | O | nee | Het adres dat de websitebuild in pagina's, sitemap en robots schrijft; staat in de committed instellingen. | | `Website:LogLevel` | O | nee | Standaard `Warning` (productie). `Information` toont ook 301's en 404's: alleen tijdelijk. | | `Texts:DefaultLanguage` | O | nee | `nl` (standaard). | @@ -52,7 +52,7 @@ Mail staat uit zolang `Email:Smtp:Host` leeg is; dan kopieert de beheerder de li | `Email:Smtp:Password` | A | **ja** | alleen in `appsettings.Production.json` | | `Email:FromAddress` / `Email:FromName` | A | nee | `no-reply@andreaslop.nl` / `Andrea Slop Fotografie` (SPF/DKIM moeten voor dit adres kloppen). | | `Email:AllowedFromAddresses[0]` | O | nee | Extra afzenderadressen die de eigenaar in de admin mag kiezen. | -| `App:PublicBaseUrl` | V als mail aan staat | nee | `https://www.andreaslop.nl` (https, zonder pad). Gebruikt in de links van de mails. | +| `App:PublicBaseUrl` | V als mail aan staat | nee | `https://andreaslop.nl` (https, zonder pad). Gebruikt in de links van de mails. | | `App:DefaultLanguage` | O | nee | `nl` | ### 1d. Eerste beheerder en toegang @@ -62,7 +62,7 @@ Mail staat uit zolang `Email:Smtp:Host` leeg is; dan kopieert de beheerder de li | `Identity:Setup:Token` | A | **ja** | Minstens 32 willekeurige tekens. Beschermt het aanmaken van de eerste beheerder op een lege database; weghalen zodra die bestaat. Leeg = de setuppagina is niet beveiligd (op internet is dat een risico tot de eerste beheerder er is). | | `Identity:Invitation:ExpiryHours` | O | nee | `24` (standaard). | | `RateLimiting:Login:PermitLimit` / `...WindowSeconds` | O | nee | `5` per `60` s per clientadres (standaard). | -| `ForwardedHeaders:KnownProxies[0]` | O | nee | Alleen als er een reverse proxy/CDN van de hoster voor IIS staat en het echte bezoekersadres nodig is (rate limiting werkt per adres). Vraag de hoster; leeg = `X-Forwarded-*` wordt genegeerd. Een wildcard (`0.0.0.0`, `::`) laat de host niet starten. | +| `ForwardedHeaders:KnownProxies[0]` | **niet zetten** | nee | Op productie **staat ForwardedHeaders uit**: de host draait in-process op IIS, zonder reverse proxy of CDN ervoor (Bryan, 2026-11-19). IIS levert schema (https) en client-IP zelf; `X-Forwarded-*` van buiten wordt genegeerd (geen spoofing). Zie 2a. Een wildcard (`0.0.0.0`, `::`) laat de host niet starten. | ### 1e. Foto's (Hero en Media) @@ -123,7 +123,7 @@ Controle na de eerste start: het log toont `Image library Magick.NET self-test p + (Kestrel achter IIS; dan zou ForwardedHeaders:KnownProxies[0] = 127.0.0.1 nodig zijn; niet de bedoeling). --> `, vóór `` mag ook erna). Zonder die module geeft een ``-blok een HTTP 500.19 voor de hele site; daarom staat het **niet** in het standaardsjabloon. + +```xml + + + + + + + + + + + + + +``` + +Een gebruiker die de oude WordPress-adressen via de redirectmap (`redirects.json`) afhandelt, krijgt de redirect pas ná deze regel: eerst naar het canonieke adres, dan naar de nieuwe plek. Test na het toevoegen: `http://andreaslop.nl/`, `https://www.andreaslop.nl/` en `http://www.andreaslop.nl/` geven elk één 301 naar `https://andreaslop.nl/`; `/health` blijft 200 (de health-check van de deploy gebruikt `https://andreaslop.nl/health`). + ## 3. De productie-appsettings (`appsettings.Production.json`) Eén bestand, **server-only**, naast het programma (naast de exe en de `appsettings.json` uit de release); rechten alleen voor de identiteit van de application pool en de beheerder. Het zit niet in het artefact, dus de FTPS-deploy overschrijft het niet; het staat niet in de repo en niet in `wwwroot` (wordt nooit geserveerd). Bryan mag het bestand zelf op de server zetten (bevestigd door de hoster). @@ -175,10 +209,10 @@ Eén bestand, **server-only**, naast het programma (naast de exe en de `appsetti | `JwtSettings:Secret` | eigen testsleutel (64+ tekens) | **nieuwe, andere** sleutel; niet de testsleutel hergebruiken | | `Identity:Setup:Token` | testtoken | nieuw token; na de eerste beheerder uit het bestand halen | | `Observability:SentryDsn` / `Environment` | test-DSN / `test` | productie-DSN (de bestaande ASF-website-DSN, tenzij Bryan een eigen project wil) / `production` | -| `ForwardedHeaders:KnownProxies[0]` | `192.168.1.102` (nginx op de Pi) | **niet overnemen**; bij inprocess leeg laten, tenzij de hoster een proxy/CDN voor IIS zet (vraag) | +| `ForwardedHeaders:KnownProxies[0]` | `192.168.1.102` (nginx op de Pi) | **niet zetten**: productie is IIS in-process zonder proxy; ForwardedHeaders staat uit (zie 2a) | | `Website:NoIndex` | `true` (standaard) | `false`, pas op het release-moment na Bryans go | -| `Website:PublicBaseUrl` | het testadres (waarschijnlijk) | leeg of `https://www.andreaslop.nl` (zonder slash) | -| `App:PublicBaseUrl` | het testadres (waarschijnlijk) | `https://www.andreaslop.nl` | +| `Website:PublicBaseUrl` | het testadres (waarschijnlijk) | leeg of `https://andreaslop.nl` (zonder slash) | +| `App:PublicBaseUrl` | het testadres (waarschijnlijk) | `https://andreaslop.nl` | | `Website:LogLevel` | `Information` | `Warning` (standaard); alleen tijdelijk `Information` | | `Email:Smtp:*` | testinstelling of leeg | SMTP-gegevens van de hoster of een andere aanbieder (zie 1c) | | `Media:Directory` | map op de Pi | `uploads` naast `wwwroot` (zie 1e) | @@ -200,10 +234,10 @@ Waarden die alleen Bryan kent staan als ``; de rest is voorgesteld. }, "Website": { "NoIndex": true, - "PublicBaseUrl": "https://www.andreaslop.nl" + "PublicBaseUrl": "https://andreaslop.nl" }, "App": { - "PublicBaseUrl": "https://www.andreaslop.nl" + "PublicBaseUrl": "https://andreaslop.nl" }, "Email": { "Smtp": { @@ -259,7 +293,8 @@ Nog open: 1. ~~Database-TLS~~ afgehandeld: de server biedt TLS, `SslMode=Required` staat in het voorbeeld. Restrisico: geen certificaatcontrole (`VerifyCA`/`VerifyFull` later, met het CA-certificaat van de hoster). 2. **Toegangsbeperking tot het IP van de webserver** is niet mogelijk; blijft een restrisico. Een sterk, uniek wachtwoord is verplicht (zie 4a). 3. **Fysiek pad van `uploads`** uit het hostingpaneel invullen in `Media:Directory`, en schrijfrechten voor de application pool-identiteit zetten (Bryan). Daarna de test uit 1e. -4. Staat er een reverse proxy/CDN van de hoster voor IIS (voor `ForwardedHeaders:KnownProxies[0]`)? Zo niet: leeg laten. +4. ~~Reverse proxy voor IIS~~ afgehandeld: er is geen proxy; ForwardedHeaders staat uit (zie 2a). +8. Doet de hoster al HTTP naar HTTPS en www naar apex? Zo niet: staat de URL Rewrite-module op de server? Zie 2a voor de regel. 5. Welke MariaDB-versie, en welke rechten (CREATE/ALTER/INDEX/DROP/REFERENCES) heeft de gebruiker `57409_andreaslopfotografie`; is de naam hoofdlettergevoelig? (Database en gebruiker: `57409_andreaslopfotografie`, letterlijk uit het paneel.) 6. Grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek). 7. SMTP-aanbieder en afzenderadres voor mail (zie 1c).