Files

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 (NullCaptchaVerifier while off), token response only announces a complete setup, missing/empty captchaToken while on = spam (202).
  • OpenAPI: descriptions for token and submit operations regenerated.
  • ASF host: ProjectReference + Contact config 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-src CSP 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. Also sitekey_invalid is HTTP 400 (not 401/403).

Follow-up (owner decisions)

  • frame-src catalogue 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 response captcha gains apiEndpoint (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).