Ruby on Rails CAPTCHA-Integration
Binde ein Ruby on Rails CAPTCHA mit wenigen Zeilen Ruby in einen Controller ein oder, noch sauberer, in einen before_action-Callback im ApplicationController. Es stoppt Bot-Spam bei Logins, Registrierungen und Kontaktformularen, und protect_from_forgery sowie Strong Params bleiben unangetastet. EU-gehostet, DSGVO-konform und ohne Bilderrätsel.
Schnellstart
So funktioniert die Integration
1. CAPTCHA erstellen
Erstelle ein Benutzerkonto oder melde dich mit einem bestehenden Konto an. Dann erstellst du ein neues CAPTCHA oder wählst ein vorhandenes aus. Wenn du TrustCaptcha erst ausprobieren willst: Jeder Tarif startet mit einer 14-tägigen kostenlosen Testphase.
Auf der Übersichtsseite des CAPTCHAs findest du den Site Key und den License Key, und dort erstellst du auch deinen API-Key. Trage die Domains deiner Website in den Sicherheitsregeln des CAPTCHAs als autorisierte Domains ein, damit sie dein CAPTCHA nutzen dürfen.


2. CAPTCHA-Widget in dein ERB-Template einbauen
Binde das TrustCaptcha-Widget in das ERB-Template ein, das dein Formular rendert. Das Widget läuft im Hintergrund und fügt beim Absenden ein verstecktes Feld tc-verification-token hinzu, das auf params ankommt wie jeder andere 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 %>Das CAPTCHA-Widget wird anschließend in deinem Formular angezeigt:

Detaillierte Informationen zur CAPTCHA-Widget-Integration?
Die vollständige Widget-Referenz mit Themes, Sprachen, eigenem Design und mehr findest du in unserer Dokumentation.
Dokumentation lesen
3. Token in deinem Rails-Controller validieren
Hole in deinem Rails-Controller den Verifikationstoken aus params, rufe das Ergebnis über unser Ruby-Gem ab und entscheide, ob die Anfrage akzeptiert werden soll.
Installiere zunächst unser TrustCaptcha-Ruby-Gem:
gem 'trustcaptcha', '~> 3.0'Validiere dann den Token in deinem Rails-Controller und reagiere auf das Ergebnis:
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 bestanden — Anfrage verarbeiten
redirect_to contact_success_path
end
endDetaillierte Informationen zur Ruby-on-Rails-CAPTCHA-Integration?
Die vollständige Schritt-für-Schritt-Anleitung inklusive eines wiederverwendbaren before_action-Callbacks findest du in unserer Dokumentation.
Dokumentation lesen
Anderes Backend-Framework statt Rails?
Wenn du ein anderes Framework nutzt, wähle hier das passende Rezept aus. Ist dein Framework nicht aufgeführt, können deine Softwareentwickler die Verifizierung mithilfe unserer Dokumentation selbst integrieren oder unser Support-Team nach einer vorgefertigten Integration fragen.
4. Integration testen
TrustCaptcha ist jetzt aktiv. Schick eine Testanfrage ab und prüfe, ob sie durchgeht.

Häufige Fragen
Wo gehört die Ruby on Rails CAPTCHA-Prüfung hin?
Kann ich die Verifizierung als before_action-Callback laufen lassen?
Ersetzt TrustCaptcha protect_from_forgery (CSRF) von Rails?
Muss ich das Token-Feld in den Strong Params freigeben (permit)?
Wo speichere ich den CAPTCHA-API-Key in einer Rails-App?
TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.


Schütze deine Ruby on Rails-Anwendung in wenigen Schritten mit TrustCaptcha!
- EU-hosted & DSGVO-konform
- Keine Rätsel
- 14 Tage kostenlos testen