TrustComponent
Django
TrustCaptcha · Bot-Schutz

Django CAPTCHA-Integration

Mit wenigen Zeilen Python richtest du ein Django-CAPTCHA in deiner View ein. TrustCaptcha stoppt Bot-Spam in Logins, Registrierungen und Kontaktformularen, und CSRF-Schutz und deine forms.Form-Klassen funktionieren weiter. EU-gehostet, DSGVO-konform 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 Django-Template einbauen

Binde das TrustCaptcha-Widget in das Django-Template ein, das dein Formular rendert. Das Widget läuft im Hintergrund und fügt beim Absenden ein verstecktes Feld tc-verification-token hinzu, das auf request.POST ankommt wie jeder andere Input.

templates/contact.html
HTML
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>

<form method="post" action="{% url 'contact_submit' %}">
    {% csrf_token %}
    <input type="email" name="email" required>
    <trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
    <button type="submit">Send</button>
</form>

Das CAPTCHA-Widget wird anschließend in deinem Formular angezeigt:

CAPTCHA-Widget vor dem Start

Detaillierte Informationen zur CAPTCHA-Widget-Integration?
Die vollständige Widget-Referenz mit Themes, Sprachen, eigenem Design und mehr findest du in unserer Dokumentation.

Dokumentation lesen

3. Token in deiner Django-View validieren

Hole in deiner Django-View den Verifikationstoken aus request.POST, rufe das Ergebnis über unsere Python-Library ab und entscheide, ob die Anfrage akzeptiert werden soll.

Installiere zunächst unsere TrustCaptcha-Python-Library:

Install
bash
pip install "trustcaptcha>=3.0.0,<4.0.0"

Validiere dann den Token in deiner Django-View und reagiere auf das Ergebnis:

contact/views.py
Python
from django.shortcuts import redirect, render
from django.views.decorators.http import require_POST
from trustcaptcha.trust_captcha import TrustCaptcha

@require_POST
def submit(request):
    token = request.POST.get("tc-verification-token", "")

    try:
        trust_captcha = TrustCaptcha("<your_api_key>")
        result = trust_captcha.get_verification_result(token)
    except Exception:
        return render(request, "contact.html", {"error": "CAPTCHA verification failed."})

    if not result.verification_passed or result.score > 0.5:
        return render(request, "contact.html", {"error": "CAPTCHA verification failed."})

    # CAPTCHA bestanden — Anfrage verarbeiten
    return redirect("contact_success")

Detaillierte Informationen zur Django-CAPTCHA-Integration?
Die vollständige Schritt-für-Schritt-Anleitung, inklusive einer Django-Form-Integration mit Verifizierung in clean_*(), findest du in unserer Dokumentation.

Dokumentation lesen

Anderes Backend-Framework statt Django?
Wenn du ein anderes Framework nutzt, wähle hier das passende Rezept aus. Ist dein Framework nicht aufgeführt, können deine Softwareentwickler die Verifizierung mithilfe unserer Dokumentation selbst integrieren oder unser Support-Team nach einer vorgefertigten Integration fragen.

Actix Web
ASP.NET Core
Axum
Django
Echo
Express
FastAPI
Fastify
Fiber
Flask
Gin
Hapi
Laravel
Micronaut
NestJS
Next.js
Quarkus
Ruby on Rails
Sinatra
Spring Boot
Symfony

4. Integration testen

TrustCaptcha ist jetzt aktiv. Schick eine Testanfrage ab und prüfe, ob sie durchgeht.

CAPTCHA abgeschlossen

Häufige Fragen

Wo gehört die Prüfung des Django-CAPTCHAs hin?
In der View, die das Formular-Submit verarbeitet, bevor du das Modell speicherst oder die E-Mail versendest. Der CAPTCHA-Token kommt als regulärer Form-Parameter auf request.POST an (Standardname: "tc-verification-token").
Ersetzt TrustCaptcha den CSRF-Schutz von Django?
Nein. CSRF und TrustCaptcha sind unabhängige Schichten, und beide sollten aktiviert bleiben. Behalte {% csrf_token %} im Template und die CSRF-Middleware in den Settings; TrustCaptcha bestätigt nur, dass ein Mensch das Formular ausgefüllt hat.
Kann ich das CAPTCHA in eine Django Form (forms.Form / ModelForm) integrieren?
Ja. Füge ein verstecktes CharField für den Token hinzu (z.B. tc_verification_token) und lege den Verifizierungs-Aufruf in eine clean_tc_verification_token-Methode. Validierungsfehler erscheinen dann am gebundenen Formular wie jeder andere Feldfehler.
Warum hat das Form-Feld einen Unterstrich (tc_verification_token), während das Widget einen Bindestrich postet (tc-verification-token)?
Python-Identifier dürfen keinen Bindestrich enthalten, daher heißt das Form-Feld tc_verification_token. Am einfachsten setzt du am Widget token-field-name="tc_verification_token", damit der übertragene Feldname zum Form-Feld passt.
Funktioniert TrustCaptcha in async Django Views?
Ja. Das Python-SDK ist blockierend, daher kapselst du den Aufruf in einer async-View mit sync_to_async: result = await sync_to_async(trust_captcha.get_verification_result)(token). Der Event-Loop bleibt während der Verifizierung reaktionsfähig.
Wo bewahre ich den CAPTCHA-API-Key in einem Django-Projekt auf?
In einer Umgebungsvariable (z.B. TRUSTCAPTCHA_API_KEY), in settings.py exponiert als settings.TRUSTCAPTCHA_API_KEY. Lies ihn in deiner View oder Form aus den Settings und schreib ihn nie fest in den Code.
Leads verlieren wegen CAPTCHAs?

TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.

CAPTCHA-Start
CAPTCHA abgeschlossen
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 Django-Anwendung in wenigen Schritten mit TrustCaptcha!

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