TrustCaptcha · Bot-Schutz

Kotlin CAPTCHA-Integration

Schütze deine Kotlin-Anwendung mit dem Kotlin-CAPTCHA von TrustCaptcha: Verifiziere CAPTCHA-Ergebnisse in wenigen Minuten auf deinem Server und halte Spam von APIs und Kontaktformularen fern. Du erhältst einen Verifizierungsstatus und einen Bot-Score, um Anfragen zuzulassen, zu blockieren oder zur Prüfung zu markieren. 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 Kotlin-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 Kotlin unserer Dokumentation.

Dokumentation lesen

Binde zunächst unsere TrustCaptcha-Kotlin-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

Kotlin

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

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

Handle Result

Kotlin

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

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

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

Ein Kotlin-CAPTCHA ist eine Prüfung, die dein Backend ausführt, bevor es eine Anfrage verarbeitet. Im Client startet das TrustCaptcha-Widget von selbst, löst eine Proof-of-Work-Aufgabe, deren Schwierigkeit mit dem Risiko wächst, und hängt einen Verifikationstoken an das Formular. Dein Kotlin-Backend holt das Ergebnis zu diesem Token mit TrustCaptcha.getVerificationResult und deinem API-Key ab und reagiert darauf, ob die Prüfung bestanden wurde und wie hoch der Bot-Score ist. Damit lassen sich Bots erkennen, bevor sie Spam, Credential Stuffing oder Carding in deine Formulare und APIs tragen, und das ohne Rätsel.

Kann ich es aus Coroutines aufrufen?

Ja. Die Bibliothek macht einen blockierenden HTTP-Aufruf mit Standard-Timeouts von 3 Sekunden für den Verbindungsaufbau und 5 Sekunden fürs Lesen. In einer Coroutine packst du ihn deshalb in withContext(Dispatchers.IO). Brauchst du andere Timeouts, einen Proxy oder einen anderen API-Host, baust du beim Start eine Instanz mit TrustCaptcha.builder(apiKey). Sie ist unveränderlich und threadsicher, alle Anfragen können sie also teilen.

Funktioniert es mit Spring Boot, Ktor und Micronaut?

Ja. Es ist eine einfache JVM-Bibliothek von Maven Central (com.trustcomponent:trustcaptcha) und passt daher zu Spring-Boot-Controllern, Ktor-Routen, Micronaut und jedem anderen Kotlin-Stack, mit Gradle oder Maven. Lies den Verifikationstoken in deiner Route oder deinem Controller aus der Anfrage und prüfe ihn, bevor du das Formular verarbeitest. Für Spring Boot und Micronaut haben wir eigene Anleitungen.

Wie teste ich meine Kotlin-Endpunkte, ohne das CAPTCHA zu lösen?

Ab dem Team-Plan erstellst du Bypass-Keys für automatisierte Tests. Sie bestehen das CAPTCHA immer mit einem Bot-Score von 0, deine Integrationstests und deine CI-Pipeline können also geschützte Endpunkte aufrufen. In Unit-Tests legst du den TrustCaptcha-Aufruf hinter ein kleines eigenes Interface und mockst es. Bypass-Keys gehören nicht in deine Produktionskonfiguration.

Ist TrustCaptcha DSGVO-konform?

TrustCaptcha verarbeitet alle Daten in der EU auf ISO-27001-zertifizierter Infrastruktur und setzt nie Cookies. Den Auftragsverarbeitungsvertrag (AVV) schließt du online ab. Ob dein Einsatz konform ist, hängt auch von deiner Einbindung und deiner Datenschutzerklärung ab; dies ist keine Rechtsberatung, kläre die Details also mit deinem Datenschutzbeauftragten.

Kann ich das Erscheinungsbild von TrustCaptcha vollständig anpassen?

Weitgehend ja. Das Widget bringt 37+ Sprachen sofort einsatzbereit mit, du kannst jede weitere Sprache ergänzen und jeden Text überschreiben, und du wählst hell, dunkel oder die Systemeinstellung des Besuchers. Ab dem Team-Plan passt du Farben, Rahmen und Eckenradius an. Ein Widget ohne unser Branding und ein komplett unsichtbares Widget gibt es mit dem kostenpflichtigen Add-on Captcha Branding.

Wird TrustCaptcha meine Kotlin-Anwendung verlangsamen?

Dein Backend macht pro abgesendetem Formular einen API-Aufruf, um das Verifikationsergebnis abzurufen, der Mehraufwand für deinen Kotlin-Service ist also gering. Das Proof-of-Work läuft im Browser des Besuchers, während er das Formular ausfüllt, und wird nur schwerer, wenn eine Anfrage riskant wirkt. Es gibt keine Bilderrätsel, die geladen oder durchgeklickt werden müssen.

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

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

Loslegen Vertrieb kontaktieren