Intégration CAPTCHA Ruby on Rails
Intégrez un CAPTCHA Ruby on Rails dans un contrôleur, ou plus proprement dans un callback before_action de l'ApplicationController, avec quelques lignes de Ruby. Il bloque le spam automatisé sur les connexions, inscriptions et formulaires de contact, sans toucher à protect_from_forgery ni aux strong params. 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 template ERB
Placez le widget TrustCaptcha dans le template ERB qui rend votre formulaire. Le widget s’exécute en arrière-plan et ajoute un champ caché tc-verification-token lors de l’envoi, qui arrive sur params comme tout autre input.
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>
<%= form_with url: contact_path, method: :post, local: true do |form| %>
<%= form.email_field :email, required: true %>
<trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
<%= form.submit "Send" %>
<% end %>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 contrôleur Rails
Dans votre contrôleur Rails, récupérez le jeton de vérification depuis params, consultez le résultat via notre gem Ruby et décidez si la requête doit être acceptée.
Commencez par installer notre gem Ruby TrustCaptcha :
gem 'trustcaptcha', '~> 3.0'Validez ensuite le jeton dans votre contrôleur Rails et agissez en fonction du résultat :
require 'trustcaptcha/trust_captcha'
class ContactsController < ApplicationController
def create
token = params['tc-verification-token'].to_s
begin
trust_captcha = TrustCaptcha.new('<your_api_key>')
result = trust_captcha.get_verification_result(token)
rescue StandardError
flash.now[:alert] = 'CAPTCHA verification failed.'
return render :new, status: :bad_request
end
if !result.verification_passed || result.score > 0.5
flash.now[:alert] = 'CAPTCHA verification failed.'
return render :new, status: :bad_request
end
# CAPTCHA validé — traiter la requête
redirect_to contact_success_path
end
endBesoin d’informations détaillées sur l’intégration CAPTCHA Ruby on Rails ?
Pour des instructions détaillées étape par étape, y compris un callback before_action réutilisable, veuillez consulter notre documentation.
Lire la documentation
Un autre framework backend que Rails ?
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
Où placer la vérification du CAPTCHA Ruby on Rails ?
Puis-je exécuter la vérification en tant que callback before_action ?
TrustCaptcha remplace-t-il protect_from_forgery (CSRF) de Rails ?
Dois-je autoriser (permit) le champ du jeton dans les strong params ?
Où dois-je stocker la clé d’API CAPTCHA dans une application Rails ?
TrustCaptcha bloque le spam et les bots, pas vos clients. Sans puzzle, conforme au RGPD, hébergé en UE.


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