TrustComponent
Actix Web
TrustCaptcha · Bot-Schutz

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.

Start des Formulars zur Erstellung eines CAPTCHA.
CAPTCHA-Sicherheitsregeln eines Demo-CAPTCHAs.

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.

contact.html
HTML
<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:

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

Install
bash
cargo add trustcaptcha@^3.0

Validiere dann den Token in deinem Actix-Web-Handler und reagiere auf das Ergebnis:

src/main.rs
Rust
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.

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 Actix-Web-CAPTCHAs hin?
Im async-Handler, der das Formular-Submit empfängt. Binde den Body mit web::Form<MyForm>, wobei MyForm den CAPTCHA-Token über #[serde(rename = "tc-verification-token")] trägt, und rufe unseren Rust-Crate auf, um das Verifikationsergebnis zu holen.
Wie teile ich eine einzige TrustCaptcha-Instanz über Handler hinweg?
Baue sie einmal beim Start, kapsle sie in web::Data::new(...) und registriere sie mit App::new().app_data(...). Jeder Handler deklariert dann trust_captcha: web::Data<TrustCaptcha> in seiner Signatur. Dank des Arc darunter lässt sich das Handle günstig klonen.
Sollte ich die CAPTCHA-Prüfung in einen eigenen Actix-Extractor auslagern?
Verlockend, aber Extractoren, die vor web::Form laufen, sehen nur Request-Parts (Header, URI), nicht den Body, und der Body ist bereits vom Form-Extractor verbraucht. Am saubersten ist ein kleiner async-Helper verify_token(...), den du in jedem geschützten Handler aufrufst.
Passt das Rust-SDK zu Actix Webs async-Runtime?
Ja. Der Crate ist async-/reqwest-basiert, du wartest den Verifizierungs-Aufruf also in jedem async-fn-Handler mit await ab. Blocking-Workarounds oder Thread-Pool-Tricks brauchst du nicht.
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 Actix Web-Anwendung in wenigen Schritten mit TrustCaptcha!

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