TrustComponent
Groovy
TrustCaptcha · Protection anti-bots

Intégration CAPTCHA Groovy

Protégez les formulaires et connexions de votre application Groovy avec un CAPTCHA Groovy. TrustCaptcha vérifie chaque requête, et vous décidez quoi autoriser, bloquer ou examiner. Hébergé dans l'UE et conforme au RGPD, sans puzzle d'images.

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 Groovy 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 Groovy de notre documentation.

Lire la documentation

Ajoutez d’abord notre dépendance TrustCaptcha pour Groovy :

Maven Central
XML
<dependency>
  <groupId>com.trustcomponent</groupId>
  <artifactId>trustcaptcha</artifactId>
  <version>3.0.0</version>
</dependency>

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
Groovy
// Récupération du résultat de vérification
VerificationResult verificationResult
try {
  verificationResult = TrustCaptcha.getVerificationResult("<your_api_key>", "<verification_token_from_your_client>")
} catch (CaptchaFailureException e) {
  // La récupération du résultat de vérification a échoué - gérer l’erreur
}

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

Traiter le résultat
Groovy
// Agir en fonction du résultat de vérification
if (!verificationResult.isVerificationPassed() || verificationResult.getScore() > 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 Groovy ?
Notre guide d’intégration CAPTCHA Groovy 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 Groovy ?
Si votre serveur n’utilise pas Groovy, 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 Groovy ?
Un CAPTCHA Groovy est une vérification que votre backend effectue avant de traiter une requête. Dans le navigateur, le widget résout une courte tâche de proof-of-work, envoie des signaux pour l'évaluation du risque et ajoute un jeton de vérification au formulaire. Votre backend Groovy transmet ce jeton et votre clé API à TrustCaptcha.getVerificationResult et apprend si la vérification humaine a réussi, avec un score de bot. Vous arrêtez ainsi le credential stuffing, le spam et le scraping avant que votre code ne traite la requête, et les vrais visiteurs ne voient aucun puzzle.
Puis-je l'utiliser avec Grails, Micronaut ou Spring Boot ?
Oui. C'est une simple bibliothèque JVM disponible sur Maven Central (com.trustcomponent:trustcaptcha) : elle fonctionne aussi bien dans des contrôleurs Grails que dans des applications Micronaut et Spring Boot ou du code Groovy simple, avec Gradle ou Maven. Appelez-la dans l'action de contrôleur ou le service qui traite le formulaire, avant d'enregistrer quoi que ce soit. Pour Micronaut et Spring Boot, nous proposons des guides dédiés.
Où conserver la clé API dans une application Groovy ?
Pas dans votre code source. Lisez-la depuis une variable d'environnement ou la configuration de votre framework, par exemple application.yml dans Grails ou Micronaut avec la valeur issue de l'environnement, et gardez la vraie clé dans votre gestionnaire de secrets. Si vous avez besoin d'un autre hôte d'API, d'autres délais ou d'un proxy, construisez une instance au démarrage avec TrustCaptcha.builder(apiKey) : elle est immuable et thread-safe.
Quelles exceptions dois-je intercepter ?
Toutes les exceptions héritent de CaptchaFailureException, un seul bloc catch couvre donc une vérification échouée. Pour traiter les pannes à part, interceptez d'abord les deux exceptions de failover. ServerUnreachableException 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. ClientReportedServerUnreachableException 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 pour les déploiements dans l'UE ?
TrustCaptcha traite et stocke toutes les données exclusivement dans l'UE sur une infrastructure certifiée ISO 27001 : aucune donnée ne part donc aux États-Unis. Il ne dépose aucun cookie, et vous pouvez signer l'accord de traitement des données (DPA) en ligne. La conformité de votre déploiement dépend aussi de votre configuration ; ceci n'est pas un conseil juridique, voyez donc les détails avec votre délégué à la protection des données (DPO).
Puis-je personnaliser l'apparence de TrustCaptcha ?
Oui. Le widget propose 37+ langues prêtes à l'emploi, vous pouvez ajouter n'importe quelle autre langue et remplacer chaque texte, et il existe en thème clair ou sombre ou suit le réglage système. À partir de l'offre Team, vous modifiez les couleurs, les bordures et l'arrondi des coins pour les adapter à votre interface Groovy ou Grails. Retirer notre marque ou masquer complètement le widget relève de l'option payante Captcha Branding.
Comment TrustCaptcha bloque-t-il les bots sans nuire à l'expérience utilisateur ?
Le widget exécute une preuve de travail en arrière-plan, et le score de bot évalue chaque requête à partir de multiples signaux. Quand une requête paraît risquée, la preuve de travail se durcit et la requête peut échouer à votre seuil, alors que les visiteurs ordinaires ne voient jamais de puzzle. Comme les attaquants paient chaque tentative en temps de calcul, les attaques à grande échelle deviennent coûteuses.
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 Groovy avec TrustCaptcha en quelques étapes !

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