TrustComponent
NestJS
TrustCaptcha · Bot-Schutz

NestJS CAPTCHA-Integration

Binde ein NestJS-CAPTCHA mit wenigen Zeilen TypeScript in einen Controller oder Guard ein. Es stoppt Bot-Spam bei Logins, Registrierungen und Kontaktformularen und passt zu Dependency Injection, ConfigModule und typsicheren DTOs. 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 NestJS-Controller ausliefert. Das Widget läuft im Hintergrund und fügt beim Absenden ein verstecktes Feld tc-verification-token hinzu, das auf req.body ankommt wie jeder andere Input.

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 NestJS-Controller validieren

Hole in deinem NestJS-Controller den Verifikationstoken aus dem Request-Body, rufe das Ergebnis über unsere Node.js-Library ab und entscheide, ob die Anfrage akzeptiert werden soll.

Installiere zunächst unsere TrustCaptcha-Node.js-Library:

Install
bash
npm i @trustcomponent/trustcaptcha-nodejs

Validiere dann den Token in deinem NestJS-Controller und reagiere auf das Ergebnis:

contact.controller.ts
TypeScript
import { BadRequestException, Body, Controller, Post } from "@nestjs/common";
import { TrustCaptcha } from "@trustcomponent/trustcaptcha-nodejs";

@Controller("contact")
export class ContactController {
  @Post()
  async submit(@Body() body: { "tc-verification-token": string }) {
    const token = body["tc-verification-token"] ?? "";

    try {
      const result = await TrustCaptcha.getVerificationResult("<your_api_key>", token);
      if (!result.verificationPassed || result.score > 0.5) {
        throw new BadRequestException("CAPTCHA verification failed.");
      }
    } catch {
      throw new BadRequestException("CAPTCHA verification failed.");
    }

    // CAPTCHA bestanden — Anfrage verarbeiten
    return { status: "ok" };
  }
}

Detaillierte Informationen zur NestJS-CAPTCHA-Integration?
Die vollständige Schritt-für-Schritt-Anleitung, inklusive eines wiederverwendbaren Guard-Refactors für Projekte mit mehreren geschützten Endpunkten, findest du in unserer Dokumentation.

Dokumentation lesen

Anderes Backend-Framework statt NestJS?
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 NestJS-CAPTCHA-Prüfung hin?
In der Controller-Methode, die das abgeschickte Formular empfängt. Für ein saubereres Setup mit mehreren geschützten Endpunkten eignet sich ein eigener NestJS-Guard. Beide haben Zugriff auf den Request-Body, in dem der CAPTCHA-Token (Standardname: "tc-verification-token") wie jedes andere Feld ankommt.
Soll ich einen Guard, einen Interceptor oder die Verifizierung direkt im Controller nutzen?
Für einen einzelnen Endpoint ist der Aufruf direkt im Controller in Ordnung. Für mehrere geschützte Endpunkte ist ein Guard (TrustCaptchaGuard) das idiomatische NestJS-Pattern: ein einzelner @UseGuards(TrustCaptchaGuard)-Decorator schaltet die CAPTCHA-Verifizierung für jede Controller-Methode frei.
Wie teile ich den API-Key über die ganze App?
Mit dem ConfigModule von Nest. Injiziere ConfigService in den Guard oder Controller und lies den API-Key mit config.getOrThrow<string>("TRUSTCAPTCHA_API_KEY"). Der Key selbst liegt in deiner .env-Datei oder im Secret-Store deines Hosting-Providers.
Stört die ValidationPipe von NestJS den CAPTCHA-Token?
Nein. ValidationPipe validiert nur DTO-Felder, die du deklariert hast. Der CAPTCHA-Token wird im Guard aus req.body gelesen (oder aus einem typisierten DTO mit eigenem Decorator) und funktioniert daher problemlos parallel zur ValidationPipe.
Muss ich Body-Parsing manuell konfigurieren?
Nein. Nest aktiviert express.json() und express.urlencoded() standardmäßig, und req.body wird geparst, bevor der Guard oder Controller läuft. Der CAPTCHA-Token ist also direkt verfügbar.
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 NestJS-Anwendung in wenigen Schritten mit TrustCaptcha!

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