Files
slp-modular-cms/docs/privacy-gegevens-contactformulier.md
T

130 lines
15 KiB
Markdown

# 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.
Welke aanbieder (of geen) uiteindelijk wordt gebruikt is nog niet besloten; de vergelijking en de beslisrij staan in [captcha-providers.md](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__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.