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
ContactDbContextgeen 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
RetentionUntilverstreken 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:Enableduit 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.
Welke aanbieder (of geen) uiteindelijk wordt gebruikt is nog niet besloten; de vergelijking en de beslisrij staan in captcha-providers.md. Deze privacytekst moet bij het besluit worden aangepast aan de gekozen aanbieder.
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__Enableden 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.