Trustcaptcha

JVM - Java / Kotlin / Groovy / Scala

Das nachfolgende Tutorial zeigt Ihnen, wie Sie Trustcaptcha in Java, Kotlin, Groovy oder Scala integrieren können.

Vorbereitung

Folgende Vorbereitungen sollten Sie treffen, bevor Sie mit der Implementierung von Trustcaptcha in Ihrem Java, Kotlin, Groovy oder Scala Backend anfangen.

Voraussetzungen

  • Ein Konto bei Trustcaptcha und ein bestehendes CAPTCHA.
  • Ein Backend, in welches Trustcaptcha integriert werden soll.

Wissen (empfohlen)

  • Basiswissen in der jeweiligen Programmiersprache.
  • Verständnis für die grundlegende Funktionsweise von Trustcaptcha sowie vom Backend-Prozess.

Abhängigkeit hinzufügen

Um die Trustcaptcha-Bibliothek verwenden zu können, müssen Sie zuerst die entsprechenden Abhängigkeiten in Ihr Projekt einfügen.

Build tools

Fügen Sie die folgende Abhängigkeit mit Hilfe eines Build-Tools Ihrer Wahl in Ihr Projekt ein.

Bibliothek verwenden

Nachstehend erfahren Sie, wie Sie die Bibliothek verwenden können.

Ergebnis abrufen

Sie können das Verifikationsergebnis mit Hilfe der Methode getVerificationResult() der Klasse CaptchaManager von unseren Servern abrufen. Dafür müssen Sie Ihren secret-key und den Verifikationstoken angeben.

Ergebnis verwenden

Wenn Sie das Verifikationsergebnis erfolgreich abgerufen haben, können Sie, basierend darauf, Ihre nächsten Schritte planen. Eine konkrete Übersicht über alle enthaltenden Informationen des Verifikationsergebnisses und deren jeweiligen Bedeutungen finden Sie in Das Backend.

Beispiel mit Spring

Das untenstehende Beispiel zeigt eine mögliche Implementierung mit dem Framework Spring Boot.
Mit einer POST-Request auf /api/example wird der Verifikationstoken innerhalb des request-body übermittelt. Anschließend wird das Ergebnis vom Server abgerufen. Sollte die Verifikation nicht bestanden worden sein oder der Bot-Score über 0.5 liegen, wird beispielhaft eine Warnung ausgegeben. Abschließend wir das gesamte Ergebnis an den Client zurück gegeben.
Mithilfe des folgenden Models wird der Verifikationstoken an den Controller übergeben.
Das gesamte Beispiel inklusive Quellcode finden Sie auf Github.