TrustComponent
Sinatra
TrustCaptcha · Bot-Schutz

Sinatra CAPTCHA-Integration

Binde ein Sinatra-CAPTCHA mit wenigen Zeilen Ruby in eine Route ein. Es stoppt Bot-Spam bei Logins, Registrierungen und Kontaktformularen, und mit einem kleinen Helper plus Before-Filter nutzt du die Prüfung in mehreren Routen. 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-Formular ein, das deine Sinatra-Route ausliefert. 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.

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>

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 deiner Sinatra-Route validieren

Hole in deiner Sinatra-Route 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 'sinatra'
gem 'trustcaptcha', '~> 3.0'

Validiere dann den Token in deiner Sinatra-Route und reagiere auf das Ergebnis:

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 bestanden — Anfrage verarbeiten
  'Thanks!'
end

Detaillierte Informationen zur Sinatra-CAPTCHA-Integration?
Die vollständige Schritt-für-Schritt-Anleitung inklusive eines wiederverwendbaren Helpers plus Before-Filter findest du in unserer Dokumentation.

Dokumentation lesen

Anderes Backend-Framework statt Sinatra?
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 Sinatra-CAPTCHA-Prüfung hin?
Im Routen-Block, der das abgeschickte Formular verarbeitet, bevor du Daten speicherst oder eine Mail versendest. Der CAPTCHA-Token kommt als regulärer Form-Parameter an. Du liest ihn mit params['tc-verification-token'].
Kann ich die Verifizierung über mehrere Routen hinweg laufen lassen?
Ja. Definiere einen Sinatra-Helper (z. B. verify_trust_captcha!) in einem helpers-do-Block, der unser Ruby-Gem aufruft und bei einem Fehler halt 400, '...' nutzt. Hänge ihn dann mit before '/contact' do verify_trust_captcha! end an die Routen, die du schützen willst.
Läuft Sinatras Before-Filter sowohl bei GET als auch bei POST?
Ja. before '/contact' greift bei jedem HTTP-Verb auf diesem Pfad. Liefert derselbe Pfad auch ein GET zur Anzeige des Formulars, würde dieser GET blockiert, weil noch kein Token vorhanden ist. Sichere den Helper deshalb mit return unless request.post? ab.
Wie teile ich das SDK über die Routen hinweg?
Erzeuge beim Start eine einzige TrustCaptcha-Instanz (z. B. TRUST_CAPTCHA = TrustCaptcha.new(ENV.fetch('TRUSTCAPTCHA_API_KEY'))) und greife aus deinem Helper darauf zu. Die SDK-Instanz ist unveränderlich, eine gemeinsame Instanz reicht also.
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 Sinatra-Anwendung in wenigen Schritten mit TrustCaptcha!

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