TrustComponent
NodeJS
TrustCaptcha · Protection contre les bots

Intégration CAPTCHA NodeJS

Ajoutez un CAPTCHA Node.js à votre application en quelques minutes. TrustCaptcha protège les inscriptions, connexions, formulaires de contact et requêtes API, et votre serveur vérifie chaque contrôle. Les vrais utilisateurs ne voient aucun puzzle, les données restent dans l'UE et la configuration est prête pour le RGPD.

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. Intégrer le widget CAPTCHA dans votre frontend

Intégrez le widget CAPTCHA dans votre site web ou votre application. Le guide du widget CAPTCHA de notre documentation contient les instructions pas à pas.

Lire la documentation

Le widget CAPTCHA s’affichera ensuite sur votre site web ou votre application :

Début du CAPTCHA

Intégrations frontend préconstruites
Nos intégrations frontend préconstruites ajoutent le widget CAPTCHA à votre site web ou à votre application. S’il n’en existe pas encore pour votre technologie frontend, vos développeurs peuvent intégrer le widget eux-mêmes à l’aide de notre documentation ou demander à notre équipe support une intégration préconstruite.

Angular
Contact Form 7
Craft CMS
JavaScript
Joomla
JTL-Shop
Keycloak
Magento 2
React
Shopware 6
Svelte
TYPO3
Vue
Webflow
WordPress

3. Valider le résultat CAPTCHA dans votre backend

Les étapes suivantes montrent comment un backend NodeJS récupère le résultat de vérification CAPTCHA sur notre serveur et décide de la suite. Les instructions complètes se trouvent dans le guide d’intégration CAPTCHA pour NodeJS de notre documentation.

Lire la documentation

Installez d’abord notre dépendance TrustCaptcha pour NodeJS :

Installer
bash
npm install @trustcomponent/trustcaptcha-nodejs

Récupérez le résultat de vérification sur notre serveur avec le jeton de vérification et votre API key :

Récupérer le résultat
TypeScript
// Récupération du résultat de vérification
let verificationResult;
try {
  verificationResult = await TrustCaptcha.getVerificationResult("<your_api_key>", "<verification_token_from_your_client>");
} catch (error) {
  // La récupération du résultat de vérification a échoué - gérer l’erreur
}

En fonction du résultat de vérification et de vos besoins, décidez de la suite :

Traiter le résultat
TypeScript
// Agir en fonction du résultat de vérification
if (!verificationResult.verificationPassed || verificationResult.score > 0.5) {
  // La vérification a échoué ou le bot score est > 0.5 – requête automatisée possible
}

Besoin d’informations détaillées sur l’intégration CAPTCHA NodeJS ?
Notre guide d’intégration CAPTCHA NodeJS contient les instructions détaillées, et notre dépôt CAPTCHA Samples sur GitHub un exemple d’intégration complet.

Une autre technologie backend que NodeJS ?
Si votre serveur n’utilise pas NodeJS, ou si vous avez plusieurs backends, choisissez une autre intégration ici. S’il n’existe pas encore d’intégration préconstruite pour votre technologie backend, vos développeurs peuvent intégrer la vérification eux-mêmes à l’aide de notre documentation ou demander à notre équipe support une intégration préconstruite.

.NET
Go
Groovy
Java
Kotlin
Node.js
PHP
Python
Ruby
Rust
Scala

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

Ai-je besoin d'un frontend pour un CAPTCHA Node.js ?
Oui. TrustCaptcha est résolu dans le navigateur de l’utilisateur (site web ou application) via le widget CAPTCHA. Une fois résolu, votre frontend reçoit un jeton de vérification et l’envoie à votre backend Node.js (par exemple lors de la soumission d’un formulaire ou d’une requête API).
De quoi mon backend Node.js a-t-il besoin pour valider un contrôle TrustCaptcha ?
De deux éléments : l’API key de votre CAPTCHA (depuis votre tableau de bord TrustCaptcha) et le jeton de vérification provenant du frontend. Votre backend les utilise pour récupérer le résultat de vérification depuis TrustCaptcha.
Comment fonctionne la validation Node.js, simplement ?
Vous installez le package Node.js de TrustCaptcha, puis votre backend appelle une fonction pour récupérer le résultat de vérification. Vous n’avez pas besoin de décoder manuellement le jeton ni de construire vous-même l’appel REST. La bibliothèque s’en charge et renvoie un objet de résultat structuré.
Comment décider si je dois accepter ou bloquer une requête ?
Commencez avec deux champs : verificationPassed (oui/non) et score (de 0 à 1, où une valeur plus élevée signifie un risque de bot plus important). Une règle de départ courante consiste à accepter uniquement si verificationPassed est true et si le score est inférieur ou égal à 0,5, mais vous pouvez choisir des seuils plus stricts ou plus tolérants, ou utiliser un flux en plusieurs étapes (par exemple : autoriser, vérification supplémentaire, rejeter).
Combien de temps le jeton de vérification reste-t-il valide, et puis-je récupérer le résultat plus d’une fois ?
Par défaut, le jeton de vérification est à usage unique et valable 15 minutes. Avec l'offre Enterprise, vous pouvez prolonger sa validité et autoriser un nombre limité de récupérations.
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 NodeJS avec TrustCaptcha en quelques étapes !

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