TrustComponent
Sinatra
TrustCaptcha · Bot protection

Sinatra CAPTCHA Integration

Add a Sinatra CAPTCHA to a route in a few lines of Ruby. It stops bot spam on logins, sign-ups and contact forms, and a small helper plus a before filter reuses the check across routes. EU-hosted, GDPR-compliant, no image puzzles.

Quickstart

How the integration works

1. Create a CAPTCHA

Create a user account or log in with an existing one. Then create a new CAPTCHA or pick an existing one. If you want to try TrustCaptcha first, every plan comes with a 14-day free trial.

The CAPTCHA overview page shows your site key and license key, and you create your API key there. Add your website’s domains to the authorized domains in the CAPTCHA security rules so they can use your CAPTCHA.

Start of the CAPTCHA creation form.
CAPTCHA security rules of a demo CAPTCHA.

2. Add the CAPTCHA widget to your ERB template

Drop the TrustCaptcha widget into the ERB form your Sinatra route serves. The widget runs the CAPTCHA in the background and adds a hidden tc-verification-token field on submit, which arrives on params like any other 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>

The CAPTCHA widget will then be displayed inside your form:

CAPTCHA start

Need detailed information about the CAPTCHA widget integration?
Our documentation has the full widget reference, including themes, languages and custom design.

Read the documentation

3. Validate the token in your Sinatra route

In your Sinatra route, take the verification token from params, look up the result via our Ruby gem, and decide whether to accept the request.

First, install our TrustCaptcha Ruby gem:

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

Then validate the token inside your Sinatra route and act on the result:

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 passed — process the request
  'Thanks!'
end

Need detailed information about the Sinatra CAPTCHA integration?
For full step-by-step instructions, including a reusable helper plus a before filter, please read our documentation.

Read the documentation

Other backend framework instead of Sinatra?
If you use a different framework, pick the matching recipe here. If your framework isn’t listed, your software developers can integrate the verification themselves using our documentation or ask our support team for a pre-built integration.

Actix Web
ASP.NET Core
Axum
Django
Echo
Express
FastAPI
Fastify
Fiber
Flask
Gin
Hapi
Laravel
Micronaut
NestJS
Next.js
Quarkus
Ruby on Rails
Sinatra
Spring Boot
Symfony

4. Test your integration

TrustCaptcha is now active. Send a test request and check that it goes through.

CAPTCHA done

FAQs

Where does the Sinatra CAPTCHA verification go?
Inside the route block that handles the form submission, before persisting data or sending mail. The CAPTCHA token comes in as a regular form parameter: read it with params['tc-verification-token'].
Can I run the verification across multiple routes?
Yes. Define a Sinatra helper (e.g. verify_trust_captcha!) inside a helpers do block that calls our Ruby gem and uses halt 400, '...' on failure. Then attach it to the routes you want to protect via before '/contact' do verify_trust_captcha! end.
Does Sinatra's before filter run for GET as well as POST?
Yes. before '/contact' matches every HTTP verb on that path. If the same path serves a GET to render the form, guard the helper with return unless request.post? so the GET request isn't blocked because no token is present yet.
How do I share the SDK across routes?
Build a single TrustCaptcha instance once at startup (e.g. TRUST_CAPTCHA = TrustCaptcha.new(ENV.fetch('TRUSTCAPTCHA_API_KEY'))) and reach it from your helper. The SDK instance is immutable, so one shared instance is enough.
Losing leads to CAPTCHAs?

TrustCaptcha blocks spam and bots, not customers. No puzzles, GDPR-compliant, EU-hosted.

CAPTCHA start
CAPTCHA done
No puzzles for visitors
The check runs in the background while visitors type, so more people finish your forms instead of giving up.
GDPR-compliant
Hosted in the EU, no cookies, encrypted transmission and automatic data deletion. Every customer gets a Data Processing Agreement.
Multi-layer security
Adaptive proof-of-work and risk scoring stop abuse early, even when attack traffic spikes.
Full control
Set the sensitivity, keep allow and block lists and use geoblocking. You decide how strict the check is.

Protect your Sinatra application with TrustCaptcha in just a few steps!

  • EU-hosted & GDPR-compliant
  • No puzzles
  • Try free for 14 days