From 184262a4800bbffa1972e882692a91fc8eed9597 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Wed, 18 Nov 2026 22:14:55 +0100 Subject: [PATCH] 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`.)