2.2 KiB
2.2 KiB
CMS-U9 — Friendly Captcha v2 and the ASF host (summary)
FriendlyCaptchaVerifier(v2 siteverify, X-API-Key, fail-open rules, no secrets/tokens in logs),ContactCaptchaOptions(+ VerifyUrl, TimeoutSeconds,Problems()), start-up validation (ContactOptionsValidator, ValidateOnStart: the host refuses to start with an incomplete captcha setup), module wiring (NullCaptchaVerifierwhile off), token response only announces a complete setup, missing/emptycaptchaTokenwhile on = spam (202).- OpenAPI: descriptions for token and submit operations regenerated.
- ASF host:
ProjectReference+Contactconfig section (off), rate-limit policies, release conditions in the file and in the handoff (section 8). - Tests (new): verifier (request shape, EU URL, all answers, timeout, network error, cancellation, empty token, no secrets in logs), options validation, submission rule, pipeline with a fake provider (token response shape, spam vs genuine identical 202, missing token, fail-open 500/503/401, label with
& ' " < >, start-up refusal), mail label encoding, ASF host tests (closed by default, public routes reachable while the gate is closed, per-client vs shared bucket, committed defaults), frontend label test. - NOT included (instruction): the
frame-srcCSP catalogue change (AllowedSiteFrameOrigins), parked as a patch; see handoff section 8 for the provider's CSP requirement. - Deviation found against the plan: the v2 widget needs
frame-src(iframes); the "no frame-src" assumption was wrong. Alsositekey_invalidis HTTP 400 (not 401/403).
Follow-up (owner decisions)
frame-srccatalogue change committed:SecurityHeaders:AllowedSiteFrameOrigins(exact origins; StrictSite only; empty = byte-identical). 6 new Core tests (Core 645).- Region:
Contact:Captcha:Region=global(default) |eu; token responsecaptchagainsapiEndpoint(additive); VerifyUrl derived from the region, an explicit VerifyUrl must match it, an unknown region or a mismatch stops the host at start-up. Tests: options (default, eu, mismatches, unknown), pipeline (default global, eu, mismatch refuses to start), OpenAPI regenerated. Contact tests 313. - Privacy documented for both regions (handoff section 8).