TrustCaptcha · Bot-Schutz

.NET CAPTCHA-Integration

Richte in wenigen Minuten ein .NET-CAPTCHA ein: Du nutzt das Widget im Frontend und verifizierst den Token mit unserem .NET-Paket. Schütze Registrierungen, Logins, Kontaktformulare und Checkout-Prozesse vor Bots, ganz ohne Rätsel. EU-gehostet und DSGVO-konform.

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 .NET-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 .NET unserer Dokumentation.

Dokumentation lesen

Installiere zunächst unser TrustCaptcha-.NET-Paket:

Install

bash

dotnet add package TrustComponent.TrustCaptcha

Rufe das Verifikationsergebnis mit dem Verifikationstoken und deinem API-Key von unserem Server ab:

Fetch Result

// Verifikationsergebnis abrufen
VerificationResult verificationResult;
try
{
  verificationResult = await TrustCaptcha.GetVerificationResultAsync("<your_api_key>", "<verification_token_from_your_client>");
}
catch (Exception ex)
{
  // Abruf des Verifikationsergebnisses fehlgeschlagen – Fehler behandeln
}

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

Handle Result

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

Andere Backend-Technologie statt .NET?
Wenn auf deinem Server nicht .NET 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 die CAPTCHA-Prüfung mit C# in .NET?

Ein C#-CAPTCHA ist eine Prüfung, die dein .NET-Backend ausführt, bevor es eine Formular- oder API-Anfrage verarbeitet. Das TrustCaptcha-Widget läuft im Browser deiner Besucher, löst im Hintergrund eine Proof-of-Work-Aufgabe und hängt einen Verifikationstoken an das Formular. Dein .NET-Backend übergibt diesen Token mit deinem API-Key an TrustCaptcha.GetVerificationResultAsync und erhält zurück, ob die Verifizierung bestanden wurde, dazu einen Bot-Score von 0 (sehr wahrscheinlich Mensch) bis 1 (sehr wahrscheinlich Bot). So hältst du Spam, Credential Stuffing und Fake-Registrierungen ohne Rätsel aus deinen ASP.NET-Formularen und APIs heraus.

Sollte ich TrustCaptcha als Singleton in der Dependency Injection registrieren?

Wenn du eigene Einstellungen brauchst, ja. Mit TrustCaptcha.NewBuilder(apiKey) setzt du den API-Host, die Timeouts für Verbindung und Lesen (standardmäßig 3 und 5 Sekunden) und einen Proxy, und die gebaute Instanz ist unveränderlich und threadsicher. Baue sie einmal beim Start, registriere sie als Singleton und injiziere sie in deine Controller oder Minimal-API-Handler. Mit den Standardeinstellungen reicht der statische Aufruf GetVerificationResultAsync.

Funktioniert es mit ASP.NET Core MVC, Razor Pages und Blazor?

Ja. Das Paket übernimmt nur den serverseitigen Aufruf und passt damit in jedes .NET-Projekt, das die Formular- oder API-Anfrage entgegennimmt: MVC-Controller, Razor-Pages-Handler, Minimal APIs und das Backend einer Blazor-App. Das Widget selbst kommt in dein HTML- oder Razor-Markup. Ein vollständiges Beispiel zeigt unsere Anleitung für das ASP.NET Core CAPTCHA.

Welche Exceptions sollte mein .NET-Code behandeln?

GetVerificationResultAsync wirft typisierte Exceptions wie VerificationTokenInvalidException, VerificationResultExpiredException oder VerificationResultRetrievalLimitReachedException. Werte sie als nicht bestandene Prüfung. ServerUnreachableException heißt, dass dein Server unsere API gar nicht erreicht hat. Unsere Dokumentation schlägt vor, die Anfrage dann zuzulassen und den Vorfall zu protokollieren. ClientReportedServerUnreachableException heißt, dass das Widget einen Ausfall gemeldet hat, den dein Server nicht bestätigen kann. Lehne die Anfrage dann ab oder verlange eine weitere Prüfung.

Ist TrustCaptcha DSGVO-konform und EU-gehostet?

TrustCaptcha ist EU-gehostet: Alle CAPTCHA-Daten werden ausschließlich in der EU auf ISO-27001-zertifizierter Infrastruktur verarbeitet und gespeichert. Es setzt keine Cookies, verschlüsselt die Übertragung, und jeder Kunde erhält einen Auftragsverarbeitungsvertrag (AVV). Ob dein Einsatz DSGVO-konform ist, hängt auch davon ab, wie du TrustCaptcha einbindest. Dies ist keine Rechtsberatung; kläre die Details mit deinem Datenschutzbeauftragten.

Kann ich das Aussehen von TrustCaptcha anpassen?

Ja. Das Widget bringt 37+ Sprachen sofort einsatzbereit mit, du kannst jede weitere Sprache ergänzen und jeden Widget-Text überschreiben. Wähle ein helles oder dunkles Theme oder folge der Systemeinstellung des Besuchers; ab dem Tarif Team passt du außerdem Farben, Rahmen und Eckenradius an. Ein Widget ohne unser Branding und ein komplett unsichtbares Widget gibt es mit dem kostenpflichtigen Add-on Captcha Branding.

Beeinflusst TrustCaptcha Performance oder Barrierefreiheit?

Besucher lösen nie ein Rätsel: Das Widget startet von selbst, sobald jemand das Formular ausfüllt, und erledigt das Proof-of-Work im Hintergrund. Schwerer und langsamer wird es nur, wenn eine Anfrage riskant wirkt. Das Widget bringt ARIA-Labels und Screenreader-Texte mit und ist darauf ausgelegt, die WCAG-Standards und den European Accessibility Act zu erfüllen. Auf deinem Server ist die Validierung ein API-Aufruf pro abgesendetem Formular.

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

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

Loslegen Vertrieb kontaktieren