Docs: ASF op IIS - configuratiesleutels, web.config-sjabloon en geheimenvoorstel #35

Open
Sluijsens wants to merge 6 commits from docs/asf-iis-production-config into master
Showing only changes of commit 46eedba199 - Show all commits
@@ -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=AndreaSlopFotografie;Uid=AndreaSlopFotografie;Pwd=<wachtwoord>` (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 `<account>_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=<db-host>;Port=3306;Database=slopAndreaSlopFotografie;Uid=<gebruiker>;Pwd=<wachtwoord>` (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 `<gebruiker>`). 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=<db-host>;Port=3306;Database=AndreaSlopFotografie;Uid=AndreaSlopFotografie;Pwd=<wachtwoord>"
"DefaultConnection": "Server=<db-host>;Port=3306;Database=slopAndreaSlopFotografie;Uid=<gebruiker uit het paneel>;Pwd=<wachtwoord>"
},
"JwtSettings": {
"Secret": "<minstens 32 willekeurige tekens>"
@@ -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`.)