From 5cd05f1655468f862750affea1e3d2517f76e026 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Sun, 15 Nov 2026 16:39:39 +0100 Subject: [PATCH] Docs: captcha-providers.md (vergelijking, beslisrij, bronnen 2026-11-15) en verwijzingen vanuit privacy- en deploy-docs Co-Authored-By: Claude Sonnet 5.5 --- docs/captcha-providers.md | 123 ++++++++++++++++++++++ docs/deploy-en-testomgevingen.md | 4 + docs/privacy-gegevens-contactformulier.md | 2 + 3 files changed, 129 insertions(+) create mode 100644 docs/captcha-providers.md diff --git a/docs/captcha-providers.md b/docs/captcha-providers.md new file mode 100644 index 0000000..59f7283 --- /dev/null +++ b/docs/captcha-providers.md @@ -0,0 +1,123 @@ +# Captcha-aanbieders voor het contactformulier + +Levend document. Laatst bijgewerkt: 2026-11-15. Bronnen zijn gecontroleerd op **2026-11-15** (zie "Bronnen"). Prijzen en limieten spreken elkaar in de bronnen vaak tegen (veel bronnen zijn concurrenten van de aanbieder over wie ze schrijven): **controleer ze bij de aanbieder zelf voordat er iets wordt afgenomen of gebouwd.** + +## Doel en uitgangspunten + +Het contactformulier van beide sites (SlpSoftware en Andrea Slop Fotografie) wordt beschermd tegen spam door de CMS-host (`SlpModularCms.Modules.Contact`). Nu: een honeypot-veld, een minimale wachttijd (`Contact:MinSeconds`), een eenmalig token (`/contact-messages/token`), idempotentie en rate limits per bezoeker. **Een captcha staat uit** (`Contact:Captcha:Enabled=false`) en is voor productie nog niet gekozen. Zie ook [privacy-gegevens-contactformulier.md](privacy-gegevens-contactformulier.md) en [deploy-en-testomgevingen.md](deploy-en-testomgevingen.md) (het captcha staat uit tot dit besluit). + +Wensen van Bryan: **gratis of goedkoop**, voor **twee websites**, liefst **geen cookiebanner** nodig (past dus slecht bij aanbieders die cookies/tracking zetten). + +## Beslisstatus + +| | | +|---|---| +| **Beslissing** | _nog niet gekozen_ | +| **Datum** | _(in te vullen door Bryan)_ | +| **Gekozen aanbieder** | _(in te vullen)_ | +| **Opmerkingen** | | + +## Wat er nu is + +- **Server (CMS):** `ICaptchaVerifier` in de Contact-module met één implementatie, `FriendlyCaptchaVerifier` (Friendly Captcha v2). Instellingen: `Contact:Captcha:Enabled`, `Provider` (nu alleen `friendlycaptcha`), `SiteKey`, `Secret` (alleen via omgeving: `Contact__Captcha__Secret`), `Region` (`global`|`eu`). Ontbreekt het antwoord terwijl het captcha aan staat, dan geldt het bericht als spam; bereikt de server de aanbieder niet, dan wordt de bezoeker doorgelaten (fail-open). +- **Contract met de site:** de site leest `{ provider, siteKey, apiEndpoint }` van de CMS-host. De **widget in de ASF-website kent alleen Friendly Captcha**; het formulier praat met de widget via `setCaptchaToken` / `onProblem` / `resetCount` (volgens de ASF-sessie). +- **CSP:** onder het `StrictSite`-beleid komen extra origins uit `SecurityHeaders:AllowedSiteScriptOrigins`, `AllowedSiteConnectOrigins` en `AllowedSiteFrameOrigins` (frame-src, bijvoorbeeld de Friendly Captcha-widget). Voor test/productie moet dat ook in de proxy (nginx) of IIS kloppen, als die eigen headers zetten. + +## Overzicht + +Bedragen zijn indicatief (zie de waarschuwing bovenaan). + +| | 1. Niets extra | 2. Altcha (zelf gehost) | 3. Cloudflare Turnstile | 4. Google reCAPTCHA | 5. hCaptcha | 6. Friendly Captcha | +|---|---|---|---|---|---|---| +| **Kosten** | € 0 | € 0 (open source, MIT); betaalde cloud/support optioneel | gratis; gratis plan met max. 20 widgets; limiet van ca. 1 miljoen verificaties/maand genoemd (bronnen verschillen) | gratis tot 10.000 beoordelingen/maand; daarboven via Google Cloud (genoemd: vast $ 8/maand tot 100.000, daarna per beoordeling) | gratis Basic-laag (genoemd tot 10.000/maand, bronnen verschillen); passieve modus pas vanaf Pro (genoemd $ 99/maand) | gratis alleen niet-commercieel (ca. 1.000 verzoeken/maand); commercieel vanaf ca. € 9/maand per domein | +| **Dataplek** | n.v.t. | **eigen host (EU/eigen keuze)**; geen derde partij | VS-bedrijf, wereldwijd netwerk | VS-bedrijf (Google) | VS-bedrijf; EU-VS Data Privacy Framework en SCC's | **EU** (Duits bedrijf); `eu`-endpoint volgens één bron alleen in een duur plan, controleer | +| **Cookies / toestemming** | geen | geen, geen fingerprinting | "grotendeels zonder cookies"; `cf_clearance` bij pre-clearance; onduidelijk voor onze configuratie | cookies/tracking; in de EU meestal toestemming nodig | cookies; kritiek over doelen in de cookieverklaring; toestemming onzeker | geen cookies | +| **Toegankelijkheid** | geen last voor bezoekers | geen puzzel; werkt op proof-of-work; WCAG 2.2 AA volgens de aanbieder | meestal onzichtbaar/eenmalige checkbox | v2 plaatjes/checkbox is lastig; v3 onzichtbaar (score) | plaatjes in de gratis laag (geen passieve modus) | onzichtbaar proof-of-work | +| **CSP-gevolgen** | geen | **geen externe hosts**: `connect-src 'self'`, mogelijk `worker-src blob:` voor de rekenwerker | `script-src` + `frame-src` `https://challenges.cloudflare.com` (en connect) | `script-src`/`frame-src` `https://www.google.com`, `https://www.gstatic.com` | `script-src`/`frame-src`/`connect-src` `https://hcaptcha.com`, `https://*.hcaptcha.com` | `frame-src`/`connect-src` `https://global.frcapi.com` of `https://eu.frcapi.com` (bestaat al in de configuratie) | +| **Serverkant** | n.v.t. | CMS geeft de challenge uit en controleert de oplossing (geen externe call) | één `siteverify`-call naar Cloudflare | één `siteverify`-call naar Google | één `siteverify`-call | één verify-call (bestaat al: `FriendlyCaptchaVerifier`) | +| **Werk om te bouwen** | geen | **middel**: challenge-endpoint + verificatie (HMAC), nonce/vervaltijd tegen hergebruik, widget-adapter, tests | klein tot middel: verifier + widget-adapter | klein tot middel: verifier + widget-adapter | klein tot middel | **geen** (werkt al); enkel plan kiezen | +| **Aanbeveling** | basis, blijft altijd aan | **eerste keus** als er een captcha nodig is en niets bij derden mag landen | goede gratis tweede keus als een VS-partij en een extern script acceptabel zijn | **afgeraden** vanwege toestemming en tracking | minst aangeraden | goede keuze als de kosten (ca. € 9/maand per domein, dus voor twee sites ca. € 18) acceptabel zijn | + +## Per aanbieder + +### 1. Niets extra (huidige bescherming) + +Honeypot, wachttijd, eenmalig token, idempotentiesleutel en rate limits per bezoeker (met `ForwardedHeaders:KnownProxies` correct gezet; zonder dat deelt de hele site één emmer). Geen kosten, geen privacygevolgen, geen werk. Beperking: geen bescherming tegen een gerichte bot die de wachttijd en het token respecteert en per bezoeker onder de rate limit blijft. **Is een volwaardige keuze zolang er in de praktijk weinig spam binnenkomt.** + +### 2. Altcha (zelf gehost proof-of-work) + +- **Kosten:** open source (MIT), gratis. De aanbieder verkoopt daarnaast een cloud/professioneel plan; bronnen noemen uiteenlopende bedragen (€ 9 voor 100.000 verificaties tegenover € 99 voor een ander pakket): niet nodig voor zelf hosten. +- **Data en privacy:** niets verlaat onze host; geen derde partij, geen cookies, geen fingerprinting (volgens de aanbieder en directories). +- **Toegankelijkheid:** geen puzzel; de browser rekent een korte proof-of-work uit. Aanbieder claimt WCAG 2.2 AA. +- **CSP:** geen externe origins. De widget laadt als script van de eigen host (of is meegebouwd); de verificatie gaat naar `'self'`. De rekenwerker kan `worker-src blob:` vragen. +- **Server:** de CMS-host geeft de challenge uit (met HMAC-sleutel in de omgeving) en controleert de oplossing zelf. Vraagt een nieuw endpoint, tijdsvenster, bescherming tegen hergebruik (nonce opslaan of kort token) en rate limit op de challenge. +- **Werk:** middel (ca. 1,5-2 dagen: server, adapter in de widget, CSP, tests, privacytekst). +- **Beperking:** proof-of-work vertraagt bots maar herkent ze niet; geen risicoscore of dashboard in de gratis versie. + +### 3. Cloudflare Turnstile + +- **Kosten:** gratis plan (maximaal 20 widgets; een limiet van ca. 1 miljoen verificaties per maand wordt genoemd, bronnen verschillen). Enterprise op aanvraag. +- **Data/cookies:** VS-bedrijf; "grotendeels zonder cookies", maar met pre-clearance kan `cf_clearance` worden gezet; Cloudflare verwijst voor details naar een privacy-addendum (niet door ons gelezen). +- **Toegankelijkheid:** meestal onzichtbaar, soms een enkele klik. +- **CSP:** extern script en frame van `https://challenges.cloudflare.com`. +- **Server:** één `siteverify`-call naar Cloudflare met het geheim in de omgeving. +- **Werk:** ca. ½-1 dag per site voor verifier + adapter in de widget (plus eenmalig de provider-neutrale widget, zie hieronder). +- **Let op:** extern script van een VS-bedrijf; in de privacytekst noemen. + +### 4. Google reCAPTCHA (nieuw toegevoegd aan de vergelijking) + +- **Kosten:** gratis tot 10.000 beoordelingen per maand per organisatie (over alle sites samen); boven die grens via Google Cloud met facturering (volgens de documentatie een vast bedrag tot 100.000 en daarna per beoordeling). De datum waarop de gratis grens van 1 miljoen naar 10.000 ging verschilt per bron (2024, 2025 of 2026): controleren bij Google. +- **Data/cookies:** VS-bedrijf; cookies en tracking; in de EU is meestal toestemming nodig. **Dat past slecht bij de keuze "geen cookiebanner".** +- **Versies:** v2 (checkbox, soms plaatjes: lastiger voor bezoekers) of v3 (onzichtbaar, score; vraagt een drempelwaarde en afhandeling van lage scores). +- **CSP:** scripts en frames van `https://www.google.com` en `https://www.gstatic.com`. +- **Server:** één `siteverify`-call (of de Enterprise-API). +- **Werk:** ½-1 dag. +- **Aanbeveling:** niet kiezen tenzij er een bijzondere reden is. + +### 5. hCaptcha + +- **Kosten:** gratis Basic-laag (bronnen noemen 10.000/maand of "onbeperkt"; de aanbieder zegt zelf niet wat er daarboven gebeurt); alleen zichtbare puzzels in de gratis laag, passieve modus pas vanaf Pro (genoemd $ 99/maand). +- **Data/cookies:** VS-bedrijf (EU-VS Data Privacy Framework, SCC's); cookies; kritiek in bronnen (meestal concurrenten) over doelen in het cookiebeleid; toestemming onzeker. +- **CSP:** `https://hcaptcha.com` en `https://*.hcaptcha.com` (script, frame, connect). +- **Server:** één `siteverify`-call. +- **Werk:** ½-1 dag. +- **Aanbeveling:** minst aangeraden voor onze wensen (puzzels voor bezoekers, cookies). + +### 6. Friendly Captcha (nu de enige ondersteunde aanbieder in de widget) + +- **Kosten:** het gratis plan is niet-commercieel en beperkt (genoemd 1.000 verzoeken per maand); commercieel gebruik vanaf ca. € 9/maand per domein (Starter); grotere plannen volgen (genoemd € 39 en € 200). Eén bron zegt dat er helemaal geen gratis plan is: controleer. **Voor twee sites: ca. € 18/maand.** Een proefperiode van 30 dagen wordt genoemd. +- **Data/cookies:** EU-bedrijf; geen cookies. Het `global`-endpoint kan IP-adressen buiten de EU verwerken; een `eu`-endpoint (`Contact:Captcha:Region=eu`) wordt volgens één bron alleen in een duur plan geleverd: controleer de dataplek vóór de privacytekst wordt vastgesteld. +- **Toegankelijkheid:** onzichtbaar proof-of-work. +- **CSP:** `frame-src`/`connect-src` voor `https://global.frcapi.com` of `https://eu.frcapi.com`. +- **Server:** gebouwd en getest (`FriendlyCaptchaVerifier`, fail-open bij een storing van de aanbieder). +- **Werk:** geen, enkel het plan en de sleutels. + +## Werk voor een andere aanbieder dan Friendly Captcha + +Volgens de ASF-sessie (website) en de code van de CMS-host: + +| Onderdeel | Werk | +|---|---| +| Widget in de website | De widget kent alleen Friendly Captcha. Provider-neutraal maken (formulier praat al via `setCaptchaToken` / `onProblem` / `resetCount`) is ca. **1 dag** (eenmalig). Daarna per aanbieder een adapter van ca. **½-1 dag**. | +| Contract `{ provider, siteKey, apiEndpoint }` | Bestaat al en kan een andere `provider` melden. | +| CMS-host (server) | `ICaptchaVerifier` bestaat; per aanbieder een implementatie (Turnstile/reCAPTCHA/hCaptcha: ½-1 dag, Altcha: ca. 1,5-2 dagen), `Contact:Captcha:Provider` accepteert nu alleen `friendlycaptcha` (validatie uitbreiden), kiezen op basis van `Provider`, opties en tests. | +| CSP per aanbieder | `AllowedSiteScriptOrigins` / `AllowedSiteConnectOrigins` / `AllowedSiteFrameOrigins` in de CMS-host **en** de CSP van de proxy (nginx op de testhost) of IIS (productie); één bron van waarheid per site. | +| Privacytekst | Per aanbieder aanpassen (wie verwerkt, waar, welke cookies); zie [privacy-gegevens-contactformulier.md](privacy-gegevens-contactformulier.md). | +| Productie-instellingen | Sleutels en geheimen alleen via omgevingsvariabelen; `Contact:Captcha:Enabled=true` pas na besluit; test eerst op de testhosts. | + +## Bronnen (gecontroleerd op 2026-11-15) + +Dit zijn zoekresultaten en samenvattingen; niet alle pagina's van de aanbieders zelf konden worden gelezen. Bedragen en limieten vóór afname bij de aanbieder verifiëren. + +- Altcha: [open source captcha](https://altcha.org/open-source-captcha/), [open source versus betaald](https://altcha.org/docs/open-source-vs-paid/), [cloud-prijzen](https://altcha.org/docs/v2/cloud/pricing). Vergelijking van een concurrent: [captcha.eu](https://www.captcha.eu/altcha-vs-captchaeu/). De prijzen in bronnen verschillen (€ 9 en € 99). +- Cloudflare Turnstile: [plannen](https://developers.cloudflare.com/turnstile/plans), [documentatie (volledige tekst)](https://developers.cloudflare.com/turnstile/llms-full.txt); derden: [Prosopo](https://prosopo.io/tools/cloudflare-turnstile-pricing/), [captcha.eu](https://www.captcha.eu/?p=3564), [Piano](https://docs.piano.io/en/subscriptions/cloudflare-turnstile). Genoemde limieten (20 widgets, 1 miljoen) verschillen per bron. +- Google reCAPTCHA: [facturering](https://docs.cloud.google.com/recaptcha/docs/billing-information), [lagen vergelijken](https://docs.cloud.google.com/recaptcha/docs/compare-tiers); derden over de datum van de wijziging: [phpcaptcha.org](https://www.phpcaptcha.org/recaptcha-pricing), [Prosopo](https://prosopo.io/tools/recaptcha-pricing-calculator/). +- hCaptcha: [Prosopo-vergelijking](https://prosopo.io/blog/procaptcha-vs-hcaptcha-comparison/), [phpcaptcha.org](https://www.phpcaptcha.org/hcaptcha-review), [splitforms](https://splitforms.com/blog/hcaptcha-pricing-free-plan-limits); privacykritiek van concurrenten: [captcha.eu](https://www.captcha.eu/?p=3413), [Friendly Captcha](https://friendlycaptcha.com/insights/hcaptcha-gdpr/). +- Friendly Captcha: [llms.txt van de aanbieder](https://friendlycaptcha.com/llms.txt), [Capterra](https://www.capterra.com/p/10034125/Friendly-Captcha/), [TrustComponent-vergelijking](https://www.trustcomponent.com/en/products/captcha/comparison/friendly-captcha-vs-trustcaptcha), [DreamHost](https://www.dreamhost.com/blog/captcha-alternative/). +- Eerder in de repository: de aantekening over regio's en plannen in `aidlc-docs/features/contact-forms-module/construction/phase-1-handoff.md`. + +## Open vragen voor Bryan + +1. Is een captcha nodig? Zo ja, hoeveel spam komt er nu binnen (geen captcha op test; productie nog niet live)? +2. Is een extern script van een VS-aanbieder (Turnstile) acceptabel, of is "alles op onze eigen host" (Altcha) of "EU, betaald" (Friendly Captcha) de wens? +3. Welk bedrag per maand is acceptabel (twee sites)? diff --git a/docs/deploy-en-testomgevingen.md b/docs/deploy-en-testomgevingen.md index 49caa9a..602f4c4 100644 --- a/docs/deploy-en-testomgevingen.md +++ b/docs/deploy-en-testomgevingen.md @@ -102,3 +102,7 @@ Runtime-instellingen van de applicatie (verbindingsstring, JWT, mail, `Contact__ ## Runners Alle jobs draaien op het label `linux`, zodat elke runner (de Pi en de desktop-runner) ze kan oppakken. Gebouwd wordt voor `linux-arm64` (`PUBLISH_RID`), framework-dependent. Artefacten worden 1 dag bewaard. + +## Captcha + +Het captcha van het contactformulier staat uit (`Contact:Captcha:Enabled=false`) tot Bryan een aanbieder kiest. De vergelijking van de opties, de gevolgen voor CSP, privacy en werk en de beslisrij staan in [captcha-providers.md](captcha-providers.md). Zet het captcha pas aan na dat besluit, met de sleutels alleen via omgevingsvariabelen. diff --git a/docs/privacy-gegevens-contactformulier.md b/docs/privacy-gegevens-contactformulier.md index a1a0cb1..405a201 100644 --- a/docs/privacy-gegevens-contactformulier.md +++ b/docs/privacy-gegevens-contactformulier.md @@ -87,6 +87,8 @@ Bron: `Services/ContactRetentionService.cs`, `Repositories/ContactRepository.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 |