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.


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.
<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:

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:
pip install "trustcaptcha>=3.0.0,<4.0.0"Validiere dann den Token in deiner Django-View und reagiere auf das Ergebnis:
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.
4. Integration testen
TrustCaptcha ist jetzt aktiv. Schick eine Testanfrage ab und prüfe, ob sie durchgeht.

Häufige Fragen
Wo gehört die Prüfung des Django-CAPTCHAs hin?
Ersetzt TrustCaptcha den CSRF-Schutz von Django?
Kann ich das CAPTCHA in eine Django Form (forms.Form / ModelForm) integrieren?
Warum hat das Form-Feld einen Unterstrich (tc_verification_token), während das Widget einen Bindestrich postet (tc-verification-token)?
Funktioniert TrustCaptcha in async Django Views?
Wo bewahre ich den CAPTCHA-API-Key in einem Django-Projekt auf?
TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.


Schütze deine Django-Anwendung in wenigen Schritten mit TrustCaptcha!
- EU-hosted & DSGVO-konform
- Keine Rätsel
- 14 Tage kostenlos testen