TrustCaptcha · Bot-Schutz

Groovy CAPTCHA-Integration

Schütze die Formulare und Logins deiner Groovy-Anwendung mit einem Groovy-CAPTCHA. TrustCaptcha prüft jede Anfrage, und du entscheidest, was du zulässt, blockierst oder zur Prüfung markierst. In der EU gehostet und DSGVO-konform, ganz 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 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 Groovy-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 Groovy unserer Dokumentation.

Dokumentation lesen

Binde zunächst unsere TrustCaptcha-Abhängigkeit für Groovy ein:

Maven Central

XML

<dependency>
  <groupId>com.trustcomponent</groupId>
  <artifactId>trustcaptcha</artifactId>
  <version>3.0.0</version>
</dependency>

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

Fetch Result

Groovy

// Verifikationsergebnis abrufen
VerificationResult verificationResult
try {
  verificationResult = TrustCaptcha.getVerificationResult("<your_api_key>", "<verification_token_from_your_client>")
} catch (CaptchaFailureException e) {
  // Abruf des Verifikationsergebnisses fehlgeschlagen – Fehler behandeln
}

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

Handle Result

Groovy

// Auf das Verifikationsergebnis reagieren
if (!verificationResult.isVerificationPassed() || verificationResult.getScore() > 0.5) {
  // Verifizierung fehlgeschlagen oder Bot-Score > 0,5 – mögliche automatisierte Anfrage
}

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

Andere Backend-Technologie statt Groovy?
Wenn auf deinem Server nicht Groovy 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 Groovy-CAPTCHA-Check?

Ein Groovy-CAPTCHA ist eine Prüfung, die dein Backend ausführt, bevor es eine Anfrage verarbeitet. Im Browser löst das Widget eine kurze Proof-of-Work-Aufgabe, sendet Signale für die Risikobewertung und hängt einen Verifikationstoken an das Formular. Dein Groovy-Backend übergibt diesen Token mit deinem API-Key an TrustCaptcha.getVerificationResult und erfährt, ob die Prüfung bestanden wurde, dazu einen Bot-Score. So stoppst du Credential Stuffing, Spam und Scraping, bevor dein Code die Anfrage verarbeitet, und echte Besucher sehen kein Rätsel.

Kann ich es in Grails, Micronaut oder Spring Boot nutzen?

Ja. Es ist eine einfache JVM-Bibliothek von Maven Central (com.trustcomponent:trustcaptcha) und funktioniert daher in Grails-Controllern, Micronaut- und Spring-Boot-Apps und in einfachem Groovy-Code, mit Gradle oder Maven. Rufe sie in der Controller-Action oder dem Service auf, der das Formular verarbeitet, bevor du etwas speicherst. Für Micronaut und Spring Boot haben wir eigene Anleitungen.

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

Nicht im Quellcode. Lies ihn aus einer Umgebungsvariable oder der Konfiguration deines Frameworks, zum Beispiel application.yml in Grails oder Micronaut mit dem Wert aus der Umgebung, und halte den echten Key in deinem Secret Store. Brauchst du einen eigenen API-Host, andere Timeouts oder einen Proxy, baust du beim Start eine Instanz mit TrustCaptcha.builder(apiKey). Sie ist unveränderlich und threadsicher.

Welche Exceptions sollte ich abfangen?

Alle Exceptions erben von CaptchaFailureException, ein catch-Block deckt also eine nicht bestandene Prüfung ab. Willst du Ausfälle gesondert behandeln, fängst du die beiden Failover-Exceptions vorher ab. 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. 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 für EU-Deployments?

TrustCaptcha verarbeitet und speichert alle Daten ausschließlich in der EU auf ISO-27001-zertifizierter Infrastruktur, es gehen also keine Daten in die USA. Es setzt keine Cookies, und den Auftragsverarbeitungsvertrag (AVV) schließt du online ab. Ob dein Deployment konform ist, hängt auch von deiner Einrichtung ab; dies ist keine Rechtsberatung, kläre die Details also mit deinem Datenschutzbeauftragten.

Kann ich das Aussehen von TrustCaptcha anpassen?

Ja. Das Widget bringt 37+ Sprachen sofort einsatzbereit mit, du kannst jede weitere Sprache ergänzen und jeden Text überschreiben, und es gibt ein helles und ein dunkles Theme oder die Systemeinstellung. Ab dem Tarif Team änderst du Farben, Rahmen und Eckenradius passend zu deiner Groovy- oder Grails-Oberfläche. Unser Branding entfernen oder das Widget komplett unsichtbar machen kannst du mit dem kostenpflichtigen Add-on Captcha Branding.

Wie hält TrustCaptcha Bots fern, ohne die Nutzererfahrung zu verschlechtern?

Das Widget erledigt ein Proof-of-Work im Hintergrund, und der Bot-Score bewertet jede Anfrage anhand vieler Signale. Wirkt eine Anfrage riskant, wird das Proof-of-Work schwerer und die Anfrage kann an deinem Schwellenwert scheitern, während normale Besucher nie ein Rätsel sehen. Weil Angreifer für jeden Versuch mit Rechenzeit zahlen, werden großangelegte Angriffe teuer.

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

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

Loslegen Vertrieb kontaktieren