TrustComponent
Fastify
TrustCaptcha · Protection anti-bots

Intégration CAPTCHA Fastify

Mettez en place un CAPTCHA Fastify dans une route ou un hook preHandler avec quelques lignes de TypeScript. TrustCaptcha stoppe le spam des bots sur les connexions, inscriptions et formulaires de contact, sans casser votre validation par schéma ni le plugin formbody. Hébergé dans l'UE, conforme au 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 formulaire

Placez le widget TrustCaptcha dans le formulaire HTML servi par votre route Fastify. Le widget s’exécute en arrière-plan et ajoute un champ caché tc-verification-token lors de l’envoi, qui arrive sur request.body comme n’importe quel autre champ.

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>

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 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 votre route Fastify

Dans votre route handler Fastify, récupérez le jeton de vérification depuis request.body, 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 avec le plugin formbody de Fastify :

Install
bash
npm i fastify @fastify/formbody @trustcomponent/trustcaptcha-nodejs

Validez ensuite le jeton dans votre route Fastify et agissez en fonction du résultat :

server.ts
TypeScript
import Fastify from "fastify";
import formbody from "@fastify/formbody";
import { TrustCaptcha } from "@trustcomponent/trustcaptcha-nodejs";

const fastify = Fastify();
await fastify.register(formbody);

fastify.post("/contact", async (request, reply) => {
  const body = request.body as Record<string, string>;
  const token = body["tc-verification-token"] ?? "";

  try {
    const result = await TrustCaptcha.getVerificationResult("<your_api_key>", token);
    if (!result.verificationPassed || result.score > 0.5) {
      return reply.code(400).send("CAPTCHA verification failed.");
    }
  } catch {
    return reply.code(400).send("CAPTCHA verification failed.");
  }

  // CAPTCHA validé — traiter la requête
  return reply.send("Thanks!");
});

Besoin d’informations détaillées sur l’intégration CAPTCHA Fastify ?
Pour des instructions détaillées étape par étape, y compris un hook preHandler réutilisable pour les projets avec plusieurs routes protégées, veuillez consulter notre documentation.

Lire la documentation

Un autre framework backend que Fastify ?
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

Où placer la vérification du CAPTCHA Fastify ?
Dans le route handler qui reçoit la soumission du formulaire ou, pour plusieurs routes protégées, dans un hook preHandler (l’équivalent Fastify d’un middleware par route). Le jeton CAPTCHA arrive sur request.body sous le nom par défaut « tc-verification-token ».
Ai-je besoin d’un plugin spécial pour recevoir les soumissions de formulaire ?
Oui. Fastify analyse le JSON automatiquement, mais pour application/x-www-form-urlencoded (envoyé par un formulaire HTML standard), enregistrez le plugin @fastify/formbody. Sans lui, request.body est undefined pour les soumissions de formulaire et la vérification CAPTCHA n’a rien à lire.
Comment partager la clé d’API et le SDK entre les routes ?
Créez une instance TrustCaptcha unique au démarrage, attachez-la via fastify.decorate("trustCaptcha", instance), et lisez-la depuis request.server.trustCaptcha dans n’importe quelle route ou hook. Cela évite de reconstruire le SDK à chaque requête.
La validation par schéma JSON de Fastify supprime-t-elle le jeton CAPTCHA ?
C’est possible. Si vous avez déclaré un schéma strict pour le corps de la requête, ajoutez tc-verification-token dans le schéma (ou définissez additionalProperties: true) afin que le jeton ne soit pas supprimé avant que votre hook ou handler ne le lise.
Puis-je restreindre le hook CAPTCHA à un groupe de routes ?
Oui. Enregistrez le preHandler globalement à l’intérieur d’un plugin fastify.register(...) limité à un préfixe de route (par exemple /forms), de sorte que chaque route sous ce préfixe exécute la vérification automatiquement.
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 Fastify avec TrustCaptcha en quelques étapes !

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