Files
slp-modular-cms/docs/privacy-gegevens-contactformulier.md
T
SluijsensandClaude Sonnet 5.5 321234dfa6 CMS: één bannerlijst met Locatie, SLP-thema, thema-schakelaar, documentatie
- Banner-admin: één lijst met Locatie-badge (Boven/Onder), Locatie-keuzeveld in het formulier, "Live" en "Wordt niet getoond" per locatie, aan/uit per rij
- Thema slpsoftware: Archivo, bordeaux #7A1414 (WCAG AA licht en donker), <SLP/>-logo, favicon, mail-logo; VITE_THEME in de SLP-builds (test en productie-config)
- Thema-schakelaar: eerste klik wisselt altijd het getoonde thema (klasse op <html> als bron van waarheid, gedeelde status, startscript valideert opslag) + tests
- Docs: README, docs/cms-themas.md, docs/deploy-en-testomgevingen.md, docs/privacy-gegevens-contactformulier.md, aidlc-docs (offering-banners, bug theme-toggle-first-click)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-15 00:14:10 +01:00

15 KiB

Privacy-gegevens van het contactformulier

Doel: feitelijke invoer voor de privacyverklaring van een website die de contactmodule gebruikt. Alles hieronder is gecontroleerd tegen de code op 2026-11-15 (branch feature/contact-forms-module, nog niet gemerged). Per feit staat het bronbestand; paden zijn relatief aan src/. Wat in de code niet te zien is (hostconfiguratie, mailserver, de website zelf) staat apart onder "Niet geverifieerd".

Dit is geen juridisch advies; het beschrijft alleen wat de software doet.

1. Wanneer is het formulier actief

Feit Bron
Het formulier werkt alleen als twee schakelaars aan staan: de hostschakelaar Contact:Enabled (omgevingsvariabele Contact__Enabled) en de CMS-schakelaar die een beheerder bij Berichten zet. Standaard staan beide uit. SlpModularCms.Modules.Contact/Services/ContactSettingsAndGates.cs, Controllers/ContactRouteFilter.cs, ContactModule.cs
Is het formulier niet open, dan bestaan de routes niet (404). Controllers/ContactRouteFilter.cs
In de meegeleverde appsettings.json staat Contact:Enabled op false voor Api.SlpSoftware (SiteId slpsoftware) en Api.AndreaSlopFotografie (SiteId andreaslop). Of het op een echte host aan staat, volgt uit de omgevingsvariabelen daar. SlpModularCms.Api.SlpSoftware/appsettings.json, SlpModularCms.Api.AndreaSlopFotografie/appsettings.json

2. Welke gegevens worden bij een bericht opgeslagen

Tabel ContactMessages (entiteit ContactMessage). Een bericht wordt alleen opgeslagen als alle velden geldig zijn (anders 400 en niets opgeslagen).

Gegeven Kolom Grenzen Opmerking
Naam Name max 100 tekens Ingevuld door bezoeker, getrimd
E-mailadres Email max 254 tekens Ingevuld door bezoeker; alleen een vormcontrole (x@y.zz)
Onderwerp Subject max 100 tekens Bedoeld als door de website gekozen waarde (pakket-id, slug of other, zo staat het in de code); de API controleert alleen lengte en tekens, dus ook een vrije tekst wordt geaccepteerd
Bericht Message max 2000 tekens Vrije tekst
Tijdstip van ontvangst ReceivedAt Server-tijd (UTC)
Site SiteId Uit configuratie (Contact:SiteId), nooit uit het verzoek
Status Status New, Read, Archived, Spam, Converted
Mailstatus MailStatus, MailAttempts, NextMailAttemptAt, MailError MailError max 100 Alleen een korte foutcode (bijv. auth_failed, disabled, recipient_not_configured), nooit een adres of tekst
Bewaren tot RetentionUntil Zie hoofdstuk 3

Bron: SlpModularCms.Modules.Contact/Data/Entities/ContactMessage.cs, Data/ContactDbContext.cs, Services/ContactValidator.cs, Services/ContactSubmissionService.cs, Services/ContactSeams.cs.

Wat niet wordt opgeslagen (gecontroleerd: deze velden komen niet in ContactMessage of een andere tabel van de module voor):

  • Geen IP-adres, geen hash van een IP-adres, geen user agent, geen referrer, geen cookies. (Ook de handoff-notitie zegt dit: aidlc-docs/features/contact-forms-module/construction/phase-1-handoff.md, regel "Privacy".)
  • De honeypot-waarde en het captcha-antwoord worden niet bewaard; ze beslissen alleen of een bericht als spam wordt gemarkeerd.
  • Het tijdtoken wordt niet opgeslagen (zie hoofdstuk 5).
  • Er is in ContactDbContext geen veldversleuteling te zien: de velden staan als gewone tekst in de database.

Overige tabellen van de module:

Tabel Inhoud Bron
ContactIdempotency SiteId, Key (een door de website gegenereerde GUID uit de header Idempotency-Key), CreatedAt, StatusCode. Geen inhoud van het bericht. Voorkomt dubbele verwerking bij herhaald verzenden; wordt na 24 uur verwijderd. Data/Entities/ContactMessage.cs (IdempotencyRecord), Services/ContactRetentionService.cs
ContactSettings Eén rij: CMS-schakelaar, het door een beheerder ingestelde ontvangstadres voor meldingen (RecipientEmail), UpdatedAt, UpdatedByUserId Data/Entities/ContactMessage.cs (ContactSettings)

3. Bewaartermijnen en opschonen

Onderwerp Waarde Configuratiesleutel Bron
Bewaartermijn echt bericht 12 maanden na ontvangst (vast per rij op het moment van opslaan; een latere wijziging van de instelling geldt niet met terugwerkende kracht) Contact:RetentionMonths (standaard 12) Config/ContactOptions.cs, Services/ContactSubmissionService.cs
Bewaartermijn spam 30 dagen Contact:SpamRetentionDays (standaard 30) idem
Maximum spamrijen 200 per site per UTC-dag; daarboven wordt spam beantwoord als normaal, maar niet opgeslagen Contact:MaxSpamRowsPerDay (standaard 200) idem
Idempotentie-gegevens 24 uur niet instelbaar Services/ContactRetentionService.cs, Services/ContactSubmissionService.cs
Spam alsnog als echt markeren (status naar nieuw/gelezen/gearchiveerd) de bewaartermijn start opnieuw: nu + RetentionMonths Services/ContactAdminService.cs (SetStatusAsync)

Opschoon-job (ContactRetentionService, een achtergrondservice):

  • Draait bij het opstarten van de applicatie en daarna elke 24 uur.
  • Verwijdert alle berichten waarvan RetentionUntil verstreken is, ongeacht status (ook gelezen, gearchiveerd of geconverteerd), in batches van 500, en idempotentie-rijen ouder dan 24 uur. Het aantal verwijderde rijen wordt gelogd, geen inhoud.
  • Doet niets (en raakt de database niet aan) zolang Contact:Enabled uit staat. Gevolg: zet je de hostschakelaar later uit, dan blijven opgeslagen berichten staan tot je hem weer aanzet.
  • Een beheerder kan een bericht ook direct en definitief verwijderen (DELETE /api/v1/contact-messages/{id}).
  • Er is in de code geen functie om berichten van één persoon te exporteren of op e-mailadres te zoeken; verwijderen gaat per bericht via de beheerlijst.

Bron: Services/ContactRetentionService.cs, Repositories/ContactRepository.cs, Controllers/ContactAdminControllers.cs.

Back-ups: vóór elke productie-deploy maakt de pipeline een databaseback-up via een script op de host (backup-slpsoftware-db.sh, run_db_backup: true in .gitea/workflows/continuous_integration.yaml). Volgens de feature-documentatie bewaart dat script de 7 meest recente back-ups per omgeving (aidlc-docs/features/gitea-deployment-workflow/operations/deployment/deployment-instructions.md, § 4). Het script zelf staat niet in deze repository: niet geverifieerd. Een verwijderd bericht kan dus nog in een back-up staan tot die roteert. Test-deploys (test) maken geen back-up in de pipeline.

4. Rate limiting (gegevens per bezoeker)

Feit Bron
Er zijn drie limieten: ContactForm (bericht versturen) 5 per 600 s, ContactToken (token ophalen) 20 per 600 s, ContactResend (opnieuw mailen door beheerder) 5 per 600 s. Instelbaar met RateLimiting:ContactForm, RateLimiting:ContactToken, RateLimiting:ContactResend (PermitLimit, WindowSeconds). ContactModule.cs, SlpModularCms.Api.SlpSoftware/appsettings.json
De teller is per clientadres: het IP-adres zoals de applicatie het ziet (ClientPartitionKey). Dat is het echte bezoekersadres als ForwardedHeaders:KnownProxies is ingesteld; zonder die instelling deelt iedereen het adres van de proxy. SlpModularCms.Core/Hosting/Proxy/ClientPartitionKey.cs, Services/ContactSeams.cs
De tellers staan alleen in het geheugen van het proces (ASP.NET Core RateLimiter, vast venster). Ze worden niet in de database opgeslagen en verdwijnen bij een herstart. ContactModule.cs (RateLimitPartition.GetFixedWindowLimiter)
Bij een geweigerd verzoek (429) wordt in het log alleen de naam van de limiet en het pad vastgelegd, niet het IP-adres. SlpModularCms.Core/Hosting/ServiceCollectionExtensions.cs (OnRejected), Observability/SecurityEvents.cs

5. Anti-spam

Maatregel Werking Bron
Honeypot Een verborgen veld hpCheck; is het ingevuld, dan geldt het bericht als spam. Services/ContactSubmissionService.cs
Minimumtijd De bezoeker haalt eerst een token op (GET /api/v1/contact-messages/token); een bericht binnen Contact:MinSeconds (standaard 3 s) na dat token geldt als spam. Het token is geldig Contact:TokenLifetimeMinutes (standaard 120). Het token is een met ASP.NET Data Protection versleutelde tijdstempel, gebonden aan de SiteId; er wordt niets over bewaard. Services/ContactTokenService.cs, Config/ContactOptions.cs
Captcha (optioneel) Friendly Captcha v2, aan met Contact:Captcha:Enabled. De server stuurt alleen het captcha-antwoord en de site key naar de verificatie-URL (global.frcapi.com of, met Contact:Captcha:Region=eu, eu.frcapi.com), met de API-sleutel in een header; het IP-adres van de bezoeker en de berichtinhoud worden door de server niet meegestuurd. Ontbreekt het captcha-antwoord terwijl het captcha aan staat, dan geldt het bericht als spam. Bereikt de server de aanbieder niet (time-out, netwerkfout, 5xx, eigen verkeerde sleutel), dan wordt de bezoeker doorgelaten. Services/FriendlyCaptchaVerifier.cs, Config/ContactOptions.cs
Spam wordt stil afgehandeld Echt, spam en herhaling krijgen dezelfde 202; spam wordt 30 dagen bewaard (zie hoofdstuk 3) en niet gemaild. Services/ContactSubmissionService.cs
Maximale grootte verzoek Contact:MaxBodyBytes (standaard 16384), anders 413. Controllers/ContactRouteFilter.cs

Captcha en privacy: de widget in de browser van de bezoeker praat rechtstreeks met Friendly Captcha. Volgens de aantekening in de handoff-notitie (verwijzend naar de verklaringen van de aanbieder, niet door ons geverifieerd) kan bij regio global het IP-adres buiten de EU worden verwerkt en blijft het bij regio eu (betaald plan) binnen de EU; de privacyverklaring moet de aanbieder en de gebruikte regio noemen (aidlc-docs/features/contact-forms-module/construction/phase-1-handoff.md). De widget zelf zit in de website, niet in deze repository: niet geverifieerd.

6. E-mailmeldingen

Feit Bron
Voor elk echt bericht (niet voor spam) wordt een melding gemaild naar één ontvangstadres. Dat is het door een beheerder ingestelde adres (admin, Berichten), anders Contact:RecipientEmail (omgevingsvariabele Contact__RecipientEmail), anders niets. Zonder geldig adres of zonder werkende mailconfiguratie wordt niet gemaild; het bericht blijft bewaard en toont de reden. Services/ContactSettingsAndGates.cs, Services/ContactMailSender.cs
De mail bevat naam, e-mailadres, onderwerp en bericht van de bezoeker. Het adres van de bezoeker staat als Reply-To (en de naam, als die geldig is als weergavenaam). In het mailonderwerp en andere headers staat niets dat de bezoeker typte. Services/ContactMailSender.cs
Verzending gebeurt op de achtergrond (ContactMailService): direct na opslaan en daarnaast elke 120 s (Contact:Mail:SweepSeconds). Bij een fout nieuwe pogingen na 5 min, 15 min, 1 u, 6 u en 24 u (Contact:Mail:BackoffMinutes), maximaal 6 pogingen (Contact:Mail:MaxAttempts); daarna blijft het mislukt tot een beheerder het opnieuw verstuurt (maximaal 5 per 10 minuten). Alleen berichten met status Nieuw worden automatisch gemaild. Config/ContactOptions.cs, Services/ContactMailService.cs, Controllers/ContactAdminControllers.cs
De mail gaat via de SMTP-instellingen van de host (Email__Smtp__*). Wat de mailserver en de mailbox van de ontvanger zelf bewaren valt buiten de applicatie: niet geverifieerd. README.md (E-mail), Services/ContactMailSender.cs

7. Logs en foutrapportage (Sentry)

Feit Bron
De contactmodule logt geen persoonsgegevens: bij een verzending alleen Contact submission handled: {Outcome} for site {SiteId} (uitkomst Genuine, Spam, SpamNotStored of Replay). De mailservice logt het bericht-id en een foutcode; fouten alleen met het exceptietype. Ook de Idempotency-Key en het token worden niet gelogd. Een test controleert dit met herkenbare markeringen in alle velden. Services/ContactSubmissionService.cs, Services/ContactMailSender.cs, Services/ContactMailService.cs, SlpModularCms.Modules.Contact.Tests/ContactNoPersonalDataInLogsTests.cs
Het beheer logt alleen id's en uitkomsten (Contact message {id} set to ..., deleted, resent). Services/ContactAdminService.cs
Sentry staat alleen aan als Observability:SentryDsn is gevuld (omgevingsvariabele Observability__SentryDsn); leeg = geen Sentry. SlpModularCms.Core/Hosting/Observability/SentryExtensions.cs
Naar Sentry gaan gebeurtenissen vanaf niveau Warning; berichten vanaf Information gaan als breadcrumbs mee. SendDefaultPii staat aan: bij een gebeurtenis gaan het IP-adres, de user agent, de querystring, het pad en de ingelogde gebruikersnaam mee. Observability/SentryExtensions.cs, Observability/SentryEventScrubber.cs (opmerking "retained")
Vóór verzending worden de headers Cookie, Set-Cookie, Authorization en X-Master-Api-Key verwijderd en de request-body wordt nooit meegestuurd (MaxRequestBodySize = None, daarnaast request.Data = null). De inhoud van het formulier komt daardoor niet via het verzoek in Sentry. De scrub-lijst is bewust niet configureerbaar. Observability/SentryEventScrubber.cs, Observability/SentryExtensions.cs
Sentry kan dus het IP-adres van een bezoeker bevatten als er tijdens zijn verzoek een fout (Warning of hoger) optreedt. Het Sentry-project en de bewaartermijn daar zijn instellingen buiten de repository: niet geverifieerd. idem
Logs van de reverse proxy / IIS / systemd-journal (bijv. IP-adressen in toegangslogs) vallen buiten de applicatie: niet geverifieerd. n.v.t.

8. Wie heeft toegang

Wie Toegang Bron
Bezoeker Kan alleen een token ophalen en een bericht versturen; kan niets uitlezen. Controllers/ContactMessagesController.cs
Beheerders in het CMS Lijst, detail (naam, e-mail, onderwerp, bericht, mailstatus, bewaren-tot), status wijzigen, verwijderen, opnieuw mailen, ontvangstadres en schakelaar instellen. Beleid AdminOnly: rol Administrator of hoger (Owner is hoger). Het ontvangstadres uit de omgeving wordt nooit aan de beheer-UI getoond, alleen de bron (setting/config). Controllers/ContactAdminControllers.cs, SlpModularCms.Core/Hosting/ServiceCollectionExtensions.cs (AdminOnly), SlpModularCms.Core/Identity/Authorization/HierarchicalRoleHandler.cs, Models/ContactAdminModels.cs
Ontvanger van de meldingsmail Ziet de inhoud in zijn mailbox (zie hoofdstuk 6). Services/ContactMailSender.cs
Wie toegang heeft tot de database of host Alles in dit document; niet af te dwingen vanuit de code. n.v.t.

Niet geverifieerd (buiten de code)

  • Of Contact__Enabled en het captcha op de testhosts of productie werkelijk aan staan.
  • Retentie van back-ups en de inhoud van het back-upscript op de host.
  • Mailserver, mailbox van de ontvanger, reverse proxy- en toegangslogs.
  • Het Sentry-account (project, bewaartermijn, wie toegang heeft).
  • De website zelf: de widget (captcha), het formulier en de tekst die bezoekers zien staan niet in deze repository.
  • Of de bijbehorende frontend in frontend/src (beheer, Berichten) aanvullende gegevens toont of opslaat; alleen de API is hierboven nagelopen.