TrustComponent
Ruby on Rails
TrustCaptcha · Bot-Schutz

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.

Start des Formulars zur Erstellung eines CAPTCHA.
CAPTCHA-Sicherheitsregeln eines Demo-CAPTCHAs.

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.

app/views/contacts/new.html.erb
HTML
<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:

CAPTCHA-Widget vor dem Start

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:

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

Validiere dann den Token in deinem Rails-Controller und reagiere auf das Ergebnis:

app/controllers/contacts_controller.rb
Ruby
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
end

Detaillierte 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.

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. Integration testen

TrustCaptcha ist jetzt aktiv. Schick eine Testanfrage ab und prüfe, ob sie durchgeht.

CAPTCHA abgeschlossen

Häufige Fragen

Wo gehört die Ruby on Rails CAPTCHA-Prüfung hin?
In der Controller-Action, die das abgeschickte Formular empfängt, bevor du das Modell speicherst oder die E-Mail versendest. Der CAPTCHA-Token kommt als regulärer Form-Parameter auf params an (Standardname: "tc-verification-token").
Kann ich die Verifizierung als before_action-Callback laufen lassen?
Ja, und das ist die sauberste Lösung, sobald du mehr als eine Action schützt. Definiere eine private verify_trust_captcha-Methode im ApplicationController (oder in einem Concern), die unser Ruby-Gem aufruft und bei Fehler head :bad_request nutzt. Hänge sie dann in jedem Controller mit before_action :verify_trust_captcha, only: :create an.
Ersetzt TrustCaptcha protect_from_forgery (CSRF) von Rails?
Nein. Der CSRF-Schutz von Rails und TrustCaptcha sind unabhängige Schichten, und beide sollten aktiviert bleiben. Der CAPTCHA-Token bestätigt nur, dass ein Mensch das Formular ausgefüllt hat. Vor Cross-Site Request Forgery schützt er nicht.
Muss ich das Token-Feld in den Strong Params freigeben (permit)?
Nein. Der CAPTCHA-Token wird direkt aus params gelesen (params['tc-verification-token']), nicht über den Strong-Params-Hash des Modells. Deine bestehende model_params-Methode bleibt unverändert.
Wo speichere ich den CAPTCHA-API-Key in einer Rails-App?
Nutze Rails Encrypted Credentials (rails credentials:edit) und lies den Key mit Rails.application.credentials.trustcaptcha[:api_key]. Baue eine einzige TrustCaptcha-Instanz einmalig in config/initializers/trustcaptcha.rb, um sie über alle Requests hinweg wiederzuverwenden.
Leads verlieren wegen CAPTCHAs?

TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.

CAPTCHA-Start
CAPTCHA abgeschlossen
Keine Rätsel für Besucher
Die Prüfung läuft im Hintergrund, während Besucher tippen. So schicken mehr Menschen deine Formulare ab, statt vorher aufzugeben.
DSGVO-konform
In der EU gehostet, ohne Cookies, mit verschlüsselter Übertragung und automatischer Löschung. Jeder Kunde bekommt einen Auftragsverarbeitungsvertrag (AVV).
Mehrstufige Sicherheit
Adaptiver Proof-of-Work und Risiko-Scoring stoppen Missbrauch früh, auch wenn der Angriffs-Traffic plötzlich steigt.
Volle Kontrolle
Stell die Empfindlichkeit ein, pflege Allow- und Blocklisten und nutze Geoblocking. Du entscheidest, wie streng die Prüfung ist.

Schütze deine Ruby on Rails-Anwendung in wenigen Schritten mit TrustCaptcha!

  • EU-hosted & DSGVO-konform
  • Keine Rätsel
  • 14 Tage kostenlos testen