TrustComponent
Go
TrustCaptcha · Protection anti-bots

Intégration CAPTCHA Go

Ajoutez un CAPTCHA Go à votre backend en quelques minutes : placez le widget dans vos formulaires, vérifiez les requêtes dans votre API Go et agissez selon le score de bot. Vous bloquez les abus sur les inscriptions, formulaires de contact et paiements sans puzzle. Hébergé dans l'UE et conforme au RGPD.

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 choisissez-en un existant. Si vous voulez d’abord essayer TrustCaptcha, chaque offre commence par un essai gratuit de 14 jours.

La page d’aperçu du CAPTCHA affiche votre site key et votre license key, et c’est là que vous créez votre API key. Ajoutez les domaines de votre site aux domaines autorisés dans les règles de sécurité du CAPTCHA pour qu’ils puissent utiliser votre CAPTCHA.

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

2. Intégrer le widget CAPTCHA dans votre frontend

Intégrez le widget CAPTCHA dans votre site web ou votre application. Le guide du widget CAPTCHA de notre documentation contient les instructions pas à pas.

Lire la documentation

Le widget CAPTCHA s’affichera ensuite sur votre site web ou votre application :

Début du CAPTCHA

Intégrations frontend préconstruites
Nos intégrations frontend préconstruites ajoutent le widget CAPTCHA à votre site web ou à votre application. S’il n’en existe pas encore pour votre technologie frontend, vos développeurs peuvent intégrer le widget eux-mêmes à l’aide de notre documentation ou demander à notre équipe support une intégration préconstruite.

Angular
Contact Form 7
Craft CMS
JavaScript
Joomla
JTL-Shop
Keycloak
Magento 2
React
Shopware 6
Svelte
TYPO3
Vue
Webflow
WordPress

3. Valider le résultat CAPTCHA dans votre backend

Les étapes suivantes montrent comment un backend Go récupère le résultat de vérification CAPTCHA sur notre serveur et décide de la suite. Les instructions complètes se trouvent dans le guide d’intégration CAPTCHA pour Go de notre documentation.

Lire la documentation

Installez d’abord notre module Go TrustCaptcha :

Installer
bash
go get github.com/trustcomponent/trustcaptcha-go/v3

Récupérez le résultat de vérification sur notre serveur avec le jeton de vérification et votre API key :

Récupérer le résultat
Go
// Récupération du résultat de vérification
verificationResult, err := trustcaptcha.GetVerificationResult("<your_api_key>", "<verification_token_from_your_client>")
if err != nil {
  // La récupération du résultat de vérification a échoué - gérer l’erreur
  return
}

En fonction du résultat de vérification et de vos besoins, décidez de la suite :

Traiter le résultat
Go
// Agir en fonction du résultat de vérification
if !verificationResult.VerificationPassed || verificationResult.Score > 0.5 {
  // La vérification a échoué ou le bot score est > 0.5 – requête automatisée possible
}

Besoin d’informations détaillées sur l’intégration CAPTCHA Go ?
Notre guide d’intégration CAPTCHA Go contient les instructions détaillées, et notre dépôt CAPTCHA Samples sur GitHub un exemple d’intégration complet.

Une autre technologie backend que Go ?
Si votre serveur n’utilise pas Go, ou si vous avez plusieurs backends, choisissez une autre intégration ici. S’il n’existe pas encore d’intégration préconstruite pour votre technologie backend, vos développeurs peuvent intégrer la vérification eux-mêmes à l’aide de notre documentation ou demander à notre équipe support une intégration préconstruite.

.NET
Go
Groovy
Java
Kotlin
Node.js
PHP
Python
Ruby
Rust
Scala

4. Testez votre intégration

TrustCaptcha est maintenant actif. Envoyez une requête de test et vérifiez qu’elle passe.

CAPTCHA terminé

Questions fréquentes

Comment fonctionne une vérification CAPTCHA en Go ?
Un CAPTCHA Go est une vérification que votre backend effectue avant de traiter une requête. Le widget dans le navigateur résout une tâche de proof-of-work en arrière-plan, envoie des signaux pour l'évaluation du risque et ajoute un jeton de vérification au formulaire. Votre handler Go transmet ce jeton et votre clé API à trustcaptcha.GetVerificationResult et obtient un résultat réussi ou échoué, avec un score de bot de 0 (très probablement humain) à 1 (très probablement un bot). Vous choisissez le seuil, et le trafic de bots sur les inscriptions, les commentaires ou le checkout est arrêté là où il arrive.
Puis-je partager un client TrustCaptcha entre plusieurs goroutines ?
Oui. Pour des paramètres personnalisés, créez un client une fois au démarrage avec trustcaptcha.New(apiKey, options) : l'instance est immuable et sûre en accès concurrent, chaque handler et chaque goroutine peut donc la réutiliser. Elle utilise net/http de Go avec des délais par défaut de 3 secondes pour la connexion et de 5 secondes pour la lecture, que vous pouvez modifier dans les options. Avec les valeurs par défaut, la fonction GetVerificationResult du package suffit.
Le module CAPTCHA Golang fonctionne-t-il avec Gin, Echo et Fiber ?
Oui. Le module n'a besoin que du jeton de vérification de la requête, il fonctionne donc dans de simples handlers net/http comme dans n'importe quel routeur ou framework. Lisez le champ tc-verification-token dans votre handler, récupérez le résultat et renvoyez une erreur si la vérification échoue. Nos guides pour Gin, Echo et Fiber montrent le code pour chaque framework.
Comment mon handler Go doit-il réagir aux erreurs ?
GetVerificationResult renvoie des erreurs typées comme VerificationTokenInvalidError, VerificationResultExpiredError ou VerificationResultRetrievalLimitReachedError : traitez-les comme une vérification échouée. ServerUnreachableError signifie que votre serveur n'a pas pu joindre notre API du tout, et notre documentation suggère d'accepter la requête et de consigner l'incident. ClientReportedServerUnreachableError signifie que le widget a signalé une panne que votre serveur ne peut pas confirmer : rejetez la requête ou demandez une vérification supplémentaire.
TrustCaptcha est-il conforme au RGPD ?
TrustCaptcha est conçu pour une utilisation conforme au RGPD : les données sont traitées et stockées exclusivement dans l'UE sur une infrastructure certifiée ISO 27001, aucun cookie n'est déposé, et vous pouvez signer l'accord de traitement des données (DPA) en ligne. La conformité de votre utilisation dépend aussi de votre intégration et de votre politique de confidentialité. Ceci n'est pas un conseil juridique ; voyez les détails avec votre délégué à la protection des données (DPO).
Puis-je personnaliser l'apparence de TrustCaptcha dans Go ?
Oui, et rien de cela ne touche votre backend Go, car l'apparence se règle sur le widget dans votre frontend. Vous disposez de 37+ langues prêtes à l'emploi, pouvez ajouter n'importe quelle autre langue et remplacer chaque texte du widget, et choisissez un thème clair ou sombre ou le réglage système. À partir de l'offre Team, vous ajustez les couleurs, les bordures et l'arrondi des coins. Un widget sans notre marque ou un widget entièrement invisible relève de l'option payante Captcha Branding.
Comment TrustCaptcha reste-t-il accessible tout en bloquant les bots ?
Il n'y a ni puzzle d'images ni défi audio : le widget exécute une preuve de travail en arrière-plan et le score de bot évalue la requête. Le widget est livré avec des libellés ARIA et des textes pour lecteurs d'écran, et il est conçu pour respecter les normes WCAG et la loi européenne sur l'accessibilité (European Accessibility Act). Les bots paient en temps de calcul, car la preuve de travail se durcit avec le risque, et les requêtes risquées peuvent en plus échouer à votre seuil de score de bot.
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é
Aucun puzzle pour vos visiteurs
La vérification tourne en arrière-plan pendant la saisie. Davantage de visiteurs vont au bout de vos formulaires au lieu d'abandonner.
Conforme au RGPD
Hébergé dans l'UE, sans cookies, avec transmission chiffrée et suppression automatique des données. Chaque client reçoit un accord de traitement des données (DPA).
Sécurité multicouche
Le proof-of-work adaptatif et le scoring de risque stoppent les abus tôt, même lors d'un pic d'attaques.
Contrôle total
Réglez la sensibilité, gérez des listes d'autorisation et de blocage et utilisez le géoblocage. Vous décidez du niveau d'exigence de la vérification.

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

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