C# (C-Sharp)

Das nachfolgende Tutorial zeigt Ihnen, wie Sie Trustcaptcha in C# integrieren können.

Vorbereitung

Folgende Vorbereitungen sollten Sie treffen, bevor Sie mit der Implementierung von Trustcaptcha in Ihrem C# 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.

.NET CLI

Installieren Sie die Trustcaptcha-Bibliothek mit Hilfe von .NET CLI.

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

Das untenstehende Beispiel zeigt eine mögliche Implementierung mit C#.
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.
Das gesamte Beispiel inklusive Quellcode finden Sie auf Github.