reflex-cloudflare-turnstile

A component for using Cloudflare Turnstile with Reflex. fork of masenf/reflex-google-recaptcha-v2.

Installation

pip install reflex-cloudflare-turnstile

Usage

Set your site key and secret key in your environment variables.

export TURNSTILE_SITE_KEY="your-site-key"
export TURNSTILE_SECRET_KEY="your-secret-key"

Alternatively, you can set the keys via python functions as seen in the demo app.

Place the Recaptcha component

import reflex as rx

from reflex_cloudflare_turnstile import cloudflare_turnstile

def index():
    return rx.vstack(
        ...,
        cloudflare_turnstile(),
    )

Verify the Recaptcha response

Before taking actions on the backend, you should verify that the user browser has passed validation of the token.

This value will be set for the specific tab that has completed validation and persists for the lifetime of the Reflex session (until the tab is closed).

import reflex as rx

from reflex_cloudflare_turnstile import CloudflareTurnstileState


class MyState(rx.State):
    form_error: str

    async def handle_submit(self, form_data):
        ...
        recaptcha_state = await self.get_state(CloudflareTurnstileState)
        if not recaptcha_state.token_is_valid:
            self.form_error = "Invalid recaptcha. Are you a robot?"
            return