Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
26 KiB
ASF op IIS (MijnHostingPartner): configuratiesleutels, web.config en geheimen
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.
Besluiten van Bryan (2026-11-19)
- Eén bron voor configuratie: een server-only
appsettings.Production.jsonnaast het programma. Geen combinatie met omgevingsvariabelen. Deweb.configbevat alleen de aspNetCore-handler (inprocess), het stdout-log voor de eerste start, de uploadlimiet en de hosterstandaard, en uit het heleenvironmentVariables-blok alleenASPNETCORE_ENVIRONMENT. - Foto's staan in de map
uploadsnaastwwwrootop de IIS-host (zie 1e). - Hoster: Hosting Bundle aanwezig, eigen
appsettings.Production.jsontoegestaan, WordPress mag na een back-up weg, FTPS beschikbaar. - Database: extern;
Serveris 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_ciphergevuld), dusSslMode=Required; toegang beperken tot het IP van de webserver kan niet (zie 4a: risico).
Samenvatting:
- 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_ENVIRONMENTstaat in de web.config. - Alle instellingen en geheimen staan in dat ene bestand, als JSON-structuur (
"Sectie": { "Sleutel": ... }). De tabellen hieronder noemen een sleutel alsSectie:Sleutel; een lijst alsSectie:Lijst[0]. - De deploy (FTPS) mag
appsettings.Production.json,logsenuploadsnooit overschrijven of verwijderen; die zitten niet in het artefact.
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 (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=<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. |
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.<hoster>.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 | De map uploads naast wwwroot op de IIS-host, als absoluut fysiek pad uit het hostingpaneel, bijvoorbeeld "Directory": "<fysiek pad uit het paneel>\\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):
- Log in de admin in en upload een foto in de mediabibliotheek (Hero of Media).
- 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. - Controleer dat de foto op de website of in de admin zichtbaar is en dat de map
uploadsniet via de browser bereikbaar is (geen URL onderwwwrootof/uploads/). - 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).
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://<sleutel>@o....ingest.de.sentry.io/<project>. 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 (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 (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 version="1.0" encoding="utf-8"?>
<configuration>
<location path="." inheritInChildApplications="false">
<system.webServer>
<handlers>
<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
</handlers>
<!-- inprocess: de app draait in de IIS-werkproces (sneller, een proces). Vereist de ASP.NET Core Module
(Hosting Bundle); aanwezig volgens de hoster. Valt het toch tegen: hostingModel="outofprocess"
(Kestrel achter IIS; dan telt ForwardedHeaders:KnownProxies[0] = 127.0.0.1). -->
<aspNetCore processPath=".\SlpModularCms.Api.AndreaSlopFotografie.exe"
arguments=""
hostingModel="inprocess"
stdoutLogEnabled="true"
stdoutLogFile=".\logs\stdout">
<environmentVariables>
<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Production" />
<!-- Verder niets hier: alle instellingen en geheimen staan in appsettings.Production.json. -->
</environmentVariables>
</aspNetCore>
<!-- Uit de standaardfile van de hoster, ongewijzigd overgenomen -->
<directoryBrowse enabled="false" />
<httpProtocol>
<customHeaders>
<remove name="X-Powered-By" />
</customHeaders>
</httpProtocol>
<httpErrors errorMode="DetailedLocalOnly" existingResponse="Auto" />
<!-- Uploadlimiet van IIS (standaard 30 MB) boven de limiet van de hero (10 MB): -->
<security>
<requestFiltering>
<requestLimits maxAllowedContentLength="31457280" />
</requestFiltering>
</security>
</system.webServer>
</location>
</configuration>
Opmerkingen:
defaultDocumentvan de hoster laat ik weg: de app serveert/zelf (voorgerenderde pagina's uitwwwroot/web); eenindex.htmlin 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 deremove/addzoals in hun bestand. - stdout-log alleen voor de eerste start: zet
stdoutLogEnabled="false"na de eerste succesvolle start; de maplogsmoet bestaan en beschrijfbaar zijn. Het log bevat de opstartregels (migraties, Magick-self-test, guard-melding), geen geheimen. processPathhoort bij de self-contained build (.exenaast de web.config). Bij framework-dependent staat daardotnetenarguments=".\SlpModularCms.Api.AndreaSlopFotografie.dll".- Deploy: een
app_offline.htmin de siteroot zet de app tijdens het uploaden stil (geen vergrendelde bestanden); verwijderen na afloop.
3. De productie-appsettings (appsettings.Production.json)
Eén bestand, server-only, naast het programma (naast de exe en de appsettings.json uit de release); rechten alleen voor de identiteit van de application pool en de beheerder. Het zit niet in het artefact, dus de FTPS-deploy overschrijft het niet; het staat niet in de repo en niet in wwwroot (wordt nooit geserveerd). Bryan mag het bestand zelf op de server zetten (bevestigd door de hoster).
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 (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 |
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 <geheim>; de rest is voorgesteld.
{
"AllowedHosts": "andreaslop.nl;www.andreaslop.nl",
"ConnectionStrings": {
"DefaultConnection": "Server=<host>;Port=<poort>;Database=57409_andreaslopfotografie;User=57409_andreaslopfotografie;Password=<geheim>;SslMode=Required;Default Command Timeout=120;"
},
"JwtSettings": {
"Secret": "<geheim, minstens 32 willekeurige tekens, uniek voor productie>"
},
"Identity": {
"Setup": { "Token": "<geheim, minstens 32 tekens; na de eerste beheerder verwijderen>" }
},
"Website": {
"NoIndex": true,
"PublicBaseUrl": "https://www.andreaslop.nl"
},
"App": {
"PublicBaseUrl": "https://www.andreaslop.nl"
},
"Email": {
"Smtp": {
"Host": "<smtp-host; leeg = mail uit>",
"Port": 587,
"EnableSsl": true,
"Username": "<geheim>",
"Password": "<geheim>"
}
},
"Media": {
"Directory": "<fysiek pad uit het paneel>\\uploads"
},
"Observability": {
"SentryDsn": "<geheim/dsn>",
"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:
- Alles staat in dit ene bestand; geen omgevingsvariabelen naast het bestand (behalve
ASPNETCORE_ENVIRONMENTin 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) moetappsettings.Production.json,logs/enuploads/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).
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) metMySql.Data9.7, niet Pomelo/MySqlConnector. Getest met de connection-string-builder van die assembly:Server,Port,Database,User(synoniem vanUid) enPassword(synoniem vanPwd) worden herkend. Het formaat van Bryan werkt dus;User=/Password=ofUid=/Pwd=is hetzelfde. - TLS (
SslMode). De server ondersteunt TLS (Bryan, 2026-11-19: HeidiSQL met "Use SSL" aan en zonder certificaten verbindt,Ssl_cipheris gevuld). De standaard van de provider isSslMode=Preferred(TLS als de server het aanbiedt, anders stilzwijgend ongeversleuteld); daarom staatSslMode=Requiredvast 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:Requiredversleutelt, maar controleert het servercertificaat niet, dus een man-in-the-middle op het pad is niet uitgesloten.VerifyCA/VerifyFullvraagt het CA-certificaat van de hoster (SslCa=<pad>); later, niet nu. - Server = IP + poort. Gebruik in
Server=het IP-adres en inPort=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(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__EFMigrationsHistorywordt 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; daaromDefault Command Timeout=120in 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
Errorgelogd ("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 vanHeroImages, die de start wel stopt). Controleer na de eerste start het stdout-log op die regel en controleer/api/v1/System/capabilities. - 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
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:
Database-TLSafgehandeld: de server biedt TLS,SslMode=Requiredstaat in het voorbeeld. Restrisico: geen certificaatcontrole (VerifyCA/VerifyFulllater, met het CA-certificaat van de hoster).- Toegangsbeperking tot het IP van de webserver is niet mogelijk; blijft een restrisico. Een sterk, uniek wachtwoord is verplicht (zie 4a).
- Fysiek pad van
uploadsuit het hostingpaneel invullen inMedia:Directory, en schrijfrechten voor de application pool-identiteit zetten (Bryan). Daarna de test uit 1e. - Staat er een reverse proxy/CDN van de hoster voor IIS (voor
ForwardedHeaders:KnownProxies[0])? Zo niet: leeg laten. - 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.) - Grootte van het pakket (2 GB totaal is de standaardgrens van de bibliotheek).
- SMTP-aanbieder en afzenderadres voor mail (zie 1c).