TrustCaptcha · Bot-Schutz

Ruby CAPTCHA-Integration

Integriere ein Ruby-CAPTCHA in dein Ruby- oder Rails-Backend, um Registrierungen, Logins, Kontaktformulare und Checkouts vor Bots zu schützen. Diese Anleitung zeigt dir die Einrichtung und wie du Anfragen mit unserem fertigen Ruby-Gem validierst. In der EU gehostet, DSGVO-konform und ohne Rätsel für deine Besucher.

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 Frontend integrieren

Integriere das CAPTCHA-Widget in deine Website oder App. Eine Schritt-für-Schritt-Anleitung findest du im CAPTCHA-Widget-Guide unserer Dokumentation.

Dokumentation lesen

Das CAPTCHA-Widget wird anschließend auf deiner Website oder in deiner App angezeigt:

Vorgefertigte Frontend-Integrationen
Mit unseren vorgefertigten Frontend-Integrationen baust du das CAPTCHA-Widget in deine Website oder Anwendung ein. Gibt es für deine Frontend-Technologie noch keine, können deine Entwickler das Widget mithilfe unserer Dokumentation selbst integrieren oder unser Support-Team nach einer vorgefertigten Integration fragen.

3. CAPTCHA-Ergebnis in deinem Backend validieren

Die folgenden Schritte zeigen, wie dein Ruby-Backend das CAPTCHA-Verifikationsergebnis von unserem Server abruft und anhand des Ergebnisses entscheidet, wie es weitergeht. Die vollständige Anleitung findest du in der CAPTCHA-Integrationsanleitung für Ruby unserer Dokumentation.

Dokumentation lesen

Installiere zunächst unser TrustCaptcha-Paket für Ruby:

Install

bash

gem install trustcaptcha

Rufe das Verifikationsergebnis mit dem Verifikationstoken und deinem API-Key von unserem Server ab:

Fetch Result

Ruby

# Verifikationsergebnis abrufen
begin
  trust_captcha = TrustCaptcha.new('<your_api_key>')
  verification_result = trust_captcha.get_verification_result('<verification_token_from_your_client>')
rescue StandardError => e
  # Abruf des Verifikationsergebnisses fehlgeschlagen – Fehler behandeln
end

Entscheide anhand des Verifikationsergebnisses und deiner Anforderungen, wie du weiter vorgehst:

Handle Result

Ruby

# Auf das Verifikationsergebnis reagieren
if !verification_result.verification_passed || verification_result.score > 0.5
  # Verifizierung fehlgeschlagen oder Bot-Score > 0,5 – mögliche automatisierte Anfrage
end

Benötigst du detaillierte Informationen zur Ruby-CAPTCHA-Integration?
Detaillierte Anweisungen findest du in unserer Ruby-CAPTCHA-Integrationsanleitung, ein vollständiges Integrationsbeispiel in unserem CAPTCHA-Samples-Repository auf GitHub.

Andere Backend-Technologie statt Ruby?
Wenn auf deinem Server nicht Ruby läuft oder du mehrere Backends hast, wähle hier eine andere Integration. Gibt es für deine Backend-Technologie noch keine vorgefertigte Integration, können deine Entwickler die CAPTCHA-Prüfung 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

Wie funktioniert ein Ruby-CAPTCHA-Check?

Ein Ruby-CAPTCHA ist eine Prüfung, die deine App ausführt, bevor sie ein Formular verarbeitet. Das Widget in deinem Frontend löst im Hintergrund eine Proof-of-Work-Aufgabe, während unsere Server aus den gesendeten Signalen einen Bot-Score berechnen, und hängt dann einen Verifikationstoken an dein Formular. Dein Ruby-Code erstellt mit TrustCaptcha.new(api_key) einen Client und ruft get_verification_result mit diesem Token auf. Du erfährst, ob die Verifizierung bestanden wurde, und bekommst einen Bot-Score von 0 (sehr wahrscheinlich Mensch) bis 1 (sehr wahrscheinlich Bot). So hält diese Bot-Erkennung Spam, Credential Stuffing und Scraping ohne Rätsel aus deinen Formularen heraus.

Kann ich das Gem in Rails, Sinatra oder einer einfachen Rack-App nutzen?

Ja. Das Gem trustcaptcha übernimmt nur den serverseitigen Aufruf und funktioniert daher in Rails-Controllern, Sinatra-Routen und jeder Rack-App. Lies den Token aus params['tc-verification-token'], hol das Ergebnis ab, bevor du etwas speicherst, und gib einen Fehler zurück, wenn die Prüfung fehlschlägt. Unsere Anleitungen für Rails und Sinatra zeigen den Code für jedes Framework.

Wo bewahre ich den API-Key in einer Ruby-App auf?

Nicht im Repository. In Rails legst du ihn in den verschlüsselten Credentials oder einer Umgebungsvariable ab, in Sinatra- oder Rack-Apps liest du ihn aus ENV. Dann übergibst du ihn an TrustCaptcha.new. Der Konstruktor nimmt bei Bedarf auch api_host, connect_timeout_s (standardmäßig 3 Sekunden), read_timeout_s (standardmäßig 5 Sekunden) und proxy entgegen.

Welche Exceptions wirft das Gem?

get_verification_result wirft typisierte Exceptions wie TrustCaptcha::VerificationTokenInvalidException, TrustCaptcha::VerificationResultExpiredException oder TrustCaptcha::VerificationResultRetrievalLimitReachedException. Werte sie als nicht bestandene Prüfung. TrustCaptcha::ServerUnreachableException heißt, dass dein Server unsere API gar nicht erreicht hat. Unsere Dokumentation schlägt vor, die Anfrage dann zuzulassen und den Vorfall zu protokollieren. TrustCaptcha::ClientReportedServerUnreachableException heißt, dass das Widget einen Ausfall gemeldet hat, den dein Server nicht bestätigen kann. Lehne die Anfrage dann ab oder verlange eine weitere Prüfung.

Ist TrustCaptcha DSGVO-konform?

Alle Verifikationsdaten werden ausschließlich in der EU auf ISO-27001-zertifizierter Infrastruktur verarbeitet und gespeichert, es werden keine Cookies gesetzt, und den Auftragsverarbeitungsvertrag (AVV) schließt du online ab. Ob dein Einsatz konform ist, hängt von deiner Einbindung und deiner Datenschutzerklärung ab. Dies ist keine Rechtsberatung; kläre die Details mit deinem Datenschutzbeauftragten.

Wird TrustCaptcha meine Ruby-App verlangsamen?

Das Gem sendet pro abgesendetem Formular eine HTTPS-Anfrage, um das Verifikationsergebnis abzurufen, deine Ruby-App hat also wenig zusätzliche Arbeit. Das Proof-of-Work läuft im Hintergrund im Browser des Besuchers, und es müssen keine Rätselbilder geladen werden.

Kann ich TrustCaptcha an mein Branding anpassen?

Ja. Du wechselst zwischen hellem und dunklem Theme oder folgst der Systemeinstellung, nutzt 37+ Sprachen sofort einsatzbereit, ergänzt jede weitere Sprache und überschreibst jeden Widget-Text. Ab dem Team-Plan änderst du Farben, Rahmen und Eckenradius. Unser Branding auszublenden oder das Widget komplett unsichtbar laufen zu lassen, ist das kostenpflichtige Add-on Captcha Branding.

Leads verlieren wegen CAPTCHAs?

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

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-Anwendung in wenigen Schritten mit TrustCaptcha!

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

Loslegen Vertrieb kontaktieren