TrustComponent
Next.js
TrustCaptcha · Protection anti-bots

Intégration CAPTCHA Next.js

Intégrez un CAPTCHA Next.js dans un Route Handler ou une Server Action avec quelques lignes de TypeScript. Notre widget React s'exécute côté client, la vérification a lieu sur votre serveur, et le spam automatisé reste hors de vos connexions, inscriptions et formulaires de contact. Hébergé dans l'UE, conforme RGPD et sans énigmes visuelles.

Démarrage rapide

Comment fonctionne l'intégration

1. Créer un CAPTCHA

Créez un compte utilisateur ou connectez-vous avec un compte existant. Ensuite, créez un nouveau CAPTCHA ou choisissez-en un existant. Si vous voulez d’abord essayer TrustCaptcha, chaque offre commence par un essai gratuit de 14 jours.

La page d’aperçu du CAPTCHA affiche votre site key et votre license key, et c’est là que vous créez votre API key. Ajoutez les domaines de votre site aux domaines autorisés dans les règles de sécurité du CAPTCHA pour qu’ils puissent utiliser votre CAPTCHA.

Début du formulaire de création du CAPTCHA.
Règles de sécurité CAPTCHA d’un CAPTCHA de démonstration.

2. Ajouter le widget CAPTCHA dans votre composant de formulaire

Utilisez notre wrapper React dans le composant client qui rend votre formulaire. Le widget s’exécute en arrière-plan et ajoute un champ caché tc-verification-token lors de l’envoi, que les Server Actions et Route Handlers reçoivent en tant que form data.

Commencez par installer notre package React TrustCaptcha :

Install
bash
npm i @trustcomponent/trustcaptcha-react

Ajoutez ensuite le composant <TrustcaptchaComponent> dans le composant client qui rend votre formulaire :

app/contact/contact-form.tsx
TypeScript
"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>
  );
}

Le widget CAPTCHA s’affichera ensuite dans votre formulaire :

Début du CAPTCHA

Besoin d’informations détaillées sur l’intégration du widget React CAPTCHA ?
Notre documentation contient la référence complète du widget, avec les thèmes, les langues et le design personnalisé.

Lire la documentation

3. Valider le jeton dans un Route Handler ou une Server Action

Dans un Route Handler Next.js (ou une Server Action), récupérez le jeton de vérification depuis les form data, consultez le résultat via notre bibliothèque Node.js et décidez si la requête doit être acceptée.

Commencez par installer notre bibliothèque Node.js TrustCaptcha :

Install
bash
npm i @trustcomponent/trustcaptcha-nodejs

Validez ensuite le jeton dans votre Route Handler et agissez en fonction du résultat :

app/api/contact/route.ts
TypeScript
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 validé — traiter la requête
  return NextResponse.json({ status: "ok" });
}

Besoin d’informations détaillées sur l’intégration CAPTCHA Next.js ?
Pour des instructions détaillées étape par étape, y compris une variante Server Action et un utilitaire de vérification réutilisable, veuillez consulter notre documentation.

Lire la documentation

Un autre framework backend que Next.js ?
Si vous utilisez un autre framework, choisissez la recette correspondante ici. Si votre framework n’est pas listé, vos développeurs peuvent intégrer la vérification eux-mêmes à l’aide de notre documentation ou contacter notre équipe support pour demander une intégration préconstruite.

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. Testez votre intégration

TrustCaptcha est maintenant actif. Envoyez une requête de test et vérifiez qu’elle passe.

CAPTCHA terminé

Questions fréquentes

Le CAPTCHA Next.js fonctionne-t-il avec App Router et Pages Router ?
Oui, les deux. Dans App Router, vous validez généralement le jeton dans un Route Handler (app/api/.../route.ts) ou une Server Action. Dans Pages Router, vous faites la même chose dans une route API (pages/api/...). L’appel au SDK est identique.
Puis-je vérifier le CAPTCHA depuis une Server Action ?
Oui, et c’est tout à fait adapté. Lisez le jeton depuis le FormData passé à votre action « use server », appelez notre bibliothèque Node.js et retournez une erreur en cas d’échec. Le CAPTCHA reste entièrement côté serveur, et votre composant client ne touche jamais la clé d’API.
Le widget React fonctionne-t-il dans un Server Component ?
Le widget lui-même s’exécute dans le navigateur, rendez-le donc depuis un composant client (« use client »). Le formulaire peut quand même être soumis à une Server Action ou à un Route Handler. La vérification se fait entièrement côté serveur.
Puis-je exécuter la vérification CAPTCHA sur le runtime Edge ?
Non. Notre bibliothèque Node.js utilise des API propres à Node (axios), définissez donc le runtime sur « nodejs » pour les routes qui vérifient les jetons CAPTCHA. Le runtime par défaut dans Next.js est déjà « nodejs », vous n'avez à intervenir que si vous avez explicitement défini runtime = « edge ».
Où stocker la clé d’API CAPTCHA dans un projet Next.js ?
Dans .env.local en développement et dans les variables d’environnement de votre hébergeur (Vercel, Netlify, …) en production. Lisez-la via process.env.TRUSTCAPTCHA_API_KEY dans du code server-only et ne l’exposez jamais via NEXT_PUBLIC_*.
Comment garder l’utilitaire de vérification CAPTCHA hors du bundle client ?
Ajoutez import "server-only" en haut du fichier qui importe la bibliothèque Node.js. Cela fait échouer le build de Next.js si le fichier est tiré dans un composant client, ce qui empêche d’expédier accidentellement la clé d’API au navigateur.
Vous perdez des prospects à cause des CAPTCHAs ?

TrustCaptcha bloque le spam et les bots, pas vos clients. Sans puzzle, conforme au RGPD, hébergé en UE.

Début du CAPTCHA
CAPTCHA terminé
Aucun puzzle pour vos visiteurs
La vérification tourne en arrière-plan pendant la saisie. Davantage de visiteurs vont au bout de vos formulaires au lieu d'abandonner.
Conforme au RGPD
Hébergé dans l'UE, sans cookies, avec transmission chiffrée et suppression automatique des données. Chaque client reçoit un accord de traitement des données (DPA).
Sécurité multicouche
Le proof-of-work adaptatif et le scoring de risque stoppent les abus tôt, même lors d'un pic d'attaques.
Contrôle total
Réglez la sensibilité, gérez des listes d'autorisation et de blocage et utilisez le géoblocage. Vous décidez du niveau d'exigence de la vérification.

Protégez votre application Next.js avec TrustCaptcha en quelques étapes !

  • Hébergé en UE & conforme RGPD
  • Aucun puzzle
  • Essai gratuit de 14 jours