Actix Web CAPTCHA-Integration
Mit wenigen Zeilen Rust richtest du ein Actix-Web-CAPTCHA ein. TrustCaptcha stoppt Bot-Spam in Logins, Registrierungen und Kontaktformularen, und eine geteilte Instanz über web::Data plus ein kleiner async-Helper halten deine Handler übersichtlich. 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 Formular einbauen
Binde das TrustCaptcha-Widget in das HTML-Formular ein, das dein Actix-Web-Handler ausliefert. Das Widget läuft im Hintergrund und fügt beim Absenden ein verstecktes Feld tc-verification-token hinzu, das web::Form in dein Struct deserialisiert.
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>
<form method="post" action="/contact">
<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 deinem Actix-Web-Handler validieren
Hole in deinem Actix-Web-Handler den Verifikationstoken aus dem Formular, rufe das Ergebnis über unseren Rust-Crate ab und entscheide, ob die Anfrage akzeptiert werden soll.
Installiere zunächst unseren TrustCaptcha-Rust-Crate:
cargo add trustcaptcha@^3.0Validiere dann den Token in deinem Actix-Web-Handler und reagiere auf das Ergebnis:
use actix_web::{post, web, HttpResponse, Responder};
use serde::Deserialize;
use trustcaptcha::trust_captcha::TrustCaptcha;
#[derive(Deserialize)]
struct ContactForm {
email: String,
#[serde(rename = "tc-verification-token")]
tc_verification_token: String,
}
#[post("/contact")]
async fn submit(form: web::Form<ContactForm>) -> impl Responder {
let trust_captcha = match TrustCaptcha::builder("<your_api_key>").build() {
Ok(tc) => tc,
Err(_) => return HttpResponse::InternalServerError().body("CAPTCHA setup failed."),
};
let result = match trust_captcha.get_verification_result(&form.tc_verification_token).await {
Ok(r) => r,
Err(_) => return HttpResponse::BadRequest().body("CAPTCHA verification failed."),
};
if !result.verification_passed || result.score > 0.5 {
return HttpResponse::BadRequest().body("CAPTCHA verification failed.");
}
// CAPTCHA bestanden — Anfrage verarbeiten
HttpResponse::Ok().body("Thanks!")
}Detaillierte Informationen zur Actix-Web-CAPTCHA-Integration?
Die vollständige Schritt-für-Schritt-Anleitung, inklusive eines geteilten web::Data<TrustCaptcha>-Setups und eines wiederverwendbaren verify_token-Helpers, findest du in unserer Dokumentation.
Dokumentation lesen
Anderes Backend-Framework statt Actix Web?
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 Actix-Web-CAPTCHAs hin?
Wie teile ich eine einzige TrustCaptcha-Instanz über Handler hinweg?
Sollte ich die CAPTCHA-Prüfung in einen eigenen Actix-Extractor auslagern?
Passt das Rust-SDK zu Actix Webs async-Runtime?
TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.


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