TrustCaptcha · Bot-Schutz

Python CAPTCHA-Integration

Binde ein Python-CAPTCHA in dein Backend ein: TrustCaptcha prüft jedes Ergebnis auf deinem Server und stoppt Bot-Registrierungen, Spam-Einsendungen und Missbrauch. Es funktioniert mit jedem unserer Frontend-Widgets, und deine Nutzer sehen nie ein 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 Python-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 Python unserer Dokumentation.

Dokumentation lesen

Installiere zunächst unser TrustCaptcha-Paket für Python:

Install

bash

pip install trustcaptcha

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

Fetch Result

Python

# Verifikationsergebnis abrufen
try:
  trust_captcha = TrustCaptcha("<your_api_key>")
  verification_result = trust_captcha.get_verification_result("<verification_token_from_your_client>")
except Exception as e:
  # Abruf des Verifikationsergebnisses fehlgeschlagen – Fehler behandeln
  pass

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

Handle Result

Python

# Auf das Verifikationsergebnis reagieren
if not verification_result.verification_passed or verification_result.score > 0.5:
  # Verifizierung fehlgeschlagen oder Bot-Score > 0,5 – mögliche automatisierte Anfrage
  pass

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

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

Brauche ich weiterhin ein Frontend (Webseite oder App), wenn ich in Python validiere?

Ja. Das CAPTCHA benötigt immer ein Frontend-Widget, das der Nutzer lösen kann. Nach dem Lösen erstellt das Widget einen Verifikationstoken. Dein Python-Backend muss diesen Verifikationstoken erhalten, um das Ergebnis validieren zu können.

Wie funktioniert die Prüfung eines Python-CAPTCHA, Schritt für Schritt?

1) Dein Frontend zeigt das CAPTCHA-Widget an. 2) Der Nutzer löst es und dein Frontend erhält einen Verifikationstoken. 3) Dein Frontend sendet diesen Verifikationstoken an dein Python-Backend. 4) Dein Python-Backend ruft über die TrustComponent Verification API das Ergebnis ab. 5) Auf Basis des Ergebnisses lässt du zu, blockierst oder fügst einen zusätzlichen Schritt hinzu.

Spielt es eine Rolle, wie ich den Verifikationstoken an mein Python-Backend sende?

Nein. Du kannst den Verifikationstoken per Form Submit, im JSON-Body, als Header oder auf jede andere Weise senden, die zu deinem System passt. Wichtig ist nur, dass dein Python-Backend den Verifikationstoken erhält und das Ergebnis serverseitig validiert.

Welche Informationen erhalte ich aus dem Validierungsergebnis zurück?

Du erhältst immer zwei Werte: verification passed und einen Bot-Score. verification passed ist die klare Ja/Nein-Entscheidung (zum Beispiel ist der Wert false, wenn deine Sicherheitsregeln eine Anfrage blockieren). Der Bot-Score ist eine Risiko-Einschätzung von 0 (sehr wahrscheinlich Mensch) bis 1 (sehr wahrscheinlich Bot), damit du festlegen kannst, wie strikt du sein möchtest.

Mit welchem Schwellenwert für den Bot-Score sollte ich starten?

Ein praktikabler Startwert ist 0,5: Erlaube Anfragen unter 0,5 und blockiere Anfragen über 0,5 (nur wenn verification passed true ist). Du kannst den Schwellenwert an dein Risiko anpassen, für unterschiedliche Aktionen unterschiedliche Werte nutzen (z. B. Login vs. Kontaktformular) oder einen Step-up-Flow verwenden (z. B. zulassen, dann E-Mail-Bestätigung, dann blockieren).

Wie lange ist ein Verifikationstoken gültig, und kann ich ihn wiederverwenden?

Standardmäßig ist ein Verifikationstoken nur einmal verwendbar und 15 Minuten gültig. Im Enterprise-Plan kannst du die Gültigkeit verlängern und eine begrenzte Zahl von Abrufen erlauben. Aus Sicherheitsgründen empfehlen wir, beim Standard zu bleiben.

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

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

Loslegen Vertrieb kontaktieren