TrustComponent
JavaScript
TrustCaptcha · Protection anti-bots

Intégration CAPTCHA JavaScript

Ajoutez un CAPTCHA JavaScript à n'importe quel site en quelques minutes avec un simple widget de formulaire. Il protège les inscriptions, les réinitialisations de mot de passe, les formulaires de contact et les paiements contre les abus automatisés, sans énigmes. Hébergé dans l'UE, conforme au RGPD et pensé pour l'accessibilité.

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 JavaScript. Les instructions complètes se trouvent dans le guide d’intégration CAPTCHA pour JavaScript de notre documentation.

Lire la documentation

Commencez par installer notre package JavaScript TrustCaptcha :

Installation
HTML
ECMAScript Modules (esm)
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>

CommonJS (cjs)
<script src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.cjs.min.js"></script>

Universal Module Definition (umd)
<script src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.umd.min.js"></script>

Insérez ensuite le widget CAPTCHA (la balise HTML trustcaptcha-component) dans n’importe quel formulaire HTML :

example.html
HTML
<form>
  <!-- vos champs de saisie -->
  <trustcaptcha-component
    sitekey="<your_site_key>"
  ></trustcaptcha-component>
  <!-- autres champs / bouton d’envoi -->
</form>

<script>
  const trustcaptchaComponent = document.getElementsByTagName('trustcaptcha-component')[0];
  trustcaptchaComponent.addEventListener('captchaSolved', (event) => {
  console.log('Jeton de vérification :', event.detail); // gérer le succès
});
  trustcaptchaComponent.addEventListener('captchaFailed', (event) => {
  console.error(event.detail); // gérer l’erreur
});
</script>

Le widget CAPTCHA s’affichera alors sur votre site JavaScript :

Début du CAPTCHA

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

Une autre technologie frontend que JavaScript ?
Si vous travaillez avec une autre technologie que JavaScript, 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 du 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 un CAPTCHA JavaScript sur un site classique ?
Vous ajoutez le script du widget à votre page, placez l’élément CAPTCHA à l’intérieur de votre formulaire et configurez votre clé de site. Ensuite, votre backend doit vérifier le jeton avec notre API avant d’accepter la soumission.
Est-ce que cela fonctionne uniquement avec JavaScript, ou aussi avec d’autres frameworks et CMS ?
L’intégration JavaScript fonctionne sur tout site capable d’exécuter JavaScript. Si vous utilisez une plateforme comme WordPress, TYPO3, Magento, Keycloak, ou un framework comme Angular/React/Vue, vous pouvez aussi utiliser un plugin ou un wrapper prêt à l’emploi.
Pourquoi le CAPTCHA doit-il être placé dans un <form> ?
Parce que le widget est conçu pour fonctionner avec un formulaire : il crée automatiquement un champ de jeton caché et relie le flux de vérification à ce formulaire. S’il n’est pas placé dans un formulaire, il ne peut pas fonctionner correctement.
Comment récupérer le jeton de vérification et l’envoyer à mon serveur ?
Le widget ajoute automatiquement un champ caché à votre formulaire (nommé par défaut "tc-verification-token"). Si vous soumettez le formulaire normalement, le jeton est envoyé automatiquement ; si vous soumettez de manière personnalisée (AJAX), vous pouvez lire le champ caché ou écouter l’événement "captchaSolved".
Ai-je encore besoin d’une validation côté serveur, ou le widget frontend suffit-il ?
Vous devez toujours valider côté serveur. Le widget frontend ne fait que créer un jeton ; votre backend doit vérifier ce jeton avec notre API pour prendre une décision fiable.
Pouvons-nous auto-héberger le fichier JavaScript au lieu de le charger depuis votre CDN ?
Oui. Vous pouvez héberger le fichier JavaScript sur votre propre infrastructure, ce qui peut réduire les dépendances externes. Si vous l’auto-hébergez, vous êtes responsable des mises à jour lorsque vous souhaitez bénéficier de correctifs et d’améliorations.
Comment configurer les sites web autorisés (domaines) pour la production et le développement ?
Ajoutez le domaine ou le sous-domaine que vous souhaitez protéger (par exemple "example.com" ou "app.example.com"). Pour les tests en local, vous pouvez ajouter "localhost" ou une adresse IP. N’incluez pas le protocole, les ports, les chemins ou les paramètres de requête ; les domaines génériques (wildcards) ne sont pas activés par défaut et peuvent être activés par le support si nécessaire.
Puis-je utiliser plusieurs CAPTCHAs sur la même page ?
Oui, c’est possible. La configuration recommandée est un CAPTCHA par formulaire ; si vous placez plusieurs CAPTCHAs dans le même formulaire, vous devriez utiliser des noms de champs de jeton différents afin d’éviter les conflits.
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 JavaScript avec TrustCaptcha en quelques étapes !

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