JavaScript
TrustCaptcha – Protection anti-bots

Intégration CAPTCHA JavaScript

Déployez TrustCaptcha sur n’importe quel site JavaScript en quelques minutes avec un simple widget de formulaire. Sécurisez les actions telles que 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, compatible RGPD et accessible.

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 sélectionnez-en un existant. Si vous ne savez pas encore si TrustCaptcha vous convient, essayez notre service CAPTCHA sans risque pendant 14 jours gratuitement.

Sur la page d’aperçu du CAPTCHA, vous trouverez toutes les informations importantes, comme la clé de site, la clé secrète et la clé de licence. Autorisez simplement vos sites web à utiliser votre CAPTCHA en les ajoutant à la liste des domaines autorisés dans les règles de sécurité du 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 vous donnent une idée générale de la manière d’intégrer le widget CAPTCHA TrustCaptcha dans un frontend JavaScript. Pour des instructions précises et détaillées, veuillez consulter le guide d’intégration CAPTCHA pour JavaScript dans 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/2.1.x/trustcaptcha.esm.min.js"></script>

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

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

Insérez ensuite le widget CAPTCHA, appelé 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 :

CAPTCHA terminé

Besoin d’informations détaillées sur l’intégration CAPTCHA JavaScript ?
Pour des instructions détaillées sur l’intégration de TrustCaptcha, veuillez consulter notre guide d’intégration CAPTCHA JavaScript. Un exemple complet d’intégration CAPTCHA JavaScript est disponible dans notre dépôt Github CAPTCHA Samples.

Une autre technologie frontend que JavaScript ?
Si vous ne souhaitez pas utiliser JavaScript ou si vous avez plusieurs sites web ou applications, vous pouvez choisir un autre framework ou une autre plateforme ici. S’il n’existe pas d’intégration prête à l’emploi pour votre technologie frontend préférée, vos développeurs peuvent intégrer le CAPTCHA eux-mêmes à l’aide de notre documentation ou contacter notre équipe support pour demander une solution préintégrée.

Android
Angular
Craft CMS
Flutter
iOS
JavaScript
Joomla
JTL-Shop
Keycloak
Magento 2
React
React Native
Svelte
TYPO3
Vue
Webflow
WordPress

3. Valider le résultat du CAPTCHA dans votre backend

Une fois le CAPTCHA terminé, récupérez le jeton de vérification et envoyez-le à votre backend. Dans votre backend, récupérez le résultat de vérification du CAPTCHA depuis nos serveurs et validez ce résultat. Selon le niveau de risque bot, vous décidez de la suite à donner. Vous trouverez des informations détaillées sur l’intégration backend et la validation du résultat dans notre documentation.

Intégrations backend préconstruites
Vous pouvez utiliser l’une de nos intégrations backend préconstruites pour intégrer le processus de validation CAPTCHA dans votre service backend. S’il n’existe pas d’intégration prête à l’emploi pour votre technologie backend préférée, vos développeurs peuvent intégrer eux-mêmes la validation CAPTCHA à l’aide de notre documentation ou contacter notre équipe support pour demander une solution préintégrée.

.Net
Go
Groovy
Java
Kotlin
Nodejs
PHP
Python
Ruby
Rust
Scala
Spring

4. Félicitations 🎉

Vous êtes maintenant protégé par TrustCaptcha — félicitations !

CAPTCHA terminé

FAQs

De quoi ai-je besoin pour intégrer TrustCaptcha sur un site JavaScript 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é
UX sans énigmes
Fonctionne en arrière-plan pendant que les visiteurs saisissent leurs informations — ainsi davantage de personnes terminent vos formulaires et moins abandonnent.
Compatible RGPD
Hébergé dans l’UE et conçu dans une logique privacy-first : pas de cookies, transmission chiffrée, nettoyage automatique — avec des ressources juridiques prêtes à l’emploi.
Sécurité multicouche
Une protection adaptative et un scoring de risque intelligent stoppent les abus très tôt — même en cas de pic d’attaques.
Contrôle total
Ajustez la sensibilité, définissez des listes d’autorisation/refus et utilisez le géoblocage — c’est vous qui décidez du niveau de strictesse 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