TrustComponent
Ruby
TrustCaptcha · Protection contre les bots

Intégration CAPTCHA Ruby

Ajoutez un CAPTCHA Ruby à votre backend Ruby ou Rails pour protéger les inscriptions, connexions, formulaires de contact et checkouts contre les bots. Ce guide vous montre la configuration et la validation des requêtes avec notre gem Ruby prête à l'emploi. Hébergé dans l'UE, conforme au RGPD et sans puzzle pour vos visiteurs.

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

Lire la documentation

Installez d’abord notre dépendance TrustCaptcha pour Ruby :

Installer
bash
gem install trustcaptcha

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
Ruby
# Récupération du résultat de vérification
begin
  trust_captcha = TrustCaptcha.new('<your_api_key>')
  verification_result = trust_captcha.get_verification_result('<verification_token_from_your_client>')
rescue StandardError => e
  # La récupération du résultat de vérification a échoué - gérer l’erreur
end

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

Traiter le résultat
Ruby
# Agir en fonction du résultat de vérification
if !verification_result.verification_passed || verification_result.score > 0.5
  # La vérification a échoué ou le bot score est > 0.5 – requête automatisée possible
end

Besoin d’informations détaillées sur l’intégration CAPTCHA Ruby ?
Notre guide d’intégration CAPTCHA Ruby 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 Ruby ?
Si votre serveur n’utilise pas Ruby, 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 Ruby ?
Un CAPTCHA Ruby est une vérification que votre application effectue avant de traiter un formulaire. Le widget de votre frontend résout une tâche de proof-of-work en arrière-plan pendant que nos serveurs calculent un score de bot à partir des signaux envoyés, puis ajoute un jeton de vérification à votre formulaire. Votre code Ruby crée un client avec TrustCaptcha.new(api_key) et appelle get_verification_result avec ce jeton. Vous savez si la vérification a réussi et obtenez un score de bot de 0 (très probablement humain) à 1 (très probablement un bot) : cette détection des bots tient le spam, le credential stuffing et le scraping à l'écart de vos formulaires, sans puzzle.
Puis-je utiliser la gem dans Rails, Sinatra ou une simple application Rack ?
Oui. La gem trustcaptcha ne fait que l'appel côté serveur, elle fonctionne donc dans les contrôleurs Rails, les routes Sinatra et toute application Rack. Lisez le jeton depuis params['tc-verification-token'], récupérez le résultat avant d'enregistrer quoi que ce soit et renvoyez une erreur si la vérification échoue. Nos guides pour Rails et Sinatra montrent le code pour chaque framework.
Où conserver la clé API dans une application Ruby ?
Pas dans votre dépôt. Dans Rails, stockez-la dans les credentials chiffrés ou une variable d'environnement ; dans Sinatra ou Rack, lisez-la depuis ENV. Transmettez-la ensuite à TrustCaptcha.new. Le constructeur accepte aussi api_host, connect_timeout_s (3 secondes par défaut), read_timeout_s (5 secondes par défaut) et proxy si vous en avez besoin.
Quelles exceptions la gem lève-t-elle ?
get_verification_result lève des exceptions typées comme TrustCaptcha::VerificationTokenInvalidException, TrustCaptcha::VerificationResultExpiredException ou TrustCaptcha::VerificationResultRetrievalLimitReachedException : traitez-les comme une vérification échouée. TrustCaptcha::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. TrustCaptcha::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 ?
Toutes les données de vérification 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 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).
TrustCaptcha va-t-il ralentir mon application Ruby ?
La gem envoie une requête HTTPS par formulaire envoyé pour récupérer le résultat de vérification, votre application Ruby n'a donc que peu de travail en plus. La preuve de travail s'exécute en arrière-plan dans le navigateur du visiteur, et aucune image de puzzle n'est à télécharger.
Puis-je adapter le style de TrustCaptcha à mon identité de marque ?
Oui. Vous passez du thème clair au thème sombre ou suivez 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. Masquer notre marque ou rendre le widget entièrement invisible relève de l'option payante Captcha Branding.
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 Ruby avec TrustCaptcha en quelques étapes !

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