TrustComponent
Spring Boot
TrustCaptcha · Protection anti-bots

Intégration CAPTCHA Spring Boot

Intégrez un CAPTCHA Spring Boot dans un contrôleur avec quelques lignes de Java. Il bloque le spam automatisé sur les connexions, inscriptions et formulaires de contact, sans toucher à vos templates Thymeleaf, à la Bean Validation ni à Spring Security. 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 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. Ajouter le widget CAPTCHA dans votre template Thymeleaf

Placez le widget TrustCaptcha dans le formulaire Thymeleaf que vous souhaitez protéger. Dès qu’un visiteur interagit avec le formulaire, le CAPTCHA s’exécute en arrière-plan et ajoute un champ caché tc-verification-token lors de l’envoi. Spring Boot le transmet à votre contrôleur comme n’importe quel autre paramètre de formulaire.

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

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

Début du CAPTCHA

Besoin d’informations détaillées sur l’intégration du widget CAPTCHA ?
Notre documentation contient la référence complète du widget, avec les thèmes, les langues et le design personnalisé.

Lire la documentation

3. Valider le jeton dans votre contrôleur Spring Boot

Dans votre contrôleur Spring Boot, récupérez le jeton de vérification depuis le formulaire, consultez le résultat via notre bibliothèque Java et décidez si la requête doit être acceptée.

Commencez par installer notre bibliothèque Java TrustCaptcha :

pom.xml
XML
<dependency>
  <groupId>com.trustcomponent</groupId>
  <artifactId>trustcaptcha</artifactId>
  <version>3.0.0</version>
</dependency>

Validez ensuite le jeton dans votre contrôleur et agissez en fonction du résultat :

ContactController.java
Java
@PostMapping("/contact")
public String submit(@RequestParam("tc-verification-token") String token, Model model) {

  VerificationResult result;
  try {
    result = TrustCaptcha.getVerificationResult("<your_api_key>", token);
  } catch (CaptchaFailureException e) {
    return "contact"; // vérification échouée — réafficher le formulaire
  }

  if (!result.isVerificationPassed() || result.getScore() > 0.5) {
    return "contact"; // semble être un bot — bloquer
  }

  // CAPTCHA validé — traiter la requête
  return "contact-success";
}

Besoin d’informations détaillées sur l’intégration CAPTCHA Spring Boot ?
Pour des instructions détaillées étape par étape, y compris un refactor Bean Validation pour les projets avec plusieurs endpoints protégés, veuillez consulter notre documentation.

Lire la documentation

Un autre framework backend que Spring Boot ?
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. 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

Quelles versions de Spring Boot sont prises en charge ?
TrustCaptcha fonctionne avec toutes les versions modernes de Spring Boot (2.x et 3.x). La vérification est un simple appel Java dans votre contrôleur, vous n’avez donc besoin d’aucun starter Spring Boot de notre part.
Où placer la vérification du CAPTCHA Spring Boot ?
Dans la méthode du contrôleur qui reçoit la soumission du formulaire, avant d’enregistrer des données ou d’envoyer un e-mail. Le jeton CAPTCHA arrive en tant que paramètre de formulaire classique (nom par défaut : « tc-verification-token »), vous le lisez avec @RequestParam comme n’importe quel autre champ.
Puis-je utiliser TrustCaptcha avec Spring Security ?
Oui. TrustCaptcha se trouve sur la couche applicative (votre contrôleur), indépendamment de Spring Security. Il ne remplace ni l’authentification, ni l’autorisation, ni la protection CSRF. Laissez-les activées. Le CAPTCHA confirme simplement qu’un humain a effectué la requête.
Puis-je déclencher la validation CAPTCHA via la Bean Validation (@Valid) ?
Oui. Pour des projets avec plusieurs endpoints protégés, le pattern le plus propre est une annotation Bean Validation personnalisée (par exemple @TrustCaptchaToken) sur un champ DTO. En ajoutant @Valid au paramètre du contrôleur, la vérification s’exécute automatiquement dans la pipeline de validation habituelle.
TrustCaptcha fonctionne-t-il avec WebFlux / les contrôleurs réactifs ?
Oui. Le SDK Java est bloquant, encapsulez donc l’appel de vérification dans un endpoint réactif avec Mono.fromCallable(...).subscribeOn(Schedulers.boundedElastic()) pour ne pas bloquer la boucle d’événements. Du point de vue du SDK, rien ne change.
Où dois-je stocker la clé d’API CAPTCHA dans un projet Spring Boot ?
Traitez-la comme tout autre secret : placez-la dans application.yml ou application.properties sous une clé telle que trustcaptcha.api-key, et injectez-la avec @Value("${trustcaptcha.api-key}"). En production, alimentez-la depuis une variable d’environnement ou un gestionnaire de secrets, et ne la committez jamais dans votre dépôt.
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 Spring Boot avec TrustCaptcha en quelques étapes !

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