TrustComponent
Java
TrustCaptcha · Bot-Schutz

Java CAPTCHA-Integration

Mit einem Java-CAPTCHA prüfst du TrustCaptcha-Tokens serverseitig und stoppst Bot-Spam bei Logins, Registrierungen und Formularen. Eine kurze Schritt-für-Schritt-Anleitung mit fertigem Java-Code führt dich hin. EU-gehostet und DSGVO-konform, 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:

CAPTCHA-Widget vor dem Start

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.

Angular
Contact Form 7
Craft CMS
JavaScript
Joomla
JTL-Shop
Keycloak
Magento 2
React
Shopware 6
Svelte
TYPO3
Vue
Webflow
WordPress

3. CAPTCHA-Ergebnis in deinem Backend validieren

Die folgenden Schritte zeigen, wie dein Java-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 Java unserer Dokumentation.

Dokumentation lesen

Binde zunächst unsere TrustCaptcha-Java-Abhängigkeit 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
Java
// 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
Java
// 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 Java-CAPTCHA-Integration?
Detaillierte Anweisungen findest du in unserer Java-CAPTCHA-Integrationsanleitung, ein vollständiges Integrationsbeispiel in unserem CAPTCHA-Samples-Repository auf GitHub.

Andere Backend-Technologie statt Java?
Wenn auf deinem Server nicht Java 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.

.NET
Go
Groovy
Java
Kotlin
Node.js
PHP
Python
Ruby
Rust
Scala

4. Integration testen

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

CAPTCHA abgeschlossen

Häufige Fragen

Braucht ein Java-CAPTCHA ein Frontend-Widget?
Ja. Der Java-Teil validiert nur einen Verifikationstoken, der durch das CAPTCHA-Widget auf einer Website oder in einer App erzeugt wurde. Dein Frontend muss das Widget anzeigen, nach dem Lösen den Verifikationstoken erhalten und diesen Token an dein Java-Backend senden.
Was brauche ich in meinem Java-Backend, um einen Verifikationstoken zu validieren?
Du brauchst (1) den Verifikationstoken aus der Anfrage deines Frontends und (2) deinen API-Key (nur serverseitig). Anschließend ruft dein Backend unsere Verifizierungs-API auf (typischerweise über unsere Java-Library) und liest das Ergebnis aus.
Was enthält das Verifikationsergebnis in Java?
Das Ergebnis enthält mindestens zwei wichtige Werte: (1) verificationPassed (klar bestanden oder nicht bestanden) und (2) botScore (ein Risiko-Score von 0 = wahrscheinlich Mensch bis 1 = wahrscheinlich Bot, ab dem Tarif Solo). Du kannst beides nutzen, um zu entscheiden, wie es weitergeht.
Wie treffe ich eine Entscheidung anhand von verificationPassed und botScore?
Prüfe immer zuerst verificationPassed. Danach nutzt du botScore als Risiko-Signal. Ein häufiger Startwert ist ein Schwellenwert von 0,5, den du je nach gewünschter Strenge anpassen kannst. Du kannst auch für unterschiedliche Endpunkte unterschiedliche Schwellenwerte verwenden (zum Beispiel Login strenger als ein Newsletter-Formular).
Was kann ich tun, wenn das Ergebnis riskant wirkt, statt sofort zu blockieren?
Du kannst je nach Prozess unterschiedlich reagieren: die Anfrage blockieren, eine Fehlermeldung anzeigen, einen zusätzlichen Schritt verlangen (zum Beispiel eine zusätzliche Verifikation) oder die Anfrage annehmen, sie aber intern als potenziellen Spam markieren, um sie später zu prüfen.
Wie lange ist ein Verifikationstoken gültig, und kann ich ihn mehrfach validieren?
Standardmäßig ist ein Verifikationstoken nur einmal verwendbar und 15 Minuten gültig. Im Enterprise-Plan kannst du die Gültigkeit verlängern und eine begrenzte Zahl von Abrufen erlauben.
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 Java-Anwendung in wenigen Schritten mit TrustCaptcha!

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