Bot protection (Cloudflare Turnstile)
Protecting sign-up, password reset and verification email resend with Cloudflare Turnstile — environment variables, dashboard behavior, API errors, CSP and the disabled state.
Pushizo can optionally protect three public flows that are open to abuse with Cloudflare Turnstile: sign-up, password reset requests and verification email resend. Turnstile is an invisible/non-interactive challenge; it does not show users a CAPTCHA puzzle.
Setup
- Cloudflare → Turnstile → Add site: domain (
app.pushizo.comor your own dashboard domain), widget type Managed or Invisible. - Two variables in the server environment:
| Variable | Where | Description |
|---|---|---|
TURNSTILE_SITE_KEY | API | Public site key; the dashboard reads it via GET /internal/v1/auth/config (public) and only renders the widget if the key is present |
TURNSTILE_SECRET_KEY | API | Secret key; if it is set without a site key, the configuration is rejected |
- Restart the API and the dashboard. In a Compose installation, the variables are passed to the API service through
.env.prod(installing with Compose).
Behavior
- When the secret key is set,
turnstile_tokenis required in the body of those three requests; the dashboard form adds the token it receives from the widget automatically. - The server verifies the token against the Cloudflare
siteverifyendpoint (5 s timeout).
| Condition | Response |
|---|---|
| Token missing | 400 captcha_required |
| Token invalid/expired | 400 captcha_failed (the widget is refreshed) |
| Cloudflare unreachable | 503 captcha_unavailable — fail-closed: a request that cannot be verified is not accepted |
- When the keys are empty, behavior does not change: the widget is not rendered and
turnstile_tokenis not required; local development and E2E tests run in this mode. - The dashboard CSP includes the
challenges.cloudflare.comsource forscript-src,connect-srcandframe-src; if you have your own proxy/CSP layer, allow the same source.
White-label domains
On custom dashboard domains (white-label), the Turnstile site key must also be configured in Cloudflare for that domain; otherwise the widget returns a 110200 domain error.
Related protections
Independently of Turnstile, the sign-up and login endpoints are protected by an IP-based nginx limit (auth_ip, 5 r/s) and in-app rate limiting; for login lockout, the disposable email domain block and new org limits, see the security overview.
Member provisioning with SCIM 2.0
Your identity provider (Okta, Microsoft Entra ID, OneLogin, JumpCloud…) automatically adds Pushizo members, updates their roles and removes those who leave via SCIM 2.0. SCIM is on the Enterprise plan and is used together with SSO…
White-label: branding, custom domains and reseller accounts
Offer Pushizo under your own brand: your product name, logo and colors in the dashboard and system emails; the dashboard, tracking links, preference center and status page on your own domains; sub-customer…