TrustComponent
Scala
TrustCaptcha · Protection contre les bots

Intégration CAPTCHA Scala

Bloquez en quelques minutes les fausses inscriptions, les attaques par force brute sur la connexion et le spam de formulaires dans vos applications Scala grâce au CAPTCHA Scala de TrustCaptcha. Vous obtenez un verdict réussi ou échoué ainsi qu'un score de risque pour rediriger ou bloquer le trafic suspect. Respect de la vie privée, hébergement dans l'UE et conception pensée pour l'accessibilité : sans cookies et sans puzzles 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 Scala 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 Scala de notre documentation.

Lire la documentation

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

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
Scala
// Récupération du résultat de vérification
var verificationResult: VerificationResult = null
try {
  verificationResult = TrustCaptcha.getVerificationResult("<your_api_key>", "<verification_token_from_your_client>")
} catch {
  case e: CaptchaFailureException =>
    // 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
Scala
// 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 Scala ?
Notre guide d’intégration CAPTCHA Scala 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 Scala ?
Si votre serveur n’utilise pas Scala, 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 Scala ?
Un CAPTCHA Scala est une vérification que votre backend effectue avant de traiter une requête. Un bon CAPTCHA concilie protection contre les bots, confidentialité et simplicité, c'est pourquoi TrustCaptcha se passe de puzzle : le widget 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 contrôleur Scala transmet ce jeton et votre clé API à TrustCaptcha.getVerificationResult et obtient un résultat réussi ou échoué, avec un score de bot. Vous arrêtez ainsi les fausses inscriptions, le credential stuffing et le spam de formulaires avant que votre code ne touche la requête.
Puis-je l'utiliser avec Play Framework ou Akka HTTP ?
Oui. C'est une simple bibliothèque JVM disponible sur Maven Central (com.trustcomponent:trustcaptcha) : vous l'ajoutez avec sbt et l'appelez depuis un contrôleur Play, une route Akka HTTP ou tout autre service Scala. Lisez le jeton de vérification depuis le formulaire ou le corps JSON, vérifiez-le et ne traitez la requête qu'ensuite.
L'appel est bloquant. Comment l'utiliser avec des Futures ?
getVerificationResult effectue un appel HTTP bloquant avec des délais par défaut de 3 secondes pour la connexion et de 5 secondes pour la lecture. Dans du code asynchrone, exécutez-le dans un Future marqué avec scala.concurrent.blocking, ou sur un contexte d'exécution prévu pour le travail bloquant, afin de ne pas monopoliser votre dispatcher par défaut. Si vous avez besoin d'autres délais ou d'un proxy, construisez une instance au démarrage avec TrustCaptcha.builder(apiKey) : elle est immuable et thread-safe.
Comment tester mon application Scala sans résoudre le CAPTCHA ?
À partir du plan Team, vous pouvez créer des clés de contournement (bypass keys) pour les tests automatisés. Elles passent toujours le CAPTCHA avec un score de bot de 0, vos tests d'intégration et votre pipeline CI peuvent donc appeler les endpoints protégés. Dans les tests unitaires, placez l'appel TrustCaptcha derrière un petit trait à vous et remplacez-le par un stub. Gardez les clés de contournement hors de votre configuration de production.
TrustCaptcha est-il conforme au RGPD pour les projets européens ?
TrustCaptcha stocke et traite les données CAPTCHA exclusivement dans l'UE sur une infrastructure certifiée ISO 27001 et ne dépose jamais de cookies. Vous pouvez signer l'accord de traitement des données (DPA) en ligne. La conformité de votre projet dépend 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 dans mon application Scala ?
Oui. Vous choisissez un thème clair ou sombre ou le réglage système, utilisez 37+ langues prêtes à l'emploi, ajoutez n'importe quelle autre langue et remplacez chaque texte du widget. À partir de l'offre Team, vous modifiez les couleurs, les bordures et l'arrondi des coins. Un widget sans notre marque et un widget entièrement invisible relèvent de l'option payante Captcha Branding. Tout cela se règle sur le widget dans votre frontend et fonctionne donc quel que soit l'outil qui génère les pages de votre application Scala.
Comment TrustCaptcha améliore-t-il l'accessibilité par rapport aux CAPTCHA basés sur des images ?
Les CAPTCHA à images demandent de lire un texte déformé ou de cliquer sur de petites images, ce qui gêne les utilisateurs de lecteurs d'écran et de clavier. TrustCaptcha lance sa preuve de travail automatiquement dès que le visiteur interagit avec le formulaire, et il n'y a rien à résoudre. 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).
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 Scala avec TrustCaptcha en quelques étapes !

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