Flask
TrustCaptcha – Protection anti-bots

Intégration CAPTCHA Flask

Intégrez TrustCaptcha dans une vue Flask avec quelques lignes de Python. Stoppez le spam automatisé sur les connexions, inscriptions et formulaires de contact — et réutilisez la vérification entre plusieurs vues avec un petit décorateur @verify_trust_captcha. Hébergé dans l’UE, conforme RGPD et sans énigmes visuelles.

Démarrage rapide

Comment fonctionne l'intégration

1. Créer un CAPTCHA

Créez un compte utilisateur ou connectez-vous avec un compte existant. Ensuite, créez un nouveau CAPTCHA ou sélectionnez-en un existant. Si vous ne savez pas encore si TrustCaptcha vous convient, essayez notre service CAPTCHA sans risque pendant 14 jours gratuitement.

Sur la page d’aperçu du CAPTCHA, vous trouverez toutes les informations importantes, comme la clé de site et la clé de licence, et vous pouvez aussi y créer votre API key. Autorisez simplement vos sites web à utiliser votre CAPTCHA en les ajoutant à la liste des domaines autorisés dans les règles de sécurité du CAPTCHA.

Début du formulaire de création du CAPTCHA.
Règles de sécurité CAPTCHA d’un CAPTCHA de démonstration.

2. Ajouter le widget CAPTCHA dans votre template Jinja

Placez le widget TrustCaptcha dans le template Jinja rendu par votre vue Flask. Le widget s’exécute en arrière-plan et ajoute un champ caché tc-verification-token lors de l’envoi, qui arrive sur request.form comme tout autre input.

templates/contact.html
HTML
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>

<form method="post" action="{{ url_for('submit') }}">
    <input type="email" name="email" required>
    <trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
    <button type="submit">Send</button>
</form>

Le widget CAPTCHA s’affichera ensuite dans votre formulaire :

CAPTCHA terminé

Besoin d’informations détaillées sur l’intégration du widget CAPTCHA ?
Pour la référence complète du widget — y compris thèmes, langues, design personnalisé et plus encore — veuillez consulter notre documentation.

Lire la documentation

3. Valider le jeton dans votre vue Flask

Dans votre vue Flask, récupérez le jeton de vérification depuis request.form, consultez le résultat via notre bibliothèque Python et décidez si la requête doit être acceptée.

Commencez par installer notre bibliothèque Python TrustCaptcha :

Install
bash
pip install "trustcaptcha>=3.0.0,<4.0.0"

Validez ensuite le jeton dans votre vue Flask et agissez en fonction du résultat :

app.py
Python
from flask import Flask, request, render_template, redirect, url_for
from trustcaptcha.trust_captcha import TrustCaptcha

app = Flask(__name__)

@app.post("/contact")
def submit():
    token = request.form.get("tc-verification-token", "")

    try:
        trust_captcha = TrustCaptcha("<your_api_key>")
        result = trust_captcha.get_verification_result(token)
    except Exception:
        return render_template("contact.html", error="CAPTCHA verification failed."), 400

    if not result.verification_passed or result.score > 0.5:
        return render_template("contact.html", error="CAPTCHA verification failed."), 400

    # CAPTCHA validé — traiter la requête
    return redirect(url_for("contact_success"))

Besoin d’informations détaillées sur l’intégration CAPTCHA Flask ?
Pour des instructions détaillées étape par étape — y compris un décorateur @verify_trust_captcha réutilisable — veuillez consulter notre documentation.

Lire la documentation

Un autre framework backend que Flask ?
Si vous utilisez un autre framework, choisissez la recette correspondante ici. Si votre framework n’est pas listé, vos développeurs peuvent intégrer la vérification eux-mêmes à l’aide de notre documentation ou contacter notre équipe support pour demander une intégration préconstruite.

Actix Web
ASP.NET Core
Axum
Django
Echo
Express
FastAPI
Fastify
Fiber
Flask
Gin
Hapi
Laravel
Micronaut
NestJS
Next.js
Quarkus
Ruby on Rails
Sinatra
Spring Boot
Symfony

4. Félicitations 🎉

Vous êtes maintenant protégé par TrustCaptcha — félicitations !

CAPTCHA terminé

FAQs

Où dans une application Flask a lieu la vérification CAPTCHA ?
Dans la fonction de vue qui traite la soumission du formulaire, avant d’enregistrer des données ou d’envoyer un e-mail. Le jeton CAPTCHA arrive comme un champ de formulaire classique sur request.form (nom par défaut : « tc-verification-token »).
Puis-je exécuter la vérification CAPTCHA en tant que décorateur Flask ?
Oui — et c’est la solution la plus propre dès que vous protégez plusieurs vues. Créez un petit décorateur @verify_trust_captcha qui lit le jeton depuis request.form, appelle notre bibliothèque Python et abandonne avec 400 en cas d’échec. Vous l’ajoutez ensuite à n’importe quelle vue avec une seule ligne.
Comment partager le SDK à travers mon application Flask ?
Créez une instance TrustCaptcha unique au démarrage et stockez-la sur app.extensions["trust_captcha"]. N’importe quelle vue ou décorateur peut la lire via current_app.extensions["trust_captcha"] sans réinitialiser la bibliothèque à chaque requête.
TrustCaptcha fonctionne-t-il avec les blueprints Flask ?
Oui. La vérification n’a rien de spécifique aux blueprints — enregistrez le décorateur (ou l’appel au niveau de la vue) dans n’importe quel blueprint et protégez une seule vue, toutes les vues d’un blueprint ou un préfixe d’URL particulier.
Où conserver la clé d’API CAPTCHA ?
Dans une variable d’environnement (par exemple TRUSTCAPTCHA_API_KEY), chargée via os.environ au démarrage. Ne committez jamais la clé dans votre dépôt et ne la codez pas en dur dans une vue.
Vous perdez des prospects à cause des CAPTCHAs ?

TrustCaptcha bloque le spam et les bots, pas vos clients. Sans puzzle, conforme au RGPD, hébergé en UE.

Début du CAPTCHA
CAPTCHA terminé
UX sans énigmes
Fonctionne en arrière-plan pendant que les visiteurs saisissent leurs informations — ainsi davantage de personnes terminent vos formulaires et moins abandonnent.
Compatible RGPD
Hébergé dans l’UE et conçu dans une logique privacy-first : pas de cookies, transmission chiffrée, nettoyage automatique — avec des ressources juridiques prêtes à l’emploi.
Sécurité multicouche
Une protection adaptative et un scoring de risque intelligent stoppent les abus très tôt — même en cas de pic d’attaques.
Contrôle total
Ajustez la sensibilité, définissez des listes d’autorisation/refus et utilisez le géoblocage — c’est vous qui décidez du niveau de strictesse de la vérification.

Protégez votre application Flask avec TrustCaptcha en quelques étapes !

  • Hébergé en UE & conforme RGPD
  • Aucun puzzle
  • Essai gratuit de 14 jours