Intégration CAPTCHA Quarkus
Intégrez un CAPTCHA Quarkus dans une resource JAX-RS avec quelques lignes de Java. Il bloque le spam automatisé sur les connexions, inscriptions et formulaires de contact, fonctionne en native image et s'appuie sur MicroProfile Config et Hibernate Validator. 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.


2. Ajouter le widget CAPTCHA dans votre formulaire
Placez le widget TrustCaptcha dans le formulaire HTML servi par votre resource Quarkus. Le widget s’exécute en arrière-plan et ajoute un champ caché tc-verification-token lors de l’envoi, que Quarkus expose à votre méthode @POST via @FormParam.
<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 ?
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 resource Quarkus
Dans votre resource Quarkus, 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 :
<dependency>
<groupId>com.trustcomponent</groupId>
<artifactId>trustcaptcha</artifactId>
<version>3.0.0</version>
</dependency>Validez ensuite le jeton dans votre resource JAX-RS et agissez en fonction du résultat :
@Path("/contact")
public class ContactResource {
@POST
public Response submit(@FormParam("tc-verification-token") String token) {
VerificationResult result;
try {
result = TrustCaptcha.getVerificationResult("<your_api_key>", token);
} catch (CaptchaFailureException e) {
return Response.status(400).entity("CAPTCHA verification failed.").build();
}
if (!result.isVerificationPassed() || result.getScore() > 0.5) {
return Response.status(400).entity("CAPTCHA verification failed.").build();
}
// CAPTCHA validé — traiter la requête
return Response.ok("Thanks!").build();
}
}Besoin d’informations détaillées sur l’intégration CAPTCHA Quarkus ?
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 Quarkus ?
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. Testez votre intégration
TrustCaptcha est maintenant actif. Envoyez une requête de test et vérifiez qu’elle passe.

Questions fréquentes
Le CAPTCHA Quarkus fonctionne-t-il avec quarkus-rest et l'ancien RESTEasy Classic ?
Comment lire le jeton CAPTCHA dans une resource JAX-RS ?
Puis-je brancher la vérification CAPTCHA dans Hibernate Validator (@Valid) ?
Où dois-je placer la clé d’API CAPTCHA dans une application Quarkus ?
TrustCaptcha fonctionne-t-il dans une native image Quarkus (GraalVM) ?
Et pour les endpoints réactifs qui retournent Uni ou Multi ?
TrustCaptcha bloque le spam et les bots, pas vos clients. Sans puzzle, conforme au RGPD, hébergé en UE.


Protégez votre application Quarkus avec TrustCaptcha en quelques étapes !
- Hébergé en UE & conforme RGPD
- Aucun puzzle
- Essai gratuit de 14 jours