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 <noreply@anthropic.com>
This commit is contained in:
@@ -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
|
||||
|
||||
<!-- inprocess: de app draait in de IIS-werkproces (sneller, een proces). Vereist de ASP.NET Core Module
|
||||
(Hosting Bundle); aanwezig volgens de hoster. Valt het toch tegen: hostingModel="outofprocess"
|
||||
(Kestrel achter IIS; dan telt ForwardedHeaders:KnownProxies[0] = 127.0.0.1). -->
|
||||
(Kestrel achter IIS; dan zou ForwardedHeaders:KnownProxies[0] = 127.0.0.1 nodig zijn; niet de bedoeling). -->
|
||||
<aspNetCore processPath=".\SlpModularCms.Api.AndreaSlopFotografie.exe"
|
||||
arguments=""
|
||||
hostingModel="inprocess"
|
||||
@@ -162,6 +162,40 @@ Opmerkingen:
|
||||
- `processPath` hoort bij de self-contained build (`.exe` naast de web.config). Bij framework-dependent staat daar `dotnet` en `arguments=".\SlpModularCms.Api.AndreaSlopFotografie.dll"`.
|
||||
- Deploy: een `app_offline.htm` in de siteroot zet de app tijdens het uploaden stil (geen vergrendelde bestanden); verwijderen na afloop.
|
||||
|
||||
## 2a. HTTPS, www en client-IP op IIS zonder proxy
|
||||
|
||||
Productie is IIS in-process, zonder reverse proxy of CDN ervoor. Daarom staat ForwardedHeaders **uit** (`ForwardedHeaders:KnownProxies` niet zetten). Gecontroleerd in de code (2026-11-19):
|
||||
|
||||
| Onderwerp | Zonder ForwardedHeaders | Toelichting |
|
||||
|---|---|---|
|
||||
| Schema (https) | Correct | In-process IIS geeft de echte verbinding door: `Request.IsHttps` is waar op het https-adres. Daarvan hangen af: de `Secure`-vlag op de refresh-cookie (`AuthController`), de mails en de absolute adressen. |
|
||||
| Client-IP en rate limiting | Correct | `ClientPartitionKey` gebruikt `Connection.RemoteIpAddress`: het echte bezoekersadres van IIS. De middleware voor `X-Forwarded-For` wordt niet eens toegevoegd, dus een bezoeker kan zich met die header niet voordoen als een ander adres (geen spoofing, en geen gedeelde bucket zoals achter een proxy). |
|
||||
| HSTS | Correct | `Strict-Transport-Security: max-age=31536000; includeSubDomains` gaat mee op elk antwoord buiten Development; browsers nemen hem alleen over via https. Zet HSTS pas breed aan als de redirect (hieronder) werkt. |
|
||||
| Absolute adressen | Via configuratie | Website: `Website:PublicBaseUrl` (of leeg: het adres waarmee de site is gebouwd, `https://andreaslop.nl`); mails: `App:PublicBaseUrl`. Beide **zonder** `www`: het canonieke adres is `https://andreaslop.nl`. |
|
||||
| HTTP naar HTTPS | **Doet de app niet** | `UseHttpsRedirection` heeft onder in-process IIS geen https-poort (er is geen Kestrel-adres) en doet dan niets (alleen een waarschuwing in het log). Dit moet IIS of de hoster doen. |
|
||||
| www naar apex | **Doet de app niet** | Idem: IIS of de hoster. |
|
||||
| Contact-formulier | N.v.t. | De releasevoorwaarde "KnownProxies = IP van de proxy" in `appsettings.json` geldt niet: er is geen proxy; elk bezoeker heeft eigen rate-limit-emmer. |
|
||||
|
||||
**Wat de hoster al doet is nog niet bevestigd** (open punt voor Bryan, zie 5): doet het hostingpaneel al "HTTP naar HTTPS" en "www naar apex"? Zo ja, niets toevoegen. Zo niet, en als de **URL Rewrite-module** op de server staat, voeg dan dit toe aan de `web.config` (binnen `<system.webServer>`, vóór `<handlers>` mag ook erna). Zonder die module geeft een `<rewrite>`-blok een HTTP 500.19 voor de hele site; daarom staat het **niet** in het standaardsjabloon.
|
||||
|
||||
```xml
|
||||
<rewrite>
|
||||
<rules>
|
||||
<!-- www naar apex en http naar https in een keer (een enkele 301) -->
|
||||
<rule name="Canonical host and https" stopProcessing="true">
|
||||
<match url="(.*)" />
|
||||
<conditions logicalGrouping="MatchAny">
|
||||
<add input="{HTTPS}" pattern="off" />
|
||||
<add input="{HTTP_HOST}" pattern="^www\.andreaslop\.nl$" />
|
||||
</conditions>
|
||||
<action type="Redirect" url="https://andreaslop.nl/{R:1}" redirectType="Permanent" />
|
||||
</rule>
|
||||
</rules>
|
||||
</rewrite>
|
||||
```
|
||||
|
||||
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 `<geheim>`; 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).
|
||||
|
||||
Reference in New Issue
Block a user