From 73450b53f0d7ced25fbdb01f7dfdffeea34797bd Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Wed, 18 Nov 2026 20:02:08 +0100 Subject: [PATCH 1/7] Docs: ASF op IIS, configuratiesleutels, web.config-sjabloon en geheimenvoorstel (voorstel, niet uitgevoerd) Co-Authored-By: Claude Sonnet 5.5 --- .../asf-iis-production-config.md | 198 ++++++++++++++++++ 1 file changed, 198 insertions(+) create mode 100644 aidlc-docs/features/andreaslop-site-hosting/asf-iis-production-config.md 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 new file mode 100644 index 0000000..bd0e9bc --- /dev/null +++ b/aidlc-docs/features/andreaslop-site-hosting/asf-iis-production-config.md @@ -0,0 +1,198 @@ +# ASF op IIS (MijnHostingPartner): configuratiesleutels, web.config en geheimen + +Voorstel (2026-11-18), nog niet uitgevoerd. Er is niets op productie gezet; alles hier wacht op Bryans go. Geschreven voor Bryan, die de omgevingsvariabelen op de hoster instelt. Bronnen: `src/SlpModularCms.Api.AndreaSlopFotografie/appsettings.json`, de Options-klassen in Core en de modules, `docs/release-checklist-productie.md`, `README.md` (E-mail, Rate limiting), `docs/hero-module.md`. + +Samenvatting in vier regels: +1. De host leest configuratie in deze volgorde (latere wint): `appsettings.json` (in de release, bevat alleen veilige standaardwaarden) < `appsettings.Production.json` (alleen op de server) < omgevingsvariabelen (web.config) < command line. +2. **Geheimen** (verbindingsstring, JWT-sleutel, SMTP-wachtwoord, Setup-token) in een **alleen-server `appsettings.Production.json`**; **niet-geheime** waarden in het `environmentVariables`-blok van de web.config of ook in dat bestand. Zet een sleutel niet op twee plekken: de omgevingsvariabele wint stilzwijgend. +3. De deploy (FTP) mag `appsettings.Production.json` en de mediamap nooit overschrijven of verwijderen; die zitten niet in het artefact. +4. Een sleutel in JSON schrijf je geneste (`"ConnectionStrings": { "DefaultConnection": ... }`); als omgevingsvariabele met dubbele underscore (`ConnectionStrings__DefaultConnection`). Lijstwaarden als `__0`, `__1`, ... + +## 1. Sleutels die de host voor ASF-productie nodig heeft + +Legenda: **V** = verplicht (de host start niet of werkt niet zonder), **A** = aanbevolen, **O** = optioneel (standaard is goed). **G** = geheim (alleen in `appsettings.Production.json`, nooit in repo of web.config). Voorbeeldwaarden zijn verzonnen. + +### 1a. Omgeving en basis + +| Sleutel (als omgevingsvariabele) | | G | Voorbeeld / uitleg | +|---|---|---|---| +| `ASPNETCORE_ENVIRONMENT` | V | nee | `Production` (laadt `appsettings.Production.json`; bepaalt ook de Sentry-omgeving als `Observability__Environment` leeg is). | +| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=3306;Database=AndreaSlopFotografie;Uid=;Pwd=` (MariaDB/MySQL van de hoster; een eigen database, niet die van een andere site). De migraties draaien bij de eerste start (zie 4). | +| `JwtSettings__Secret` | V | **ja** | Minstens 32 willekeurige tekens, uniek voor productie (niet de ontwikkelsleutel). Wisselen logt alle ingelogde gebruikers uit. | +| `JwtSettings__Issuer` / `JwtSettings__Audience` | O | nee | Staan in de committed `appsettings.json` (`SlpModularCms` / `SlpModularCmsPortal`); alleen zetten om af te wijken. | +| `JwtSettings__CookieSameSite` | O | nee | Standaard `Strict` (goed: de admin staat op dezelfde site als de API). Niet op `None` zetten. | +| `AllowedHosts` | A | nee | `andreaslop.nl;www.andreaslop.nl` (committed waarde is `*`). | +| `Cors__AllowedOrigins__0` | O | nee | Leeg laten: de admin draait op dezelfde origin (`/admin`). Alleen invullen als de admin elders gehost wordt. | + +### 1b. De website (voorgerenderd) en zoekmachines + +| Sleutel | | G | Voorbeeld / uitleg | +|---|---|---|---| +| `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__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). | + +### 1c. Mail (uitnodigingen, wachtwoord opnieuw instellen) + +Mail staat uit zolang `Email__Smtp__Host` leeg is; dan kopieert de beheerder de link. De host weigert te starten bij een onjuiste, half ingevulde mailconfiguratie (met een melding zonder geheimen). + +| Sleutel | | G | Voorbeeld / uitleg | +|---|---|---|---| +| `Email__Smtp__Host` | A (nodig voor mail) | nee | `mail..nl` (zet mail aan). | +| `Email__Smtp__Port` / `Email__Smtp__EnableSsl` | A | nee | `587` / `true` (STARTTLS). | +| `Email__Smtp__Username` | A | **ja** | `no-reply@andreaslop.nl` | +| `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__DefaultLanguage` | O | nee | `nl` | + +### 1d. Eerste beheerder en toegang + +| Sleutel | | G | Voorbeeld / uitleg | +|---|---|---|---| +| `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. | + +### 1e. Foto's (Hero en Media) + +| Sleutel | | G | Voorbeeld / uitleg | +|---|---|---|---| +| `Media__Directory` | V voor uploads | nee | Een map **buiten de release en buiten de webroot**, bijvoorbeeld `D:\data\andreaslop\media`. Beschrijfbaar voor de identiteit van de application pool. Zonder deze instelling (of bij een niet-beschrijfbare map) staan uploads uit; bestaande foto's blijven werken. De map moet in de back-up zitten. | +| `Media__MaxUploadBytes` / `Media__MaxTotalBytes` | O | nee | 10 MB per foto / 2 GB totaal (standaard). Pas aan als het hostingpakket kleiner is dan 2 GB. | +| `Media__RetentionDays` / `Media__TrashDays` | O | nee | 7 / 7 (standaard). | +| `Media__AutoCleanupUnattached` | O | nee | `false` (standaard): ongebruikte uploads blijven tot iemand ze in de mediabibliotheek verwijdert. | +| `Media__MaxParallelJobs` | A | nee | `2` (standaard); op een kleine gedeelde hosting `1`. | +| `Hero__TextOnlyRegion`, `Hero__TitlePrefix` | O | nee | Voor ASF leeg laten (ASF heeft foto's in de hero). | +| `Hero__MaxPublishedSlides` | O | nee | `50` (standaard). | + +Controle na de eerste start: het log toont `Image library Magick.NET self-test passed`. Zo niet, dan zijn uploads uitgezet (de native Magick-bibliotheek moet bij de self-contained win-x64 build zitten). + +### 1f. Contactformulier en captcha + +| Sleutel | | G | Voorbeeld / uitleg | +|---|---|---|---| +| `Contact__Enabled` | O | nee | **Niet zetten** (standaard `false`) tot Bryan het formulier live wil. Dan nog `Contact__RecipientEmail` en een werkende mailconfiguratie. | +| `Contact__RecipientEmail` | alleen bij Enabled | nee | Adres dat de meldingen krijgt (de admin kan een eigen adres instellen). | +| `Contact__Captcha__Enabled` | O | nee | `false` (standaard); er is geen captcha-aanbieder gekozen. Aanzetten vereist `SiteKey`, `Secret` (**G**), `Region` en laat de host bij foute waarden niet starten. | +| `Contact__RetentionMonths` / `Contact__SpamRetentionDays` | O | nee | 12 / 30 (standaard); moeten kloppen met de privacyverklaring. | + +### 1g. Beveiligingsheaders, Sentry en Umami + +| Sleutel | | G | Voorbeeld / uitleg | +|---|---|---|---| +| `SecurityHeaders__Enabled` | O | nee | `true` (standaard). De committed instellingen geven de website het `StrictSite`-beleid en laten alleen Umami (`https://analytics.slpsoftware.nl`) en de Sentry-ingest toe. Niet verruimen zonder reden. | +| `SecurityHeaders__AllowedSiteFrameOrigins__0` | O | nee | Alleen als de site een iframe van een derde partij toont (bijv. captcha). Leeg = geen `frame-src`. | +| `Observability__SentryDsn` | A | nee (halfopenbaar) | `https://@o....ingest.de.sentry.io/`. Leeg = geen Sentry, console-logging blijft. Gebruik een eigen Sentry-project voor ASF-productie. | +| `Observability__Environment` | A | nee | `production` (valt anders terug op `ASPNETCORE_ENVIRONMENT`). | +| `Observability__TracesSampleRate` | O | nee | `0.1` (standaard). | +| Umami | n.v.t. | nee | De host en de admin gebruiken geen Umami; alleen de website zelf laadt het script (de CSP staat het toe). Niets in de host-configuratie. | + +### 1h. Wat je niet hoeft te zetten + +`Availability__*`, `MasterPolling__*`: ASF is geen master/slave-opstelling (alleen Identity, Availability, Offerings, Hero, Media, Contact). `Logging__LogLevel__*`: de committed waarden zijn goed (EF-SQL op `Warning`, zodat er geen e-mailadressen in het log komen); gebruik voor de websitelog `Website__LogLevel`, niet `Logging__LogLevel__SlpModularCms.Website` (een punt in een variabelenaam werkt niet in een omgevingsvariabele). Data Protection-sleutels staan in de database (vast, geen configuratie). + +## 2. Sjabloon voor de gepubliceerde web.config + +`dotnet publish` (Sdk.Web) maakt zelf een `web.config` met de `aspNetCore`-handler; in de ASF-pijplijn voegen we de standaardinstellingen van de hoster (defaultDocument, headers) daarin samen. De referentiefile van de hoster (alleen defaultDocument, `X-Powered-By`, `httpErrors`) bevat nog geen handler. Voorstel: + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +Opmerkingen: +- `defaultDocument` van de hoster laat ik weg: de app serveert `/` zelf (voorgerenderde pagina's uit `wwwroot/web`); een `index.html` in de siteroot van IIS zou de handler omzeilen. Staat daar niets, dan is behouden ook onschadelijk. +- De hoster zet `X-Powered-By: ASP.NET`; ik haal de header weg (lekt geen informatie nodig). Wil je de hosterstandaard houden, laat de `remove`/`add` zoals in hun bestand. +- **stdout-log alleen voor de eerste start**: zet `stdoutLogEnabled="false"` na de eerste succesvolle start; de map `logs` moet bestaan en beschrijfbaar zijn. Het log bevat de opstartregels (migraties, Magick-self-test, guard-melding), geen geheimen. +- `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. + +## 3. Geheimen: waar en hoe + +Voorkeur: **server-only `appsettings.Production.json`**, naast de exe, rechten alleen voor de identiteit van de application pool en de beheerder. Voordelen: de FTP-deploy overschrijft de web.config bij elke release (en publiceert alleen wat in het artefact zit), maar dit bestand zit niet in het artefact en blijft staan; het staat niet in de repo en niet in `wwwroot` (wordt nooit geserveerd); lokale wijzigingen zijn zonder herdeploy mogelijk (de host herlaadt het bestand, of recycle de pool). + +```json +{ + "ConnectionStrings": { + "DefaultConnection": "Server=;Port=3306;Database=AndreaSlopFotografie;Uid=;Pwd=" + }, + "JwtSettings": { + "Secret": "" + }, + "Identity": { + "Setup": { "Token": "" } + }, + "Email": { + "Smtp": { "Host": "mail..nl", "Username": "no-reply@andreaslop.nl", "Password": "" } + }, + "Observability": { + "SentryDsn": "https://@o.ingest.de.sentry.io/" + } +} +``` + +Regels: +- Een sleutel staat op **één** plek. Staat hij ook in het `environmentVariables`-blok, dan wint de omgevingsvariabele en lijkt het bestand genegeerd. +- Het bestand wordt **nooit** door de pijplijn gemaakt of vervangen. De pijplijn mag er niet op mirroren (FTP-sync die "extra" bestanden op de server verwijdert, zoals `lftp mirror --delete`, moet `appsettings.Production.json`, `logs/` en de mediamap uitsluiten). Bryan zet het bestand eenmalig met de hand. +- Alternatief als de hoster geen eigen bestanden naast de exe toestaat: omgevingsvariabelen in het IIS-beheer van de site (`Configuration Editor > system.webServer/aspNetCore/environmentVariables` of via het hostingpaneel); die overleven een deploy omdat ze niet in de web.config van het artefact staan. Niet in de gepubliceerde web.config. +- Geen geheimen in de repo, in logs of in dit soort documenten. Draai de sleutels (`JwtSettings__Secret`, SMTP-wachtwoord, databasewachtwoord) bij vermoeden van uitlekken; wijzigen van de JWT-sleutel logt iedereen uit. + +## 4. Volgorde bij de eerste start (database) + +Een lege productiedatabase: de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). + +## 5. Open punten voor Bryan + +1. Staat de ASP.NET Core Module (Hosting Bundle) op de server van MijnHostingPartner, en welke `hostingModel` ondersteunen ze? (Bepaalt `inprocess` of `outofprocess`.) +2. Mag er een eigen bestand (`appsettings.Production.json`) naast de exe, buiten de FTP-sync? Zo niet: omgevingsvariabelen via het hostingpaneel. +3. Pad en rechten van `Media__Directory` en grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek). +4. Staat er een reverse proxy/CDN van de hoster voor IIS (voor `ForwardedHeaders__KnownProxies__0`)? +5. Welke database (MariaDB/MySQL-versie) en welke gebruikersrechten (CREATE/ALTER voor de migraties)? From 293f1b50c333e34de9f9f205d2e83c481a984b2d Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Wed, 18 Nov 2026 21:22:28 +0100 Subject: [PATCH 2/7] Docs: ASF-productiedatabase heet AndreaSlopFotografie (gebruiker idem), WordPress-database ongebruikt Co-Authored-By: Claude Sonnet 5.5 --- .../andreaslop-site-hosting/asf-iis-production-config.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 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 bd0e9bc..3a12dab 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 @@ -17,7 +17,7 @@ Legenda: **V** = verplicht (de host start niet of werkt niet zonder), **A** = aa | Sleutel (als omgevingsvariabele) | | G | Voorbeeld / uitleg | |---|---|---|---| | `ASPNETCORE_ENVIRONMENT` | V | nee | `Production` (laadt `appsettings.Production.json`; bepaalt ook de Sentry-omgeving als `Observability__Environment` leeg is). | -| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=3306;Database=AndreaSlopFotografie;Uid=;Pwd=` (MariaDB/MySQL van de hoster; een eigen database, niet die van een andere site). De migraties draaien bij de eerste start (zie 4). | +| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=3306;Database=AndreaSlopFotografie;Uid=AndreaSlopFotografie;Pwd=` (MariaDB/MySQL van de hoster). Productie: database en gebruiker `AndreaSlopFotografie` (zonder achtervoegsel, zoals bij SLS); test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het hostingpaneel kan een voorvoegsel (bijvoorbeeld `_AndreaSlopFotografie`) of een lengtelimiet opleggen voor database- en gebruikersnamen: gebruik dan de naam die het paneel toont, in `Database=` en `Uid=`. De migraties draaien bij de eerste start (zie 4). | | `JwtSettings__Secret` | V | **ja** | Minstens 32 willekeurige tekens, uniek voor productie (niet de ontwikkelsleutel). Wisselen logt alle ingelogde gebruikers uit. | | `JwtSettings__Issuer` / `JwtSettings__Audience` | O | nee | Staan in de committed `appsettings.json` (`SlpModularCms` / `SlpModularCmsPortal`); alleen zetten om af te wijken. | | `JwtSettings__CookieSameSite` | O | nee | Standaard `Strict` (goed: de admin staat op dezelfde site als de API). Niet op `None` zetten. | @@ -162,7 +162,7 @@ Voorkeur: **server-only `appsettings.Production.json`**, naast de exe, rechten a ```json { "ConnectionStrings": { - "DefaultConnection": "Server=;Port=3306;Database=AndreaSlopFotografie;Uid=;Pwd=" + "DefaultConnection": "Server=;Port=3306;Database=AndreaSlopFotografie;Uid=AndreaSlopFotografie;Pwd=" }, "JwtSettings": { "Secret": "" @@ -187,7 +187,7 @@ Regels: ## 4. Volgorde bij de eerste start (database) -Een lege productiedatabase: de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). +Een lege productiedatabase `AndreaSlopFotografie` (aanmaken in het hostingpaneel, met gebruiker `AndreaSlopFotografie` en CREATE/ALTER/INDEX/DROP-rechten voor de migraties; de oude WordPress-database `andreaslop` blijft ongebruikt en wordt niet gekoppeld): de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). ## 5. Open punten voor Bryan @@ -195,4 +195,4 @@ Een lege productiedatabase: de host maakt bij de eerste start alle tabellen (mig 2. Mag er een eigen bestand (`appsettings.Production.json`) naast de exe, buiten de FTP-sync? Zo niet: omgevingsvariabelen via het hostingpaneel. 3. Pad en rechten van `Media__Directory` en grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek). 4. Staat er een reverse proxy/CDN van de hoster voor IIS (voor `ForwardedHeaders__KnownProxies__0`)? -5. Welke database (MariaDB/MySQL-versie) en welke gebruikersrechten (CREATE/ALTER voor de migraties)? +5. Welke MariaDB/MySQL-versie, welke gebruikersrechten (CREATE/ALTER voor de migraties) en legt het hostingpaneel een voorvoegsel of lengtelimiet op voor de namen `AndreaSlopFotografie`? From 46eedba199806fa24df240ea021bfa210f6d402f Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Wed, 18 Nov 2026 21:23:01 +0100 Subject: [PATCH 3/7] Docs: ASF-productiedatabase heet slopAndreaSlopFotografie (hostervoorvoegsel slop) Co-Authored-By: Claude Sonnet 5.5 --- .../andreaslop-site-hosting/asf-iis-production-config.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 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 3a12dab..4738fb2 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 @@ -17,7 +17,7 @@ Legenda: **V** = verplicht (de host start niet of werkt niet zonder), **A** = aa | Sleutel (als omgevingsvariabele) | | G | Voorbeeld / uitleg | |---|---|---|---| | `ASPNETCORE_ENVIRONMENT` | V | nee | `Production` (laadt `appsettings.Production.json`; bepaalt ook de Sentry-omgeving als `Observability__Environment` leeg is). | -| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=3306;Database=AndreaSlopFotografie;Uid=AndreaSlopFotografie;Pwd=` (MariaDB/MySQL van de hoster). Productie: database en gebruiker `AndreaSlopFotografie` (zonder achtervoegsel, zoals bij SLS); test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het hostingpaneel kan een voorvoegsel (bijvoorbeeld `_AndreaSlopFotografie`) of een lengtelimiet opleggen voor database- en gebruikersnamen: gebruik dan de naam die het paneel toont, in `Database=` en `Uid=`. De migraties draaien bij de eerste start (zie 4). | +| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=3306;Database=slopAndreaSlopFotografie;Uid=;Pwd=` (MariaDB/MySQL van de hoster). Productie: de database heet `AndreaSlopFotografie` (zonder achtervoegsel, zoals bij SLS), maar de hoster zet het voorvoegsel `slop` ervoor, dus de volledige naam in `Database=` is `slopAndreaSlopFotografie`. De gebruikersnaam kan ook een voorvoegsel krijgen (Bryan controleert de exacte naam in het hostingpaneel; in het voorbeeld staat ``). Test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het voorvoegsel `slop` is dat van de hoster; het paneel kan ook een lengtelimiet opleggen: gebruik altijd de volledige naam die het paneel toont, in `Database=` en `Uid=`. De migraties draaien bij de eerste start (zie 4). | | `JwtSettings__Secret` | V | **ja** | Minstens 32 willekeurige tekens, uniek voor productie (niet de ontwikkelsleutel). Wisselen logt alle ingelogde gebruikers uit. | | `JwtSettings__Issuer` / `JwtSettings__Audience` | O | nee | Staan in de committed `appsettings.json` (`SlpModularCms` / `SlpModularCmsPortal`); alleen zetten om af te wijken. | | `JwtSettings__CookieSameSite` | O | nee | Standaard `Strict` (goed: de admin staat op dezelfde site als de API). Niet op `None` zetten. | @@ -162,7 +162,7 @@ Voorkeur: **server-only `appsettings.Production.json`**, naast de exe, rechten a ```json { "ConnectionStrings": { - "DefaultConnection": "Server=;Port=3306;Database=AndreaSlopFotografie;Uid=AndreaSlopFotografie;Pwd=" + "DefaultConnection": "Server=;Port=3306;Database=slopAndreaSlopFotografie;Uid=;Pwd=" }, "JwtSettings": { "Secret": "" @@ -187,7 +187,7 @@ Regels: ## 4. Volgorde bij de eerste start (database) -Een lege productiedatabase `AndreaSlopFotografie` (aanmaken in het hostingpaneel, met gebruiker `AndreaSlopFotografie` en CREATE/ALTER/INDEX/DROP-rechten voor de migraties; de oude WordPress-database `andreaslop` blijft ongebruikt en wordt niet gekoppeld): de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). +Een lege productiedatabase (aanmaken in het hostingpaneel als `AndreaSlopFotografie`; de volledige naam wordt `slopAndreaSlopFotografie` door het hostervoorvoegsel; de gebruiker krijgt CREATE/ALTER/INDEX/DROP-rechten voor de migraties; de oude WordPress-database `andreaslop` blijft ongebruikt en wordt niet gekoppeld): de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). ## 5. Open punten voor Bryan @@ -195,4 +195,4 @@ Een lege productiedatabase `AndreaSlopFotografie` (aanmaken in het hostingpaneel 2. Mag er een eigen bestand (`appsettings.Production.json`) naast de exe, buiten de FTP-sync? Zo niet: omgevingsvariabelen via het hostingpaneel. 3. Pad en rechten van `Media__Directory` en grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek). 4. Staat er een reverse proxy/CDN van de hoster voor IIS (voor `ForwardedHeaders__KnownProxies__0`)? -5. Welke MariaDB/MySQL-versie, welke gebruikersrechten (CREATE/ALTER voor de migraties) en legt het hostingpaneel een voorvoegsel of lengtelimiet op voor de namen `AndreaSlopFotografie`? +5. Welke MariaDB/MySQL-versie, welke gebruikersrechten (CREATE/ALTER voor de migraties) en hoe heet de gebruiker exact (voorvoegsel?) en is er een lengtelimiet? (De database wordt `slopAndreaSlopFotografie`.) From 4ba5a0ec0e6b6beaf95749030c0d30ade364b398 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Wed, 18 Nov 2026 21:45:43 +0100 Subject: [PATCH 4/7] Docs: ASF-productiedatabase en gebruiker heten 57409_andreaslopfotografie (letterlijk uit het paneel) Co-Authored-By: Claude Sonnet 5.5 --- .../andreaslop-site-hosting/asf-iis-production-config.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 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 4738fb2..34150b4 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 @@ -17,7 +17,7 @@ Legenda: **V** = verplicht (de host start niet of werkt niet zonder), **A** = aa | Sleutel (als omgevingsvariabele) | | G | Voorbeeld / uitleg | |---|---|---|---| | `ASPNETCORE_ENVIRONMENT` | V | nee | `Production` (laadt `appsettings.Production.json`; bepaalt ook de Sentry-omgeving als `Observability__Environment` leeg is). | -| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=3306;Database=slopAndreaSlopFotografie;Uid=;Pwd=` (MariaDB/MySQL van de hoster). Productie: de database heet `AndreaSlopFotografie` (zonder achtervoegsel, zoals bij SLS), maar de hoster zet het voorvoegsel `slop` ervoor, dus de volledige naam in `Database=` is `slopAndreaSlopFotografie`. De gebruikersnaam kan ook een voorvoegsel krijgen (Bryan controleert de exacte naam in het hostingpaneel; in het voorbeeld staat ``). Test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het voorvoegsel `slop` is dat van de hoster; het paneel kan ook een lengtelimiet opleggen: gebruik altijd de volledige naam die het paneel toont, in `Database=` en `Uid=`. De migraties draaien bij de eerste start (zie 4). | +| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=3306;Database=57409_andreaslopfotografie;Uid=57409_andreaslopfotografie;Pwd=` (MariaDB/MySQL van de hoster). Productie: het hostingpaneel heeft database en gebruiker aangemaakt als `57409_andreaslopfotografie` (voorvoegsel `57409_` van de hoster, alles kleine letters); neem die naam **letterlijk** over in `Database=` en `Uid=` (let op hoofdlettergevoeligheid: op de hoster kan de naam hoofdlettergevoelig zijn). Test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het paneel kan ook een lengtelimiet opleggen. De migraties draaien bij de eerste start (zie 4). | | `JwtSettings__Secret` | V | **ja** | Minstens 32 willekeurige tekens, uniek voor productie (niet de ontwikkelsleutel). Wisselen logt alle ingelogde gebruikers uit. | | `JwtSettings__Issuer` / `JwtSettings__Audience` | O | nee | Staan in de committed `appsettings.json` (`SlpModularCms` / `SlpModularCmsPortal`); alleen zetten om af te wijken. | | `JwtSettings__CookieSameSite` | O | nee | Standaard `Strict` (goed: de admin staat op dezelfde site als de API). Niet op `None` zetten. | @@ -162,7 +162,7 @@ Voorkeur: **server-only `appsettings.Production.json`**, naast de exe, rechten a ```json { "ConnectionStrings": { - "DefaultConnection": "Server=;Port=3306;Database=slopAndreaSlopFotografie;Uid=;Pwd=" + "DefaultConnection": "Server=;Port=3306;Database=57409_andreaslopfotografie;Uid=57409_andreaslopfotografie;Pwd=" }, "JwtSettings": { "Secret": "" @@ -187,7 +187,7 @@ Regels: ## 4. Volgorde bij de eerste start (database) -Een lege productiedatabase (aanmaken in het hostingpaneel als `AndreaSlopFotografie`; de volledige naam wordt `slopAndreaSlopFotografie` door het hostervoorvoegsel; de gebruiker krijgt CREATE/ALTER/INDEX/DROP-rechten voor de migraties; de oude WordPress-database `andreaslop` blijft ongebruikt en wordt niet gekoppeld): de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). +Een lege productiedatabase (door het hostingpaneel aangemaakt als `57409_andreaslopfotografie`, met gebruiker `57409_andreaslopfotografie`; de namen letterlijk overnemen, alles kleine letters; de gebruiker heeft CREATE/ALTER/INDEX/DROP-rechten voor de migraties; de oude WordPress-database `andreaslop` blijft ongebruikt en wordt niet gekoppeld): de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). ## 5. Open punten voor Bryan @@ -195,4 +195,4 @@ Een lege productiedatabase (aanmaken in het hostingpaneel als `AndreaSlopFotogra 2. Mag er een eigen bestand (`appsettings.Production.json`) naast de exe, buiten de FTP-sync? Zo niet: omgevingsvariabelen via het hostingpaneel. 3. Pad en rechten van `Media__Directory` en grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek). 4. Staat er een reverse proxy/CDN van de hoster voor IIS (voor `ForwardedHeaders__KnownProxies__0`)? -5. Welke MariaDB/MySQL-versie, welke gebruikersrechten (CREATE/ALTER voor de migraties) en hoe heet de gebruiker exact (voorvoegsel?) en is er een lengtelimiet? (De database wordt `slopAndreaSlopFotografie`.) +5. Welke MariaDB/MySQL-versie en welke gebruikersrechten (CREATE/ALTER voor de migraties) heeft de gebruiker `57409_andreaslopfotografie` precies, en is de naam hoofdlettergevoelig op de server? (Database en gebruiker: `57409_andreaslopfotografie`, letterlijk uit het paneel.) From 184262a4800bbffa1972e882692a91fc8eed9597 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Wed, 18 Nov 2026 22:14:55 +0100 Subject: [PATCH 5/7] Docs: externe ASF-database (formaat, SslMode=Required, rechten, timeouts, gedrag bij start); host en poort als placeholders Co-Authored-By: Claude Sonnet 5.5 --- .../asf-iis-production-config.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 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 34150b4..b93309d 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 @@ -17,7 +17,7 @@ Legenda: **V** = verplicht (de host start niet of werkt niet zonder), **A** = aa | Sleutel (als omgevingsvariabele) | | G | Voorbeeld / uitleg | |---|---|---|---| | `ASPNETCORE_ENVIRONMENT` | V | nee | `Production` (laadt `appsettings.Production.json`; bepaalt ook de Sentry-omgeving als `Observability__Environment` leeg is). | -| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=3306;Database=57409_andreaslopfotografie;Uid=57409_andreaslopfotografie;Pwd=` (MariaDB/MySQL van de hoster). Productie: het hostingpaneel heeft database en gebruiker aangemaakt als `57409_andreaslopfotografie` (voorvoegsel `57409_` van de hoster, alles kleine letters); neem die naam **letterlijk** over in `Database=` en `Uid=` (let op hoofdlettergevoeligheid: op de hoster kan de naam hoofdlettergevoelig zijn). Test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het paneel kan ook een lengtelimiet opleggen. De migraties draaien bij de eerste start (zie 4). | +| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=;SslMode=Required;Default Command Timeout=120;` (externe MariaDB van de hoster, niet localhost; adres en poort uit het paneel, hier bewust als `` en `` en nooit in de repo; zie 4a voor `SslMode` en de timeouts). Productie: het hostingpaneel heeft database en gebruiker aangemaakt als `57409_andreaslopfotografie` (voorvoegsel `57409_` van de hoster, alles kleine letters); neem die naam **letterlijk** over in `Database=` en `Uid=` (let op hoofdlettergevoeligheid: op de hoster kan de naam hoofdlettergevoelig zijn). Test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het paneel kan ook een lengtelimiet opleggen. De migraties draaien bij de eerste start (zie 4). | | `JwtSettings__Secret` | V | **ja** | Minstens 32 willekeurige tekens, uniek voor productie (niet de ontwikkelsleutel). Wisselen logt alle ingelogde gebruikers uit. | | `JwtSettings__Issuer` / `JwtSettings__Audience` | O | nee | Staan in de committed `appsettings.json` (`SlpModularCms` / `SlpModularCmsPortal`); alleen zetten om af te wijken. | | `JwtSettings__CookieSameSite` | O | nee | Standaard `Strict` (goed: de admin staat op dezelfde site als de API). Niet op `None` zetten. | @@ -162,7 +162,7 @@ Voorkeur: **server-only `appsettings.Production.json`**, naast de exe, rechten a ```json { "ConnectionStrings": { - "DefaultConnection": "Server=;Port=3306;Database=57409_andreaslopfotografie;Uid=57409_andreaslopfotografie;Pwd=" + "DefaultConnection": "Server=;Port=;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=;SslMode=Required;Default Command Timeout=120;" }, "JwtSettings": { "Secret": "" @@ -189,6 +189,19 @@ Regels: Een lege productiedatabase (door het hostingpaneel aangemaakt als `57409_andreaslopfotografie`, met gebruiker `57409_andreaslopfotografie`; de namen letterlijk overnemen, alles kleine letters; de gebruiker heeft CREATE/ALTER/INDEX/DROP-rechten voor de migraties; de oude WordPress-database `andreaslop` blijft ongebruikt en wordt niet gekoppeld): de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). +## 4a. De externe database: verbinding, TLS, rechten en gedrag bij een trage of onbereikbare server + +Gecontroleerd tegen de code van de host (2026-11-18): + +- **Formaat.** De host gebruikt de Oracle-provider (`MySql.EntityFrameworkCore`, `UseMySQL`) met `MySql.Data` 9.7, niet Pomelo/MySqlConnector. Getest met de connection-string-builder van die assembly: `Server`, `Port`, `Database`, `User` (synoniem van `Uid`) en `Password` (synoniem van `Pwd`) worden herkend. Het formaat van Bryan werkt dus; `User=`/`Password=` of `Uid=`/`Pwd=` is hetzelfde. +- **TLS (`SslMode`).** Het verkeer gaat over het internet naar een extern adres; zonder TLS staan het wachtwoord-handshake en alle gegevens onversleuteld op de lijn. De standaard van de provider is `SslMode=Preferred` (TLS als de server het aanbiedt, anders stilzwijgend ongeversleuteld, en dus te dwingen terug te vallen). Aanbeveling: **`SslMode=Required`** in de connection string zetten. Werkt de eerste start dan niet ("SSL Connection error" of een handshake-fout in het log), vraag de hoster of de MariaDB-server TLS aanbiedt; pas als die dat niet kan, tijdelijk `Preferred` gebruiken en dat als open risico bij Bryan neerleggen. `VerifyCA`/`VerifyFull` kan alleen met het CA-bestand van de hoster (`SslCa=`); niet nodig voor de eerste start. +- **Toegang van buiten.** Een externe MariaDB laat vaak alleen toegestane bronadressen toe: het uitgaande IP-adres van de webserver (IIS) moet in het paneel zijn toegestaan. Ontwikkel- en testmachines komen er niet bij tenzij ze ook zijn toegestaan; test niet met de productiegegevens vanaf een laptop. +- **Rechten.** De migraties van Core, Identity, Availability, Offerings, Hero, Media en Contact maken en wijzigen tabellen, indexen en (bij de Hero-migraties) verwijderen een kolom of tabel. De gebruiker heeft op deze database minstens SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP en REFERENCES nodig; de standaardgebruiker van een hostingpaneel heeft alle rechten op zijn eigen database. Controle voor de eerste start: `SHOW GRANTS FOR CURRENT_USER();` (vanuit het paneel of een toegestane client). De tabel `__EFMigrationsHistory` wordt zelf aangemaakt. +- **Timeouts.** Standaard wacht de provider 15 seconden op een verbinding (`Connection Timeout`) en 30 seconden per opdracht (`Default Command Timeout`). Over een externe verbinding kan een DDL-opdracht (bijvoorbeeld een migratie met een grote tabel) langer duren; daarom `Default Command Timeout=120` in de voorbeeld-string. De Hero-migratie die de oude tabel verwijdert, duurde op test ongeveer 24 seconden. +- **Bij start.** De Core-migratie probeert het vijf keer (`DatabaseMigrationExtensions`: wachttijden 2, 4, 6 en 8 seconden, elke poging maximaal 15 seconden verbindingstijd, dus ruim een minuut bij een onbereikbare server). Daarna logt de host een Critical-melding zonder wachtwoord of connection string (en stuurt die naar Sentry als die aan staat) en **start het proces niet**; IIS toont dan een 500.30 (de app kon niet starten). De reden staat in het stdout-logbestand (`stdoutLogEnabled="true"`, zie de web.config). Een verkeerd wachtwoord of onbekende gebruiker telt als een verbindingsfout en geeft hetzelfde resultaat. +- **Let op, andere modules.** De migraties van de overige modules (Identity, Availability, Offerings, Hero, Media, Contact) lopen na die van Core, elk in de eigen module. Een fout daar wordt als `Error` gelogd ("Fout bij het activeren van module ...") en de applicatie draait dan door zonder de tabellen van die module (behalve bij de bewuste stopmelding van de Hero-controle vóór het verwijderen van `HeroImages`, die de start wel stopt). Controleer na de eerste start het stdout-log op die regel en controleer `/api/v1/System/capabilities`. +- **Wachtwoord.** Alleen in `appsettings.Production.json` (zie 3); het adres en de poort staan niet in de repo of deze doc. + ## 5. Open punten voor Bryan 1. Staat de ASP.NET Core Module (Hosting Bundle) op de server van MijnHostingPartner, en welke `hostingModel` ondersteunen ze? (Bepaalt `inprocess` of `outofprocess`.) From aa118c55f747591bb906758585c5a20f04af2c36 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Thu, 19 Nov 2026 00:06:37 +0100 Subject: [PATCH 6/7] Docs: ASF-productieconfiguratie naar een server-only appsettings.Production.json (Bryans besluiten 2026-11-19) Geen web.config + appsettings-combinatie meer; alle sleutels als JSON-pad; volledig voorbeeldbestand met verschillen t.o.v. ASF-test; mediamap uploads met testprocedure; database als IP+poort, TLS-test met HeidiSQL en het risico zonder IP-beperking; open punten bijgewerkt. Co-Authored-By: Claude Sonnet 5.5 --- .../asf-iis-production-config.md | 206 +++++++++++------- 1 file changed, 130 insertions(+), 76 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 b93309d..20a918e 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 @@ -1,12 +1,17 @@ # ASF op IIS (MijnHostingPartner): configuratiesleutels, web.config en geheimen -Voorstel (2026-11-18), nog niet uitgevoerd. Er is niets op productie gezet; alles hier wacht op Bryans go. Geschreven voor Bryan, die de omgevingsvariabelen op de hoster instelt. Bronnen: `src/SlpModularCms.Api.AndreaSlopFotografie/appsettings.json`, de Options-klassen in Core en de modules, `docs/release-checklist-productie.md`, `README.md` (E-mail, Rate limiting), `docs/hero-module.md`. +Voorstel (bijgewerkt 2026-11-19 met Bryans besluiten), nog niet uitgevoerd. Er is niets op productie gezet; alles hier wacht op Bryans go. Geschreven voor Bryan, die de configuratie op de hoster zet. Bronnen: `src/SlpModularCms.Api.AndreaSlopFotografie/appsettings.json`, de Options-klassen in Core en de modules, `construction/andreaslop-client/infrastructure-design/infrastructure-design.md` (de sleutels van ASF-test), `docs/release-checklist-productie.md`, `README.md` (E-mail, Rate limiting), `docs/hero-module.md`. -Samenvatting in vier regels: -1. De host leest configuratie in deze volgorde (latere wint): `appsettings.json` (in de release, bevat alleen veilige standaardwaarden) < `appsettings.Production.json` (alleen op de server) < omgevingsvariabelen (web.config) < command line. -2. **Geheimen** (verbindingsstring, JWT-sleutel, SMTP-wachtwoord, Setup-token) in een **alleen-server `appsettings.Production.json`**; **niet-geheime** waarden in het `environmentVariables`-blok van de web.config of ook in dat bestand. Zet een sleutel niet op twee plekken: de omgevingsvariabele wint stilzwijgend. -3. De deploy (FTP) mag `appsettings.Production.json` en de mediamap nooit overschrijven of verwijderen; die zitten niet in het artefact. -4. Een sleutel in JSON schrijf je geneste (`"ConnectionStrings": { "DefaultConnection": ... }`); als omgevingsvariabele met dubbele underscore (`ConnectionStrings__DefaultConnection`). Lijstwaarden als `__0`, `__1`, ... +**Besluiten van Bryan (2026-11-19)** +1. **Eén bron voor configuratie: een server-only `appsettings.Production.json`** naast het programma. Geen combinatie met omgevingsvariabelen. De `web.config` bevat alleen de aspNetCore-handler (inprocess), het stdout-log voor de eerste start, de uploadlimiet en de hosterstandaard, en uit het hele `environmentVariables`-blok alleen `ASPNETCORE_ENVIRONMENT`. +2. **Foto's** staan in de map `uploads` naast `wwwroot` op de IIS-host (zie 1e). +3. **Hoster:** Hosting Bundle aanwezig, eigen `appsettings.Production.json` toegestaan, WordPress mag na een back-up weg, FTPS beschikbaar. +4. **Database:** extern; `Server` is het **IP-adres en de poort uit het paneel** (de hostnaam wijst via DNS naar een ander, onbereikbaar adres). TLS is nog onbekend; toegang beperken tot het IP van de webserver kan niet (zie 4a: risico). + +Samenvatting: +1. De host leest configuratie in deze volgorde (latere wint): `appsettings.json` (in de release, alleen veilige standaardwaarden) < `appsettings.Production.json` (alleen op de server). Omgevingsvariabelen en command line zijn niet in gebruik; `ASPNETCORE_ENVIRONMENT` staat in de web.config. +2. **Alle instellingen en geheimen** staan in dat ene bestand, als JSON-structuur (`"Sectie": { "Sleutel": ... }`). De tabellen hieronder noemen een sleutel als `Sectie:Sleutel`; een lijst als `Sectie:Lijst[0]`. +3. De deploy (FTPS) mag `appsettings.Production.json`, `logs` en `uploads` nooit overschrijven of verwijderen; die zitten niet in het artefact. ## 1. Sleutels die de host voor ASF-productie nodig heeft @@ -14,62 +19,68 @@ Legenda: **V** = verplicht (de host start niet of werkt niet zonder), **A** = aa ### 1a. Omgeving en basis -| Sleutel (als omgevingsvariabele) | | G | Voorbeeld / uitleg | +| Sleutel (JSON-pad) | | G | Voorbeeld / uitleg | |---|---|---|---| -| `ASPNETCORE_ENVIRONMENT` | V | nee | `Production` (laadt `appsettings.Production.json`; bepaalt ook de Sentry-omgeving als `Observability__Environment` leeg is). | -| `ConnectionStrings__DefaultConnection` | V | **ja** | `Server=;Port=;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=;SslMode=Required;Default Command Timeout=120;` (externe MariaDB van de hoster, niet localhost; adres en poort uit het paneel, hier bewust als `` en `` en nooit in de repo; zie 4a voor `SslMode` en de timeouts). Productie: het hostingpaneel heeft database en gebruiker aangemaakt als `57409_andreaslopfotografie` (voorvoegsel `57409_` van de hoster, alles kleine letters); neem die naam **letterlijk** over in `Database=` en `Uid=` (let op hoofdlettergevoeligheid: op de hoster kan de naam hoofdlettergevoelig zijn). Test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het paneel kan ook een lengtelimiet opleggen. De migraties draaien bij de eerste start (zie 4). | -| `JwtSettings__Secret` | V | **ja** | Minstens 32 willekeurige tekens, uniek voor productie (niet de ontwikkelsleutel). Wisselen logt alle ingelogde gebruikers uit. | -| `JwtSettings__Issuer` / `JwtSettings__Audience` | O | nee | Staan in de committed `appsettings.json` (`SlpModularCms` / `SlpModularCmsPortal`); alleen zetten om af te wijken. | -| `JwtSettings__CookieSameSite` | O | nee | Standaard `Strict` (goed: de admin staat op dezelfde site als de API). Niet op `None` zetten. | +| `ASPNETCORE_ENVIRONMENT` | V | nee | `Production` (laadt `appsettings.Production.json`; bepaalt ook de Sentry-omgeving als `Observability:Environment` leeg is). | +| `ConnectionStrings:DefaultConnection` | V | **ja** | `Server=;Port=;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=;SslMode=Required;Default Command Timeout=120;` (externe MariaDB van de hoster, niet localhost; adres en poort uit het paneel, hier bewust als `` en `` en nooit in de repo; zie 4a voor `SslMode` en de timeouts). Productie: het hostingpaneel heeft database en gebruiker aangemaakt als `57409_andreaslopfotografie` (voorvoegsel `57409_` van de hoster, alles kleine letters); neem die naam **letterlijk** over in `Database=` en `Uid=` (let op hoofdlettergevoeligheid: op de hoster kan de naam hoofdlettergevoelig zijn). Test blijft `AndreaSlopFotografieTest`. Een eigen database, niet die van een andere site, en **niet** de oude WordPress-database `andreaslop` (die wordt niet gebruikt en blijft ongemoeid). Het paneel kan ook een lengtelimiet opleggen. De migraties draaien bij de eerste start (zie 4). | +| `JwtSettings:Secret` | V | **ja** | Minstens 32 willekeurige tekens, uniek voor productie (niet de ontwikkelsleutel). Wisselen logt alle ingelogde gebruikers uit. | +| `JwtSettings:Issuer` / `JwtSettings:Audience` | O | nee | Staan in de committed `appsettings.json` (`SlpModularCms` / `SlpModularCmsPortal`); alleen zetten om af te wijken. | +| `JwtSettings:CookieSameSite` | O | nee | Standaard `Strict` (goed: de admin staat op dezelfde site als de API). Niet op `None` zetten. | | `AllowedHosts` | A | nee | `andreaslop.nl;www.andreaslop.nl` (committed waarde is `*`). | -| `Cors__AllowedOrigins__0` | O | nee | Leeg laten: de admin draait op dezelfde origin (`/admin`). Alleen invullen als de admin elders gehost wordt. | +| `Cors:AllowedOrigins[0]` | O | nee | Leeg laten: de admin draait op dezelfde origin (`/admin`). Alleen invullen als de admin elders gehost wordt. | ### 1b. De website (voorgerenderd) en zoekmachines | Sleutel | | G | Voorbeeld / uitleg | |---|---|---|---| -| `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__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). | +| `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: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). | ### 1c. Mail (uitnodigingen, wachtwoord opnieuw instellen) -Mail staat uit zolang `Email__Smtp__Host` leeg is; dan kopieert de beheerder de link. De host weigert te starten bij een onjuiste, half ingevulde mailconfiguratie (met een melding zonder geheimen). +Mail staat uit zolang `Email:Smtp:Host` leeg is; dan kopieert de beheerder de link. De host weigert te starten bij een onjuiste, half ingevulde mailconfiguratie (met een melding zonder geheimen). | Sleutel | | G | Voorbeeld / uitleg | |---|---|---|---| -| `Email__Smtp__Host` | A (nodig voor mail) | nee | `mail..nl` (zet mail aan). | -| `Email__Smtp__Port` / `Email__Smtp__EnableSsl` | A | nee | `587` / `true` (STARTTLS). | -| `Email__Smtp__Username` | A | **ja** | `no-reply@andreaslop.nl` | -| `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__DefaultLanguage` | O | nee | `nl` | +| `Email:Smtp:Host` | A (nodig voor mail) | nee | `mail..nl` (zet mail aan). | +| `Email:Smtp:Port` / `Email:Smtp:EnableSsl` | A | nee | `587` / `true` (STARTTLS). | +| `Email:Smtp:Username` | A | **ja** | `no-reply@andreaslop.nl` | +| `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:DefaultLanguage` | O | nee | `nl` | ### 1d. Eerste beheerder en toegang | Sleutel | | G | Voorbeeld / uitleg | |---|---|---|---| -| `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. | +| `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. | ### 1e. Foto's (Hero en Media) | Sleutel | | G | Voorbeeld / uitleg | |---|---|---|---| -| `Media__Directory` | V voor uploads | nee | Een map **buiten de release en buiten de webroot**, bijvoorbeeld `D:\data\andreaslop\media`. Beschrijfbaar voor de identiteit van de application pool. Zonder deze instelling (of bij een niet-beschrijfbare map) staan uploads uit; bestaande foto's blijven werken. De map moet in de back-up zitten. | -| `Media__MaxUploadBytes` / `Media__MaxTotalBytes` | O | nee | 10 MB per foto / 2 GB totaal (standaard). Pas aan als het hostingpakket kleiner is dan 2 GB. | -| `Media__RetentionDays` / `Media__TrashDays` | O | nee | 7 / 7 (standaard). | -| `Media__AutoCleanupUnattached` | O | nee | `false` (standaard): ongebruikte uploads blijven tot iemand ze in de mediabibliotheek verwijdert. | -| `Media__MaxParallelJobs` | A | nee | `2` (standaard); op een kleine gedeelde hosting `1`. | -| `Hero__TextOnlyRegion`, `Hero__TitlePrefix` | O | nee | Voor ASF leeg laten (ASF heeft foto's in de hero). | -| `Hero__MaxPublishedSlides` | O | nee | `50` (standaard). | +| `Media:Directory` | V voor uploads | nee | De map **`uploads` naast `wwwroot`** op de IIS-host, als **absoluut fysiek pad uit het hostingpaneel**, bijvoorbeeld `"Directory": "\\uploads"` (in JSON elke `\` verdubbelen, of gebruik `/`). Het pad moet **buiten `wwwroot`** blijven: wat in `wwwroot` staat kan IIS rechtstreeks serveren. Bryan geeft de identiteit van de application pool schrijfrechten op de map. Zonder deze instelling (of bij een niet-beschrijfbare map) staan uploads uit; bestaande foto's blijven werken. De map moet in de back-up zitten. Test: zie onder. | +| `Media:MaxUploadBytes` / `Media:MaxTotalBytes` | O | nee | 10 MB per foto / 2 GB totaal (standaard). Pas aan als het hostingpakket kleiner is dan 2 GB. | +| `Media:RetentionDays` / `Media:TrashDays` | O | nee | 7 / 7 (standaard). | +| `Media:AutoCleanupUnattached` | O | nee | `false` (standaard): ongebruikte uploads blijven tot iemand ze in de mediabibliotheek verwijdert. | +| `Media:MaxParallelJobs` | A | nee | `2` (standaard); op een kleine gedeelde hosting `1`. | +| `Hero:TextOnlyRegion`, `Hero:TitlePrefix` | O | nee | Voor ASF leeg laten (ASF heeft foto's in de hero). | +| `Hero:MaxPublishedSlides` | O | nee | `50` (standaard). | + +**Testen van de mediamap (na de eerste start, in deze volgorde):** +1. Log in de admin in en upload een foto in de mediabibliotheek (Hero of Media). +2. Controleer dat in de map `uploads` (via FTPS of het paneel) een nieuw bestand of een nieuwe submap staat. Staat er niets en meldt de admin een fout of staan uploads uit: het pad klopt niet of de pool-identiteit mag er niet schrijven. +3. Controleer dat de foto op de website of in de admin zichtbaar is en dat de map `uploads` niet via de browser bereikbaar is (geen URL onder `wwwroot` of `/uploads/`). +4. Een deploy daarna mag de map niet leegmaken: controleer dat het bestand na de volgende release er nog staat. Controle na de eerste start: het log toont `Image library Magick.NET self-test passed`. Zo niet, dan zijn uploads uitgezet (de native Magick-bibliotheek moet bij de self-contained win-x64 build zitten). @@ -77,29 +88,29 @@ Controle na de eerste start: het log toont `Image library Magick.NET self-test p | Sleutel | | G | Voorbeeld / uitleg | |---|---|---|---| -| `Contact__Enabled` | O | nee | **Niet zetten** (standaard `false`) tot Bryan het formulier live wil. Dan nog `Contact__RecipientEmail` en een werkende mailconfiguratie. | -| `Contact__RecipientEmail` | alleen bij Enabled | nee | Adres dat de meldingen krijgt (de admin kan een eigen adres instellen). | -| `Contact__Captcha__Enabled` | O | nee | `false` (standaard); er is geen captcha-aanbieder gekozen. Aanzetten vereist `SiteKey`, `Secret` (**G**), `Region` en laat de host bij foute waarden niet starten. | -| `Contact__RetentionMonths` / `Contact__SpamRetentionDays` | O | nee | 12 / 30 (standaard); moeten kloppen met de privacyverklaring. | +| `Contact:Enabled` | O | nee | **Niet zetten** (standaard `false`) tot Bryan het formulier live wil. Dan nog `Contact:RecipientEmail` en een werkende mailconfiguratie. | +| `Contact:RecipientEmail` | alleen bij Enabled | nee | Adres dat de meldingen krijgt (de admin kan een eigen adres instellen). | +| `Contact:Captcha:Enabled` | O | nee | `false` (standaard); er is geen captcha-aanbieder gekozen. Aanzetten vereist `SiteKey`, `Secret` (**G**), `Region` en laat de host bij foute waarden niet starten. | +| `Contact:RetentionMonths` / `Contact:SpamRetentionDays` | O | nee | 12 / 30 (standaard); moeten kloppen met de privacyverklaring. | ### 1g. Beveiligingsheaders, Sentry en Umami | Sleutel | | G | Voorbeeld / uitleg | |---|---|---|---| -| `SecurityHeaders__Enabled` | O | nee | `true` (standaard). De committed instellingen geven de website het `StrictSite`-beleid en laten alleen Umami (`https://analytics.slpsoftware.nl`) en de Sentry-ingest toe. Niet verruimen zonder reden. | -| `SecurityHeaders__AllowedSiteFrameOrigins__0` | O | nee | Alleen als de site een iframe van een derde partij toont (bijv. captcha). Leeg = geen `frame-src`. | -| `Observability__SentryDsn` | A | nee (halfopenbaar) | `https://@o....ingest.de.sentry.io/`. Leeg = geen Sentry, console-logging blijft. Gebruik een eigen Sentry-project voor ASF-productie. | -| `Observability__Environment` | A | nee | `production` (valt anders terug op `ASPNETCORE_ENVIRONMENT`). | -| `Observability__TracesSampleRate` | O | nee | `0.1` (standaard). | +| `SecurityHeaders:Enabled` | O | nee | `true` (standaard). De committed instellingen geven de website het `StrictSite`-beleid en laten alleen Umami (`https://analytics.slpsoftware.nl`) en de Sentry-ingest toe. Niet verruimen zonder reden. | +| `SecurityHeaders:AllowedSiteFrameOrigins[0]` | O | nee | Alleen als de site een iframe van een derde partij toont (bijv. captcha). Leeg = geen `frame-src`. | +| `Observability:SentryDsn` | A | nee (halfopenbaar) | `https://@o....ingest.de.sentry.io/`. Leeg = geen Sentry, console-logging blijft. Gebruik een eigen Sentry-project voor ASF-productie. | +| `Observability:Environment` | A | nee | `production` (valt anders terug op `ASPNETCORE_ENVIRONMENT`). | +| `Observability:TracesSampleRate` | O | nee | `0.1` (standaard). | | Umami | n.v.t. | nee | De host en de admin gebruiken geen Umami; alleen de website zelf laadt het script (de CSP staat het toe). Niets in de host-configuratie. | ### 1h. Wat je niet hoeft te zetten -`Availability__*`, `MasterPolling__*`: ASF is geen master/slave-opstelling (alleen Identity, Availability, Offerings, Hero, Media, Contact). `Logging__LogLevel__*`: de committed waarden zijn goed (EF-SQL op `Warning`, zodat er geen e-mailadressen in het log komen); gebruik voor de websitelog `Website__LogLevel`, niet `Logging__LogLevel__SlpModularCms.Website` (een punt in een variabelenaam werkt niet in een omgevingsvariabele). Data Protection-sleutels staan in de database (vast, geen configuratie). +`Availability:*`, `MasterPolling:*`: ASF is geen master/slave-opstelling (alleen Identity, Availability, Offerings, Hero, Media, Contact). `Logging:LogLevel:*`: de committed waarden zijn goed (EF-SQL op `Warning`, zodat er geen e-mailadressen in het log komen); gebruik voor de websitelog `Website:LogLevel` (ook in JSON de bedoelde sleutel). Data Protection-sleutels staan in de database (vast, geen configuratie). ## 2. Sjabloon voor de gepubliceerde web.config -`dotnet publish` (Sdk.Web) maakt zelf een `web.config` met de `aspNetCore`-handler; in de ASF-pijplijn voegen we de standaardinstellingen van de hoster (defaultDocument, headers) daarin samen. De referentiefile van de hoster (alleen defaultDocument, `X-Powered-By`, `httpErrors`) bevat nog geen handler. Voorstel: +`dotnet publish` (Sdk.Web) maakt zelf een `web.config` met de `aspNetCore`-handler; in de ASF-pijplijn voegen we de standaardinstellingen van de hoster (headers) daarin samen. De web.config bevat alleen: de handler (inprocess), het stdout-log, de uploadlimiet en de hosterstandaard. De referentiefile van de hoster (alleen defaultDocument, `X-Powered-By`, `httpErrors`) bevat nog geen handler. Voorstel: ```xml @@ -111,8 +122,8 @@ Controle na de eerste start: het log toont `Image library Magick.NET self-test p + (Hosting Bundle); aanwezig volgens de hoster. Valt het toch tegen: hostingModel="outofprocess" + (Kestrel achter IIS; dan telt ForwardedHeaders:KnownProxies[0] = 127.0.0.1). --> - - - - - + @@ -155,39 +162,79 @@ 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. -## 3. Geheimen: waar en hoe +## 3. De productie-appsettings (`appsettings.Production.json`) -Voorkeur: **server-only `appsettings.Production.json`**, naast de exe, rechten alleen voor de identiteit van de application pool en de beheerder. Voordelen: de FTP-deploy overschrijft de web.config bij elke release (en publiceert alleen wat in het artefact zit), maar dit bestand zit niet in het artefact en blijft staan; het staat niet in de repo en niet in `wwwroot` (wordt nooit geserveerd); lokale wijzigingen zijn zonder herdeploy mogelijk (de host herlaadt het bestand, of recycle de pool). +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). + +**Uitgangspunt: de instellingen van ASF-test** (`infrastructure-design.md`: de test-env bevat `ASPNETCORE_ENVIRONMENT`, `ASPNETCORE_URLS`, `ConnectionStrings:DefaultConnection`, `JwtSettings:Secret`, `Identity:Setup:Token`, `Observability:SentryDsn`, `Observability:Environment`, `ForwardedHeaders:KnownProxies[0]` en `Website:LogLevel`, naast de committed standaardwaarden). Of het echte testbestand op de Pi daarvan afwijkt (bijvoorbeeld `Website:PublicBaseUrl` of `App:PublicBaseUrl`, die in de doc niet staan) weet alleen Bryan; hij kan de sleutellijst zelf trekken, en als die afwijkt van deze doc, wordt de doc aangepast. Dit is anders voor productie: + +| Sleutel | Test (ASF-test) | Productie | +|---|---|---| +| `ASPNETCORE_URLS` | `http://0.0.0.0:5200` (systemd, Kestrel) | vervalt: IIS bepaalt het adres (inprocess) | +| `ConnectionStrings:DefaultConnection` | localhost, `AndreaSlopFotografieTest` | extern: IP + poort uit het paneel, database/gebruiker `57409_andreaslopfotografie`, `SslMode=Required` zodra TLS bevestigd is (zie 4a) | +| `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) | +| `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: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) | +| `AllowedHosts` | `*` | `andreaslop.nl;www.andreaslop.nl` | + +Waarden die alleen Bryan kent staan als ``; de rest is voorgesteld. ```json { + "AllowedHosts": "andreaslop.nl;www.andreaslop.nl", "ConnectionStrings": { - "DefaultConnection": "Server=;Port=;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=;SslMode=Required;Default Command Timeout=120;" + "DefaultConnection": "Server=;Port=;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=;SslMode=Required;Default Command Timeout=120;" }, "JwtSettings": { - "Secret": "" + "Secret": "" }, "Identity": { - "Setup": { "Token": "" } + "Setup": { "Token": "" } + }, + "Website": { + "NoIndex": true, + "PublicBaseUrl": "https://www.andreaslop.nl" + }, + "App": { + "PublicBaseUrl": "https://www.andreaslop.nl" }, "Email": { - "Smtp": { "Host": "mail..nl", "Username": "no-reply@andreaslop.nl", "Password": "" } + "Smtp": { + "Host": "", + "Port": 587, + "EnableSsl": true, + "Username": "", + "Password": "" + } + }, + "Media": { + "Directory": "\\uploads" }, "Observability": { - "SentryDsn": "https://@o.ingest.de.sentry.io/" + "SentryDsn": "", + "Environment": "production" } } ``` +Bij het release-moment zet Bryan `"NoIndex": false`; tot dan blijft `true` (veilig: geen zoekmachines). Overige sleutels uit de tabellen in 1 voeg je alleen toe om van de standaard af te wijken. + Regels: -- Een sleutel staat op **één** plek. Staat hij ook in het `environmentVariables`-blok, dan wint de omgevingsvariabele en lijkt het bestand genegeerd. -- Het bestand wordt **nooit** door de pijplijn gemaakt of vervangen. De pijplijn mag er niet op mirroren (FTP-sync die "extra" bestanden op de server verwijdert, zoals `lftp mirror --delete`, moet `appsettings.Production.json`, `logs/` en de mediamap uitsluiten). Bryan zet het bestand eenmalig met de hand. -- Alternatief als de hoster geen eigen bestanden naast de exe toestaat: omgevingsvariabelen in het IIS-beheer van de site (`Configuration Editor > system.webServer/aspNetCore/environmentVariables` of via het hostingpaneel); die overleven een deploy omdat ze niet in de web.config van het artefact staan. Niet in de gepubliceerde web.config. -- Geen geheimen in de repo, in logs of in dit soort documenten. Draai de sleutels (`JwtSettings__Secret`, SMTP-wachtwoord, databasewachtwoord) bij vermoeden van uitlekken; wijzigen van de JWT-sleutel logt iedereen uit. +- Alles staat in dit ene bestand; **geen** omgevingsvariabelen naast het bestand (behalve `ASPNETCORE_ENVIRONMENT` in de web.config). Zo is er maar één plek om te controleren. +- Het bestand wordt **nooit** door de pijplijn gemaakt of vervangen. Een FTPS-sync die "extra" bestanden op de server verwijdert (zoals `lftp mirror --delete`) moet `appsettings.Production.json`, `logs/` en `uploads/` uitsluiten. Bryan zet het bestand eenmalig met de hand. +- Wijzigen: de host herlaadt het bestand, of recycle de application pool. +- Geen geheimen in de repo, in logs of in dit soort documenten. Draai de sleutels (JWT-sleutel, SMTP-wachtwoord, databasewachtwoord) bij vermoeden van uitlekken; wijzigen van de JWT-sleutel logt iedereen uit. ## 4. Volgorde bij de eerste start (database) -Een lege productiedatabase (door het hostingpaneel aangemaakt als `57409_andreaslopfotografie`, met gebruiker `57409_andreaslopfotografie`; de namen letterlijk overnemen, alles kleine letters; de gebruiker heeft CREATE/ALTER/INDEX/DROP-rechten voor de migraties; de oude WordPress-database `andreaslop` blijft ongebruikt en wordt niet gekoppeld): de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity__Setup__Token` (eerste beheerder), `Identity__Setup__Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website__NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). +Een lege productiedatabase (door het hostingpaneel aangemaakt als `57409_andreaslopfotografie`, met gebruiker `57409_andreaslopfotografie`; de namen letterlijk overnemen, alles kleine letters; de gebruiker heeft CREATE/ALTER/INDEX/DROP-rechten voor de migraties; de oude WordPress-database `andreaslop` blijft ongebruikt en wordt niet gekoppeld): de host maakt bij de eerste start alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact). Geen `HeroImages`-kopie nodig (leeg: de guard laat door). Daarna: setuppagina met `Identity:Setup:Token` (eerste beheerder), `Identity:Setup:Token` weghalen, foto's uploaden of de hero seeden (met Bryans go), `Website:NoIndex=false` op het release-moment. Vooraf: databaseback-up en bij een bestaande database het herstelpunt (zie `production-rollout.md` van de mediabibliotheek). ## 4a. De externe database: verbinding, TLS, rechten en gedrag bij een trage of onbereikbare server @@ -195,17 +242,24 @@ Gecontroleerd tegen de code van de host (2026-11-18): - **Formaat.** De host gebruikt de Oracle-provider (`MySql.EntityFrameworkCore`, `UseMySQL`) met `MySql.Data` 9.7, niet Pomelo/MySqlConnector. Getest met de connection-string-builder van die assembly: `Server`, `Port`, `Database`, `User` (synoniem van `Uid`) en `Password` (synoniem van `Pwd`) worden herkend. Het formaat van Bryan werkt dus; `User=`/`Password=` of `Uid=`/`Pwd=` is hetzelfde. - **TLS (`SslMode`).** Het verkeer gaat over het internet naar een extern adres; zonder TLS staan het wachtwoord-handshake en alle gegevens onversleuteld op de lijn. De standaard van de provider is `SslMode=Preferred` (TLS als de server het aanbiedt, anders stilzwijgend ongeversleuteld, en dus te dwingen terug te vallen). Aanbeveling: **`SslMode=Required`** in de connection string zetten. Werkt de eerste start dan niet ("SSL Connection error" of een handshake-fout in het log), vraag de hoster of de MariaDB-server TLS aanbiedt; pas als die dat niet kan, tijdelijk `Preferred` gebruiken en dat als open risico bij Bryan neerleggen. `VerifyCA`/`VerifyFull` kan alleen met het CA-bestand van de hoster (`SslCa=`); niet nodig voor de eerste start. -- **Toegang van buiten.** Een externe MariaDB laat vaak alleen toegestane bronadressen toe: het uitgaande IP-adres van de webserver (IIS) moet in het paneel zijn toegestaan. Ontwikkel- en testmachines komen er niet bij tenzij ze ook zijn toegestaan; test niet met de productiegegevens vanaf een laptop. +- **Server = IP + poort.** Gebruik in `Server=` het IP-adres en in `Port=` de poort uit het hostingpaneel. De hostnaam van de hoster wijst via DNS naar een ander, onbereikbaar adres en werkt dus niet. +- **Toegang van buiten: risico.** De hoster biedt geen beperking tot het IP van de webserver; Bryan kan alleen een gebruiker aanmaken. De database is dus bereikbaar voor iedereen die IP, poort, gebruikersnaam en wachtwoord heeft. Daarom: een **sterk, uniek wachtwoord** (minstens 24 willekeurige tekens, nergens anders gebruikt), alleen deze ene gebruiker met rechten op alleen deze database, en **`SslMode=Required` zodra TLS bevestigd is**. Tot die bevestiging kan het wachtwoord onversleuteld over het internet gaan. Dit is een open risico voor Bryan. +- **TLS testen.** Bryan test met HeidiSQL (sessie, tabblad Geavanceerd, **"Use SSL"** aan, dan verbinden; lukt het niet, dan biedt de server geen TLS). Pas als dat werkt: `SslMode=Required` in de connection string. Biedt de server geen TLS, dan blijft het risico staan en beslist Bryan voor de livegang of dat acceptabel is. - **Rechten.** De migraties van Core, Identity, Availability, Offerings, Hero, Media en Contact maken en wijzigen tabellen, indexen en (bij de Hero-migraties) verwijderen een kolom of tabel. De gebruiker heeft op deze database minstens SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP en REFERENCES nodig; de standaardgebruiker van een hostingpaneel heeft alle rechten op zijn eigen database. Controle voor de eerste start: `SHOW GRANTS FOR CURRENT_USER();` (vanuit het paneel of een toegestane client). De tabel `__EFMigrationsHistory` wordt zelf aangemaakt. - **Timeouts.** Standaard wacht de provider 15 seconden op een verbinding (`Connection Timeout`) en 30 seconden per opdracht (`Default Command Timeout`). Over een externe verbinding kan een DDL-opdracht (bijvoorbeeld een migratie met een grote tabel) langer duren; daarom `Default Command Timeout=120` in de voorbeeld-string. De Hero-migratie die de oude tabel verwijdert, duurde op test ongeveer 24 seconden. - **Bij start.** De Core-migratie probeert het vijf keer (`DatabaseMigrationExtensions`: wachttijden 2, 4, 6 en 8 seconden, elke poging maximaal 15 seconden verbindingstijd, dus ruim een minuut bij een onbereikbare server). Daarna logt de host een Critical-melding zonder wachtwoord of connection string (en stuurt die naar Sentry als die aan staat) en **start het proces niet**; IIS toont dan een 500.30 (de app kon niet starten). De reden staat in het stdout-logbestand (`stdoutLogEnabled="true"`, zie de web.config). Een verkeerd wachtwoord of onbekende gebruiker telt als een verbindingsfout en geeft hetzelfde resultaat. - **Let op, andere modules.** De migraties van de overige modules (Identity, Availability, Offerings, Hero, Media, Contact) lopen na die van Core, elk in de eigen module. Een fout daar wordt als `Error` gelogd ("Fout bij het activeren van module ...") en de applicatie draait dan door zonder de tabellen van die module (behalve bij de bewuste stopmelding van de Hero-controle vóór het verwijderen van `HeroImages`, die de start wel stopt). Controleer na de eerste start het stdout-log op die regel en controleer `/api/v1/System/capabilities`. -- **Wachtwoord.** Alleen in `appsettings.Production.json` (zie 3); het adres en de poort staan niet in de repo of deze doc. +- **Wachtwoord, adres en poort.** Alleen in `appsettings.Production.json` (zie 3); het IP-adres en de poort staan niet in de repo of deze doc. ## 5. Open punten voor Bryan -1. Staat de ASP.NET Core Module (Hosting Bundle) op de server van MijnHostingPartner, en welke `hostingModel` ondersteunen ze? (Bepaalt `inprocess` of `outofprocess`.) -2. Mag er een eigen bestand (`appsettings.Production.json`) naast de exe, buiten de FTP-sync? Zo niet: omgevingsvariabelen via het hostingpaneel. -3. Pad en rechten van `Media__Directory` en grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek). -4. Staat er een reverse proxy/CDN van de hoster voor IIS (voor `ForwardedHeaders__KnownProxies__0`)? -5. Welke MariaDB/MySQL-versie en welke gebruikersrechten (CREATE/ALTER voor de migraties) heeft de gebruiker `57409_andreaslopfotografie` precies, en is de naam hoofdlettergevoelig op de server? (Database en gebruiker: `57409_andreaslopfotografie`, letterlijk uit het paneel.) +Beantwoord (2026-11-19): Hosting Bundle aanwezig; een eigen `appsettings.Production.json` naast het programma mag; WordPress mag na een back-up weg; FTPS is beschikbaar; de mediamap is `uploads` naast `wwwroot`. + +Nog open: +1. **Database-TLS.** Biedt de MariaDB-server TLS aan? Test met HeidiSQL ("Use SSL"). De uitkomst bepaalt `SslMode=Required` of het resterende risico. +2. **Toegangsbeperking tot het IP van de webserver** is niet mogelijk; 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. +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). From 3c358fa94d4094a47c1185bd09a5636eb52bb77b Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Thu, 19 Nov 2026 00:12:03 +0100 Subject: [PATCH 7/7] Docs: database-TLS bevestigd, SslMode=Required vast; restrisico certificaatcontrole en IP-beperking Co-Authored-By: Claude Sonnet 5.5 --- .../asf-iis-production-config.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 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 20a918e..ee077ed 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 @@ -6,7 +6,7 @@ Voorstel (bijgewerkt 2026-11-19 met Bryans besluiten), nog niet uitgevoerd. Er i 1. **Eén bron voor configuratie: een server-only `appsettings.Production.json`** naast het programma. Geen combinatie met omgevingsvariabelen. De `web.config` bevat alleen de aspNetCore-handler (inprocess), het stdout-log voor de eerste start, de uploadlimiet en de hosterstandaard, en uit het hele `environmentVariables`-blok alleen `ASPNETCORE_ENVIRONMENT`. 2. **Foto's** staan in de map `uploads` naast `wwwroot` op de IIS-host (zie 1e). 3. **Hoster:** Hosting Bundle aanwezig, eigen `appsettings.Production.json` toegestaan, WordPress mag na een back-up weg, FTPS beschikbaar. -4. **Database:** extern; `Server` is het **IP-adres en de poort uit het paneel** (de hostnaam wijst via DNS naar een ander, onbereikbaar adres). TLS is nog onbekend; toegang beperken tot het IP van de webserver kan niet (zie 4a: risico). +4. **Database:** extern; `Server` is het **IP-adres en de poort uit het paneel** (de hostnaam wijst via DNS naar een ander, onbereikbaar adres). TLS is bevestigd (Bryan, 2026-11-19: HeidiSQL met "Use SSL" verbindt, `Ssl_cipher` gevuld), dus `SslMode=Required`; toegang beperken tot het IP van de webserver kan niet (zie 4a: risico). Samenvatting: 1. De host leest configuratie in deze volgorde (latere wint): `appsettings.json` (in de release, alleen veilige standaardwaarden) < `appsettings.Production.json` (alleen op de server). Omgevingsvariabelen en command line zijn niet in gebruik; `ASPNETCORE_ENVIRONMENT` staat in de web.config. @@ -171,7 +171,7 @@ Eén bestand, **server-only**, naast het programma (naast de exe en de `appsetti | Sleutel | Test (ASF-test) | Productie | |---|---|---| | `ASPNETCORE_URLS` | `http://0.0.0.0:5200` (systemd, Kestrel) | vervalt: IIS bepaalt het adres (inprocess) | -| `ConnectionStrings:DefaultConnection` | localhost, `AndreaSlopFotografieTest` | extern: IP + poort uit het paneel, database/gebruiker `57409_andreaslopfotografie`, `SslMode=Required` zodra TLS bevestigd is (zie 4a) | +| `ConnectionStrings:DefaultConnection` | localhost, `AndreaSlopFotografieTest` | extern: IP + poort uit het paneel, database/gebruiker `57409_andreaslopfotografie`, `SslMode=Required` (TLS bevestigd, zie 4a) | | `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` | @@ -241,10 +241,10 @@ Een lege productiedatabase (door het hostingpaneel aangemaakt als `57409_andreas Gecontroleerd tegen de code van de host (2026-11-18): - **Formaat.** De host gebruikt de Oracle-provider (`MySql.EntityFrameworkCore`, `UseMySQL`) met `MySql.Data` 9.7, niet Pomelo/MySqlConnector. Getest met de connection-string-builder van die assembly: `Server`, `Port`, `Database`, `User` (synoniem van `Uid`) en `Password` (synoniem van `Pwd`) worden herkend. Het formaat van Bryan werkt dus; `User=`/`Password=` of `Uid=`/`Pwd=` is hetzelfde. -- **TLS (`SslMode`).** Het verkeer gaat over het internet naar een extern adres; zonder TLS staan het wachtwoord-handshake en alle gegevens onversleuteld op de lijn. De standaard van de provider is `SslMode=Preferred` (TLS als de server het aanbiedt, anders stilzwijgend ongeversleuteld, en dus te dwingen terug te vallen). Aanbeveling: **`SslMode=Required`** in de connection string zetten. Werkt de eerste start dan niet ("SSL Connection error" of een handshake-fout in het log), vraag de hoster of de MariaDB-server TLS aanbiedt; pas als die dat niet kan, tijdelijk `Preferred` gebruiken en dat als open risico bij Bryan neerleggen. `VerifyCA`/`VerifyFull` kan alleen met het CA-bestand van de hoster (`SslCa=`); niet nodig voor de eerste start. +- **TLS (`SslMode`).** De server ondersteunt TLS (Bryan, 2026-11-19: HeidiSQL met "Use SSL" aan en zonder certificaten verbindt, `Ssl_cipher` is gevuld). De standaard van de provider is `SslMode=Preferred` (TLS als de server het aanbiedt, anders stilzwijgend ongeversleuteld); daarom staat **`SslMode=Required`** vast in de connection string: de verbinding mislukt liever dan dat ze terugvalt op onversleuteld. Ziet de eerste start "SSL Connection error" of een handshake-fout in het log, controleer dan eerst het IP/de poort en het wachtwoord. **Restrisico:** `Required` versleutelt, maar controleert het servercertificaat niet, dus een man-in-the-middle op het pad is niet uitgesloten. `VerifyCA`/`VerifyFull` vraagt het CA-certificaat van de hoster (`SslCa=`); later, niet nu. - **Server = IP + poort.** Gebruik in `Server=` het IP-adres en in `Port=` de poort uit het hostingpaneel. De hostnaam van de hoster wijst via DNS naar een ander, onbereikbaar adres en werkt dus niet. -- **Toegang van buiten: risico.** De hoster biedt geen beperking tot het IP van de webserver; Bryan kan alleen een gebruiker aanmaken. De database is dus bereikbaar voor iedereen die IP, poort, gebruikersnaam en wachtwoord heeft. Daarom: een **sterk, uniek wachtwoord** (minstens 24 willekeurige tekens, nergens anders gebruikt), alleen deze ene gebruiker met rechten op alleen deze database, en **`SslMode=Required` zodra TLS bevestigd is**. Tot die bevestiging kan het wachtwoord onversleuteld over het internet gaan. Dit is een open risico voor Bryan. -- **TLS testen.** Bryan test met HeidiSQL (sessie, tabblad Geavanceerd, **"Use SSL"** aan, dan verbinden; lukt het niet, dan biedt de server geen TLS). Pas als dat werkt: `SslMode=Required` in de connection string. Biedt de server geen TLS, dan blijft het risico staan en beslist Bryan voor de livegang of dat acceptabel is. +- **Toegang van buiten: risico.** De hoster biedt geen beperking tot het IP van de webserver; Bryan kan alleen een gebruiker aanmaken. De database is dus bereikbaar voor iedereen die IP, poort, gebruikersnaam en wachtwoord heeft. Daarom: een **sterk, uniek wachtwoord** (minstens 24 willekeurige tekens, nergens anders gebruikt), alleen deze ene gebruiker met rechten op alleen deze database, en **`SslMode=Required`** (zie TLS hierboven). De ontbrekende IP-beperking blijft een restrisico voor Bryan. +- **TLS getest.** Bryan heeft het getest met HeidiSQL (sessie, tabblad Geavanceerd, "Use SSL" aan, geen certificaten): verbinding gelukt. Voor een latere hertest of een andere gebruiker: dezelfde stappen; lukt het niet, dan biedt de server geen TLS. - **Rechten.** De migraties van Core, Identity, Availability, Offerings, Hero, Media en Contact maken en wijzigen tabellen, indexen en (bij de Hero-migraties) verwijderen een kolom of tabel. De gebruiker heeft op deze database minstens SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP en REFERENCES nodig; de standaardgebruiker van een hostingpaneel heeft alle rechten op zijn eigen database. Controle voor de eerste start: `SHOW GRANTS FOR CURRENT_USER();` (vanuit het paneel of een toegestane client). De tabel `__EFMigrationsHistory` wordt zelf aangemaakt. - **Timeouts.** Standaard wacht de provider 15 seconden op een verbinding (`Connection Timeout`) en 30 seconden per opdracht (`Default Command Timeout`). Over een externe verbinding kan een DDL-opdracht (bijvoorbeeld een migratie met een grote tabel) langer duren; daarom `Default Command Timeout=120` in de voorbeeld-string. De Hero-migratie die de oude tabel verwijdert, duurde op test ongeveer 24 seconden. - **Bij start.** De Core-migratie probeert het vijf keer (`DatabaseMigrationExtensions`: wachttijden 2, 4, 6 en 8 seconden, elke poging maximaal 15 seconden verbindingstijd, dus ruim een minuut bij een onbereikbare server). Daarna logt de host een Critical-melding zonder wachtwoord of connection string (en stuurt die naar Sentry als die aan staat) en **start het proces niet**; IIS toont dan een 500.30 (de app kon niet starten). De reden staat in het stdout-logbestand (`stdoutLogEnabled="true"`, zie de web.config). Een verkeerd wachtwoord of onbekende gebruiker telt als een verbindingsfout en geeft hetzelfde resultaat. @@ -256,8 +256,8 @@ Gecontroleerd tegen de code van de host (2026-11-18): Beantwoord (2026-11-19): Hosting Bundle aanwezig; een eigen `appsettings.Production.json` naast het programma mag; WordPress mag na een back-up weg; FTPS is beschikbaar; de mediamap is `uploads` naast `wwwroot`. Nog open: -1. **Database-TLS.** Biedt de MariaDB-server TLS aan? Test met HeidiSQL ("Use SSL"). De uitkomst bepaalt `SslMode=Required` of het resterende risico. -2. **Toegangsbeperking tot het IP van de webserver** is niet mogelijk; een sterk, uniek wachtwoord is verplicht (zie 4a). +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. 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.)