TrustCaptcha · Bot-Schutz

Scala CAPTCHA-Integration

Stoppe Fake-Registrierungen, Brute-Force-Logins und Formularspam in deinen Scala-Apps in wenigen Minuten mit dem Scala-CAPTCHA von TrustCaptcha. Du erhältst ein Bestanden oder Nicht bestanden plus einen Risiko-Score, um verdächtigen Traffic gezielt umzuleiten oder zu blockieren. Datenschutzorientiert, in der EU gehostet und für Barrierefreiheit entwickelt: ohne Cookies 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 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 Scala-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 Scala unserer Dokumentation.

Dokumentation lesen

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

Scala

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

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

Handle Result

Scala

// 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 Scala-CAPTCHA-Integration?
Detaillierte Anweisungen findest du in unserer Scala-CAPTCHA-Integrationsanleitung, ein vollständiges Integrationsbeispiel in unserem CAPTCHA-Samples-Repository auf GitHub.

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

Ein Scala-CAPTCHA ist eine Prüfung, die dein Backend ausführt, bevor es eine Anfrage verarbeitet. Ein gutes CAPTCHA verbindet Bot-Schutz, Datenschutz und einfache Bedienung, deshalb kommt TrustCaptcha ohne Rätsel aus: Das Widget löst im Hintergrund eine Proof-of-Work-Aufgabe, sendet Signale für die Risikobewertung und hängt einen Verifikationstoken an das Formular. Dein Scala-Controller übergibt diesen Token mit deinem API-Key an TrustCaptcha.getVerificationResult und erhält bestanden oder nicht bestanden, dazu einen Bot-Score. So stoppst du Fake-Registrierungen, Credential Stuffing und Formular-Spam, bevor dein Code die Anfrage anfasst.

Kann ich es mit dem Play Framework oder Akka HTTP nutzen?

Ja. Es ist eine einfache JVM-Bibliothek von Maven Central (com.trustcomponent:trustcaptcha). Du bindest sie mit sbt ein und rufst sie aus einem Play-Controller, einer Akka-HTTP-Route oder jedem anderen Scala-Service auf. Lies den Verifikationstoken aus dem Formular oder dem JSON-Body, prüfe ihn und verarbeite erst dann die Anfrage.

Der Aufruf blockiert. Wie nutze ich ihn mit Futures?

getVerificationResult macht einen blockierenden HTTP-Aufruf mit Standard-Timeouts von 3 Sekunden für den Verbindungsaufbau und 5 Sekunden fürs Lesen. In asynchronem Code führst du ihn in einem Future aus, das mit scala.concurrent.blocking markiert ist, oder auf einem Execution Context für blockierende Arbeit, damit er deinen Standard-Dispatcher nicht belegt. Brauchst du andere Timeouts oder einen Proxy, baust du beim Start eine Instanz mit TrustCaptcha.builder(apiKey). Sie ist unveränderlich und threadsicher.

Wie teste ich meine Scala-App, 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 einen kleinen eigenen Trait und stubbst ihn. Bypass-Keys gehören nicht in deine Produktionskonfiguration.

Ist TrustCaptcha DSGVO-konform für EU-Projekte?

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

Kann ich das Aussehen von TrustCaptcha in meiner Scala-App anpassen?

Ja. Du wählst ein helles oder dunkles Theme oder die 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. Ein Widget ohne unser Branding und ein komplett unsichtbares Widget sind das kostenpflichtige Add-on Captcha Branding. All das stellst du am Widget im Frontend ein, es funktioniert also mit allem, was die Seiten deiner Scala-App ausliefert.

Wie verbessert TrustCaptcha die Barrierefreiheit gegenüber bildbasierten CAPTCHAs?

Bild-CAPTCHAs verlangen, verzerrten Text zu lesen oder kleine Bilder anzuklicken, und das ist eine Hürde für Screenreader- und Tastaturnutzer. TrustCaptcha startet sein Proof-of-Work automatisch, sobald der Besucher mit dem Formular interagiert, und es gibt nichts zu lösen. Das Widget bringt ARIA-Labels und Screenreader-Texte mit und ist darauf ausgelegt, die WCAG-Standards und den European Accessibility Act zu erfüllen.

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

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

Loslegen Vertrieb kontaktieren