TrustComponent
React
TrustCaptcha · Protection contre les bots

Intégration CAPTCHA React

L'intégration CAPTCHA React de TrustCaptcha protège vos formulaires contre les bots, sans puzzles d'images. Elle tient le spam à l'écart de vos inscriptions, formulaires de contact et paiements, et les vrais visiteurs n'ont rien à résoudre. Hébergé dans l'UE et conforme au 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

Les étapes suivantes montrent dans les grandes lignes comment ajouter le widget TrustCaptcha à un frontend React. Les instructions complètes se trouvent dans le guide d’intégration CAPTCHA pour React de notre documentation.

Lire la documentation

Installez d’abord notre package React TrustCaptcha :

Installer
bash
npm i @trustcomponent/trustcaptcha-react

Insérez ensuite le widget CAPTCHA (le tag HTML trustcaptcha-component) dans un formulaire HTML :

app.js
javascript
import {TrustcaptchaComponent} from "@trustcomponent/trustcaptcha-react";

function App() {

function handleSuccess(verificationToken) { /* gérer le succès */ }

function handleError(error) { /* gérer l’erreur */ }

return (
<div>
<form>
<!-- vos champs de saisie -->
<TrustcaptchaComponent
sitekey="<your_site_key>"
onCaptchaSolved={event => handleSuccess(event.detail)}
         onCaptchaFailed={event => handleError(event.detail)}
></TrustcaptchaComponent>
<!-- autres champs de saisie / bouton d’envoi -->
</form>
</div>
);
}

export default App;

Le widget CAPTCHA sera désormais affiché sur votre site React :

Début du CAPTCHA

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

Une autre technologie frontend que React ?
Si vous travaillez avec une autre technologie que React, ou si vous gérez plusieurs sites et applications, choisissez un autre framework ou une autre plateforme ici. S’il n’existe pas encore d’intégration préconstruite pour votre technologie frontend, vos développeurs peuvent intégrer le CAPTCHA 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

Une fois le CAPTCHA terminé, envoyez le jeton de vérification à votre backend. Celui-ci récupère le résultat de vérification sur nos serveurs et le contrôle. La suite dépend du niveau de risque. Vous trouverez les détails de l’intégration backend et de la validation des résultats dans notre documentation.

Intégrations backend préconstruites
Nos intégrations préconstruites ajoutent la validation CAPTCHA à votre service backend. S’il n’en existe pas encore pour votre technologie, vos développeurs peuvent intégrer la validation 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

De quoi ai-je besoin pour ajouter un CAPTCHA React à mon application ?
Vous avez besoin d’un compte TrustCaptcha, d’un CAPTCHA créé dans le tableau de bord et de vos identifiants (site-key, API key et éventuellement license-key). Dans React, vous installez le package React et placez le composant TrustCaptcha dans le formulaire que vous souhaitez protéger.
Le widget TrustCaptcha doit-il obligatoirement être placé dans un <form> ?
Oui. Le composant TrustCaptcha doit être placé à l’intérieur d’un élément form. Si votre page n’utilise pas de formulaire traditionnel, encapsulez quand même les champs concernés et le composant TrustCaptcha dans un <form> minimal.
Comment récupérer le jeton de vérification dans React ?
Vous avez deux options : (1) le lire depuis le champ input masqué (nom par défaut : "tc-verification-token"), ou (2) le récupérer via l’événement du composant (par exemple avec le handler React "onCaptchaSolved"). Utilisez l’approche la mieux adaptée à votre formulaire et à votre flux API.
Dois-je quand même valider le CAPTCHA dans mon backend ?
Oui, toujours. Le widget React ne produit qu’un jeton de vérification. Votre backend doit envoyer ce jeton à TrustCaptcha (à l’aide de votre API key) et évaluer le résultat avant d’accepter une inscription, une connexion, un checkout ou une demande de contact.
Puis-je utiliser plusieurs widgets TrustCaptcha sur une même page ?
Oui. Plusieurs formulaires sur une même page ne posent aucun problème. Si vous placez plusieurs widgets dans un même formulaire, attribuez à chacun son propre nom de champ pour le jeton (par exemple via "tokenFieldName") ou utilisez les événements afin de bien séparer les jetons.
Où placer TrustCaptcha dans un formulaire multi-étapes (wizard) ?
Placez-le près de l’action finale d’envoi. 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. Résoudre le CAPTCHA trop tôt dans un long parcours peut entraîner des tentatives supplémentaires évitables.
TrustCaptcha fonctionne-t-il avec les frameworks React SSR/SSG (par exemple Next.js) ?
Oui. TrustCaptcha prend en charge les configurations React courantes, y compris SSR/SSG. En pratique, de nombreuses équipes rendent le widget côté client (dans le navigateur) afin que la vérification puisse s’exécuter normalement, puis valident le jeton côté serveur.
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 React avec TrustCaptcha en quelques étapes !

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