Ruby on Rails CAPTCHA Integration
Add a Ruby on Rails CAPTCHA to a controller, or more cleanly to a before_action callback in ApplicationController, in a few lines of Ruby. It stops bot spam on logins, sign-ups and contact forms and leaves protect_from_forgery and strong params untouched. 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.


2. Add the CAPTCHA widget to your ERB template
Drop the TrustCaptcha widget into the ERB template that renders your form. 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.
<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 %>The CAPTCHA widget will then be displayed inside your form:

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 Rails controller
In your Rails controller, 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:
gem 'trustcaptcha', '~> 3.0'Then validate the token inside your Rails controller and act on the result:
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 passed — process the request
redirect_to contact_success_path
end
endNeed detailed information about the Ruby on Rails CAPTCHA integration?
For full step-by-step instructions, including a reusable before_action callback, please read our documentation.
Read the documentation
Other backend framework instead of Rails?
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.
4. Test your integration
TrustCaptcha is now active. Send a test request and check that it goes through.

FAQs
Where does the Ruby on Rails CAPTCHA verification go?
Can I run the verification as a before_action callback?
Does TrustCaptcha replace Rails' protect_from_forgery (CSRF)?
Do I need to permit the token field in strong params?
Where should I store the CAPTCHA API key in a Rails app?
TrustCaptcha blocks spam and bots, not customers. No puzzles, GDPR-compliant, EU-hosted.


Protect your Ruby on Rails application with TrustCaptcha in just a few steps!
- EU-hosted & GDPR-compliant
- No puzzles
- Try free for 14 days