TrustCaptcha – Protection anti-bots

Intégration CAPTCHA Sinatra

Intégrez TrustCaptcha dans une route Sinatra avec quelques lignes de Ruby. Stoppez le spam automatisé sur les connexions, inscriptions et formulaires de contact — et réutilisez la vérification entre plusieurs routes avec un petit helper et un before filter. 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 sélectionnez-en un existant. Si vous ne savez pas encore si TrustCaptcha vous convient, essayez notre service CAPTCHA sans risque pendant 14 jours gratuitement.

Sur la page d’aperçu du CAPTCHA, vous trouverez toutes les informations importantes, comme la clé de site et la clé de licence, et vous pouvez aussi y créer votre API key. Autorisez simplement vos sites web à utiliser votre CAPTCHA en les ajoutant à la liste des domaines autorisés dans les règles de sécurité du 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 ERB

Placez le widget TrustCaptcha dans le formulaire ERB servi par votre route Sinatra. 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.

views/contact.erb

HTML

<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 ?
Pour la référence complète du widget — y compris thèmes, langues, design personnalisé et plus encore — veuillez consulter notre documentation.

Lire la documentation

3. Valider le jeton dans votre route Sinatra

Dans votre route Sinatra, 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 :

Gemfile

Ruby

gem 'sinatra'
gem 'trustcaptcha', '~> 3.0'

Validez ensuite le jeton dans votre route Sinatra et agissez en fonction du résultat :

app.rb

Ruby

require 'sinatra'
require 'trustcaptcha/trust_captcha'

post '/contact' do
  token = params['tc-verification-token'].to_s

  begin
    trust_captcha = TrustCaptcha.new('<your_api_key>')
    result = trust_captcha.get_verification_result(token)
  rescue StandardError
    halt 400, 'CAPTCHA verification failed.'
  end

  halt 400, 'CAPTCHA verification failed.' unless result.verification_passed && result.score <= 0.5

  # CAPTCHA validé — traiter la requête
  'Thanks!'
end

Besoin d’informations détaillées sur l’intégration CAPTCHA Sinatra ?
Pour des instructions détaillées étape par étape — y compris un helper réutilisable et un before filter — veuillez consulter notre documentation.

Lire la documentation

Un autre framework backend que Sinatra ?
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. Félicitations 🎉

Vous êtes maintenant protégé par TrustCaptcha — félicitations !

FAQs

Où dans une application Sinatra a lieu la vérification CAPTCHA ?

Dans le bloc de route qui traite la soumission du formulaire, avant d’enregistrer des données ou d’envoyer un mail. Le jeton CAPTCHA arrive comme un paramètre de formulaire classique — lisez-le avec params['tc-verification-token'].

Puis-je exécuter la vérification sur plusieurs routes ?

Oui. Définissez un helper Sinatra (par exemple verify_trust_captcha!) dans un bloc helpers do qui appelle notre gem Ruby et utilise halt 400, '...' en cas d’échec. Attachez-le ensuite aux routes que vous souhaitez protéger via before '/contact' do verify_trust_captcha! end.

Le before filter de Sinatra s’exécute-t-il aussi bien sur GET que sur POST ?

Oui. before '/contact' correspond à n’importe quel verbe HTTP sur ce chemin. Si le même chemin sert un GET pour afficher le formulaire, protégez le helper avec return unless request.post? afin que la requête GET ne soit pas bloquée alors qu’aucun jeton n’est encore présent.

Comment partager le SDK entre les routes ?

Créez une instance TrustCaptcha unique au démarrage (par exemple TRUST_CAPTCHA = TrustCaptcha.new(ENV.fetch('TRUSTCAPTCHA_API_KEY'))) et atteignez-la depuis votre helper. Le SDK est immutable, donc réutiliser une seule instance est la bonne granularité.

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.

UX sans énigmes

Fonctionne en arrière-plan pendant que les visiteurs saisissent leurs informations — ainsi davantage de personnes terminent vos formulaires et moins abandonnent.

Compatible RGPD

Hébergé dans l’UE et conçu dans une logique privacy-first : pas de cookies, transmission chiffrée, nettoyage automatique — avec des ressources juridiques prêtes à l’emploi.

Sécurité multicouche

Une protection adaptative et un scoring de risque intelligent stoppent les abus très tôt — même en cas de pic d’attaques.

Contrôle total

Ajustez la sensibilité, définissez des listes d’autorisation/refus et utilisez le géoblocage — c’est vous qui décidez du niveau de strictesse de la vérification.

Protégez votre application Sinatra avec TrustCaptcha en quelques étapes !

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

Commencer Contacter l'équipe commerciale