Konfiguracja hCaptcha

hCaptcha chroni publiczną rejestrację uczestników przed botami i spamem.

Włączenie

Ustawienia → Bezpieczeństwo → "Wymuś hCaptcha na publicznej rejestracji". Wymaga konfiguracji platformowej (admin-side):

• HCAPTCHA_ENABLED=1 w env
• HCAPTCHA_SITEKEY=<sitekey> w env
• HCAPTCHA_SECRET=<secret> w env

Setup hCaptcha

1. Załóż konto na hcaptcha.com (free tier ~1M requests/msc).
2. Dodaj site - skopiuj sitekey i secret.
3. Wklej w env aplikacji.
4. Restart workers.

Co użytkownik widzi

Na form rejestracji - widget hCaptcha (challenge). Po sukcesie token w POST. Backend weryfikuje token przez hCaptcha API.

Failure mode

Jeśli token nieważny lub brak - form pokazuje "Weryfikacja CAPTCHA nie powiodła się. Spróbuj ponownie."

Alternative: Cloudflare Turnstile

Mamy planowane wsparcie - obecnie tylko hCaptcha. Turnstile dostępne po dodaniu wrappera.

Dev mode

HCAPTCHA_ENABLED=0 - verify_token() zwraca True bez wywołania API. Pozwala na local development.