Next.js CAPTCHA-Integration
Binde ein Next.js-CAPTCHA mit wenigen Zeilen TypeScript in einen Route Handler oder eine Server Action ein. Unser React-Widget läuft im Client, die Prüfung auf deinem Server, und Bot-Spam bleibt aus Logins, Registrierungen und Kontaktformularen draußen. 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 deine Form-Komponente einbauen
Nutze unseren React-Wrapper in der Client Component, die dein Formular rendert. Das Widget läuft im Hintergrund und fügt beim Absenden ein verstecktes Feld tc-verification-token hinzu, das Server Actions und Route Handler als Form Data erhalten.
Installiere zunächst unser TrustCaptcha-React-Paket:
npm i @trustcomponent/trustcaptcha-reactSetze dann die <TrustcaptchaComponent> in die Client Component, die dein Formular rendert:
"use client";
import { TrustcaptchaComponent } from "@trustcomponent/trustcaptcha-react";
export function ContactForm() {
return (
<form method="post" action="/api/contact">
<input type="email" name="email" required />
<TrustcaptchaComponent sitekey="<your_site_key>" />
<button type="submit">Send</button>
</form>
);
}Das CAPTCHA-Widget wird anschließend in deinem Formular angezeigt:

Detaillierte Informationen zur CAPTCHA-React-Widget-Integration?
Die vollständige Widget-Referenz mit Themes, Sprachen, eigenem Design und mehr findest du in unserer Dokumentation.
Dokumentation lesen
3. Token in einem Route Handler oder einer Server Action validieren
Hole in einem Next.js-Route-Handler (oder einer Server Action) den Verifikationstoken aus den Form-Daten, 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:
npm i @trustcomponent/trustcaptcha-nodejsValidiere dann den Token in deinem Route Handler und reagiere auf das Ergebnis:
import { NextResponse } from "next/server";
import { TrustCaptcha } from "@trustcomponent/trustcaptcha-nodejs";
export async function POST(request: Request) {
const formData = await request.formData();
const token = String(formData.get("tc-verification-token") ?? "");
try {
const result = await TrustCaptcha.getVerificationResult(process.env.TRUSTCAPTCHA_API_KEY!, token);
if (!result.verificationPassed || result.score > 0.5) {
return NextResponse.json({ error: "CAPTCHA verification failed." }, { status: 400 });
}
} catch {
return NextResponse.json({ error: "CAPTCHA verification failed." }, { status: 400 });
}
// CAPTCHA bestanden — Anfrage verarbeiten
return NextResponse.json({ status: "ok" });
}Detaillierte Informationen zur Next.js-CAPTCHA-Integration?
Die vollständige Schritt-für-Schritt-Anleitung, inklusive einer Server-Action-Variante und eines wiederverwendbaren Verifier-Utilities, findest du in unserer Dokumentation.
Dokumentation lesen
Anderes Backend-Framework statt Next.js?
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
Funktioniert das Next.js-CAPTCHA mit App Router und Pages Router?
Kann ich das CAPTCHA aus einer Server Action heraus prüfen?
Funktioniert das React-Widget in einer Server Component?
Kann ich die CAPTCHA-Verifizierung in der Edge Runtime laufen lassen?
Wo speichere ich den CAPTCHA-API-Key in einem Next.js-Projekt?
Wie halte ich das CAPTCHA-Verifizierungs-Utility aus dem Client-Bundle heraus?
TrustCaptcha blockiert Spam und Bots, nicht deine Kunden. Keine Rätsel, DSGVO-konform, in der EU gehostet.


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