Docs: externe ASF-database (formaat, SslMode=Required, rechten, timeouts, gedrag bij start); host en poort als placeholders
Continuous Integration / config-sls (pull_request) Successful in 8s
Continuous Integration / changes (pull_request) Successful in 16s
Continuous Integration / config-asf (pull_request) Successful in 13s
Continuous Integration / backend-build (pull_request) Skipped
Continuous Integration / compile-sites (pull_request) Skipped
Continuous Integration / backend-test (pull_request) Skipped
Continuous Integration / vulnerability-scan (pull_request) Skipped
Continuous Integration / frontend-prepare (pull_request) Skipped
Continuous Integration / frontend-build (pull_request) Skipped
Continuous Integration / frontend-test (pull_request) Skipped
Continuous Integration / frontend-lint (pull_request) Skipped
Continuous Integration / publish-sls-test (pull_request) Skipped
Continuous Integration / publish-sls-production (pull_request) Skipped
Continuous Integration / deploy-sls-test (pull_request) Skipped
Continuous Integration / deploy-sls-production (pull_request) Skipped
Continuous Integration / publish-asf-test (pull_request) Skipped
Continuous Integration / deploy-asf-test (pull_request) Skipped
Continuous Integration / smoke-sls-test (pull_request) Skipped
Continuous Integration / smoke-asf-test (pull_request) Skipped
Continuous Integration / config-sls (pull_request) Successful in 8s
Continuous Integration / changes (pull_request) Successful in 16s
Continuous Integration / config-asf (pull_request) Successful in 13s
Continuous Integration / backend-build (pull_request) Skipped
Continuous Integration / compile-sites (pull_request) Skipped
Continuous Integration / backend-test (pull_request) Skipped
Continuous Integration / vulnerability-scan (pull_request) Skipped
Continuous Integration / frontend-prepare (pull_request) Skipped
Continuous Integration / frontend-build (pull_request) Skipped
Continuous Integration / frontend-test (pull_request) Skipped
Continuous Integration / frontend-lint (pull_request) Skipped
Continuous Integration / publish-sls-test (pull_request) Skipped
Continuous Integration / publish-sls-production (pull_request) Skipped
Continuous Integration / deploy-sls-test (pull_request) Skipped
Continuous Integration / deploy-sls-production (pull_request) Skipped
Continuous Integration / publish-asf-test (pull_request) Skipped
Continuous Integration / deploy-asf-test (pull_request) Skipped
Continuous Integration / smoke-sls-test (pull_request) Skipped
Continuous Integration / smoke-asf-test (pull_request) Skipped
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -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=<db-host>;Port=3306;Database=57409_andreaslopfotografie;Uid=57409_andreaslopfotografie;Pwd=<wachtwoord>` (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=<host>;Port=<poort>;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=<wachtwoord>;SslMode=Required;Default Command Timeout=120;` (externe MariaDB van de hoster, niet localhost; adres en poort uit het paneel, hier bewust als `<host>` en `<poort>` 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=<db-host>;Port=3306;Database=57409_andreaslopfotografie;Uid=57409_andreaslopfotografie;Pwd=<wachtwoord>"
|
||||
"DefaultConnection": "Server=<host>;Port=<poort>;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=<wachtwoord>;SslMode=Required;Default Command Timeout=120;"
|
||||
},
|
||||
"JwtSettings": {
|
||||
"Secret": "<minstens 32 willekeurige tekens>"
|
||||
@@ -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=<pad>`); 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`.)
|
||||
|
||||
Reference in New Issue
Block a user