Files
slp-modular-cms/aidlc-docs/features/andreaslop-site-hosting/asf-iis-production-config.md
T
SluijsensandClaude Sonnet 5.5 aa118c55f7
Continuous Integration / config-asf (pull_request) Successful in 8s
Continuous Integration / config-sls (pull_request) Successful in 9s
Continuous Integration / changes (pull_request) Successful in 14s
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
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 <noreply@anthropic.com>
2026-11-19 00:06:37 +01:00

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)

  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

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):

  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).

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:

  • 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. 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 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 <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_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).

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.
  • 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, 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:

  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).