TrustCaptcha – Protection anti-bots

Intégration CAPTCHA Echo

Intégrez TrustCaptcha dans un handler Echo — ou, encore plus propre, dans un petit middleware Echo — avec quelques lignes de Go. Stoppez le spam automatisé sur les connexions, inscriptions et formulaires de contact avec une instance *TrustCaptcha partagée et concurrente. 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 formulaire

Placez le widget TrustCaptcha dans le formulaire HTML servi par votre handler Echo. Le widget s’exécute en arrière-plan et ajoute un champ caché tc-verification-token lors de l’envoi, que Echo expose via c.FormValue.

contact.html

HTML

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

<form method="post" action="/contact">
    <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 :

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 handler Echo

Dans votre handler Echo, récupérez le jeton de vérification depuis le formulaire, consultez le résultat via notre module Go et décidez si la requête doit être acceptée.

Commencez par installer notre module Go TrustCaptcha :

Install

bash

go get github.com/trustcomponent/trustcaptcha-go/v3@v3.0.0

Validez ensuite le jeton dans votre handler Echo et agissez en fonction du résultat :

main.go

package main

import (
    "net/http"
    "github.com/labstack/echo/v4"
    "github.com/trustcomponent/trustcaptcha-go/v3"
)

func main() {
    e := echo.New()

    e.POST("/contact", func(c echo.Context) error {
        token := c.FormValue("tc-verification-token")

        result, err := trustcaptcha.GetVerificationResult("<your_api_key>", token)
        if err != nil {
            return c.String(http.StatusBadRequest, "CAPTCHA verification failed.")
        }

        if !result.VerificationPassed || result.Score > 0.5 {
            return c.String(http.StatusBadRequest, "CAPTCHA verification failed.")
        }

        // CAPTCHA validé — traiter la requête
        return c.String(http.StatusOK, "Thanks!")
    })

    e.Logger.Fatal(e.Start(":8080"))
}

Besoin d’informations détaillées sur l’intégration CAPTCHA Echo ?
Pour des instructions détaillées étape par étape — y compris un middleware Echo réutilisable pour les projets avec plusieurs routes protégées — veuillez consulter notre documentation.

Lire la documentation

Un autre framework backend qu’Echo ?
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.

4. Félicitations 🎉

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

FAQs

Où dans une application Echo a lieu la vérification CAPTCHA ?

Dans le handler qui reçoit la soumission du formulaire, avant d’enregistrer des données ou d’envoyer un mail. Le jeton CAPTCHA arrive comme une valeur de formulaire classique — lisez-le avec c.FormValue("tc-verification-token").

Puis-je exécuter la vérification CAPTCHA en tant que middleware Echo ?

Oui — et c’est l’approche la plus propre dès que vous protégez plusieurs routes. Créez une closure qui prend une *TrustCaptcha et retourne une echo.MiddlewareFunc ; en cas d’échec, retournez c.String(http.StatusBadRequest, "..."). Appliquez-la par route ou à un e.Group(...) entier.

Comment partager la *TrustCaptcha entre les handlers ?

Créez-la une seule fois au démarrage et stockez-la dans une variable de niveau package (par exemple var trustCaptcha *trustcaptcha.TrustCaptcha). Le SDK est immutable et concurrent-safe, une instance suffit donc pour toute l’application.

Que se passe-t-il si mon endpoint reçoit du JSON au lieu de form data ?

Bindez le body dans une struct avec c.Bind(&body) et lisez le jeton depuis là. L’appel de vérification TrustCaptcha ne change pas — seule la manière d’obtenir le jeton change.

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.

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 Echo avec TrustCaptcha en quelques étapes !

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

Commencer Contacter l'équipe commerciale