logo
bars

FunCaptcha
et CapMonster Cloud

Résolution de captcha, intégration sur le site et tests.
Vous avez hérité d’un site doté d’une captcha ou d’une autre couche de protection mais sans accès au code source ? Il est alors naturel de se demander quelle solution est installée, si elle est correctement configurée et comment la tester.

Dans cet article, nous avons essayé de répondre à toutes les questions essentielles. Pour commencer à résoudre le problème, il faut d’abord déterminer quel système de protection est utilisé. Pour cela, vous pouvez consulter la liste des captchas et systèmes de protection antibot les plus populaires, qui présente des exemples visuels et des caractéristiques clés permettant d’identifier rapidement avec quoi vous avez affaire.

Si vous constatez que votre site utilise FunCaptcha (Arkose Labs CAPTCHA), l’étape suivante consiste à étudier plus en détail ses propriétés et son fonctionnement. Dans cet article, vous pouvez également consulter le guide d’intégration de FunCaptcha (Arkose Labs CAPTCHA) afin de comprendre pleinement la façon dont il fonctionne sur votre site. Cela vous permettra non seulement de mieux connaître la protection en place, mais aussi de planifier correctement sa maintenance.

Qu'est-ce que FunCaptcha
Qu'est-ce que FunCaptcha
FunCaptcha est un système interactif de protection anti-bot développé par Arkose Labs. Il vérifie si un utilisateur est un humain réel grâce à des défis visuels et ludiques, faciles pour les humains mais difficiles à automatiser. FunCaptcha est utilisé pour protéger les inscriptions, connexions, paiements en ligne, campagnes marketing et pour prévenir la fraude, le spam et les actions automatisées à grande échelle.
Background
Exemples de FunCaptcha
Rotation d'un objet 3D
Rotation d'un objet 3D
L'utilisateur fait tourner un modèle ou objet 3D pour le placer dans la position correcte.
Sélection d'objets selon une condition
Sélection d'objets selon une condition
Il faut sélectionner les images ou éléments correspondant à une règle donnée (par exemple « sélectionner toutes les pommes »).
Tâches interactives (glisser-déposer / suivre un chemin)
Tâches interactives (glisser-déposer / suivre un chemin)
L'utilisateur effectue des actions sur les éléments, comme les faire glisser le long d'un chemin spécifique.
Questions audio
Questions audio
L'utilisateur écoute un audio et choisit la bonne réponse (utilisé moins fréquemment comme alternative aux défis visuels).

Comment résoudre FunCaptcha via CapMonster Cloud

Lors des tests de formulaires avec FunCaptcha, il est souvent nécessaire de vérifier que le captcha fonctionne correctement et est bien intégré.
Vous pouvez tester manuellement le captcha intégré sur votre site.
  • Ouvrez la page contenant le formulaire et assurez-vous que le captcha s'affiche.
  • Essayez de soumettre le formulaire sans résoudre le captcha — le serveur devrait renvoyer une erreur.
  • Après avoir résolu le captcha avec succès, le formulaire doit être soumis sans erreur.
Pour la reconnaissance automatique du captcha, vous pouvez utiliser des services spécialisés comme CapMonster Cloud — un outil qui reçoit les paramètres du captcha, les traite sur ses serveurs et renvoie un token prêt à l'emploi. Ce token peut être inséré dans le formulaire pour passer la vérification sans intervention de l'utilisateur.

Travailler avec CapMonster Cloud via l’API comprend généralement les étapes suivantes :

Création de la tâcheCréation de la tâche
arrow
Envoyer une requête APIEnvoyer une requête API
arrow
Réception du résultatRéception du résultat
arrow
Insertion du jeton sur la pageInsertion du jeton sur la page
arrow
Comment intégrer FunCaptcha à votre site
Pour comprendre parfaitement le fonctionnement du captcha sur votre site, sa logique de vérification et comment le reconnecter ou le reconfigurer, nous vous recommandons de consulter cette section. Elle décrit le processus d'intégration de la protection et aide à comprendre rapidement tous les détails.
  1. Inscrivez-vous chez Arkose Labs et obtenez l'accès au Arkose Command Center (vous pouvez contacter le chat et soumettre vos informations dans le formulaire, par exemple ici ou ici).
  2. Après avoir obtenu l'accès, récupérez deux clés (Public / Private) dans la section Settings → Keys.

    HowTo Connect image 1

  3. Si nécessaire, contactez votre Customer Success Manager (CSM) pour :

    • obtenir des domaines API personnalisés ;
    • recevoir les schémas de requête et réponse de la Verify API.

Recommandations d'Arkose

  • Utilisez une Development Key pour les tests.
  • Utilisez une Production Key distincte pour chaque workflow (connexion, inscription, achat, etc.).
  • Utilisez des clés différentes pour différents sites.

Processus général

  • Le client collecte les données et affiche un challenge si nécessaire.
  • Le client reçoit un token unique.
  • Le serveur vérifie le token via la Arkose Verify API.

Étape 1. Intégration côté client

Côté navigateur (Arkose Bot Manager) :

  • analyse le comportement de l'utilisateur ;
  • affiche un Enforcement Challenge si nécessaire ;
  • renvoie un token de session unique.

Client API:

  • Pour les tests, vous pouvez utiliser:
    client-api.arkoselabs.com
  • Pour la production, il est recommandé de spécifier un domaine personnalisé:
    <company>-api.arkoselabs.com

Principales exigences

Le résultat du client est un token qui doit être envoyé au serveur.

Étape 2. Vérification côté serveur

Sur le serveur, le token est vérifié via la Arkose Verify API.

Verify API endpoint

Paramètres requis de la requête

Exemple du corps de la requête POST

La réponse de l'API contient des informations sur la session et le résultat de la vérification.

Points clés

Comment ça fonctionne :

Background
Erreurs possibles et débogage
Bug Icon
Paramètres de requête incorrects
Assurez-vous de spécifier correctement la Public Key pour le client et la Private Key pour le serveur, et de passer un session_token valide à la Verify API.
Bug Icon
session_token vide ou invalide
Le serveur recevra un résultat vide ou une erreur de vérification. Vérifiez que le client envoie correctement le token après avoir résolu le captcha.
Bug Icon
Délai de résolution dépassé
Si l'utilisateur ne termine pas le challenge à temps, le serveur Arkose peut renvoyer une erreur ou rejeter la vérification. Augmentez le délai d'attente côté serveur.
Tests de robustesse de la protection
Conseils de sécurité et d’optimisation
<b>Stockez la Private Key uniquement sur le serveur</b>, ne l'incluez jamais dans le code JS côté client.
Consignez les réponses complètes de l'API Arkose Verify, y compris le statut de vérification, le code d'erreur et les paramètres transmis — cela aide à diagnostiquer les problèmes plus rapidement.
Utilisez <b>HTTPS</b> pour toutes les requêtes (client → serveur → Verify API) afin d'éviter la falsification des données.
Placez sur le site des liens vers la <b>Politique de confidentialité</b> et les <b>Conditions d'utilisation Arkose Labs</b>, comme l'exige la licence.
Conclusion

Si vous avez récupéré un site avec un captcha ou un autre système de protection déjà installé, mais sans accès au code, pas de panique ! Il est assez simple d’identifier quelle technologie est utilisée. Pour vérifier que tout fonctionne correctement, vous pouvez utiliser le service de reconnaissance CapMonster Cloud dans un environnement de test isolé, afin de vous assurer que le mécanisme de traitement des jetons et la logique de vérification fonctionnent correctement.

Dans le cas de FunCaptcha, il suffit d’identifier le système, d’étudier son comportement et de vérifier que la protection fonctionne correctement. Dans cet article, nous avons montré comment reconnaître FunCaptcha et où trouver les instructions pour son intégration ou sa reconfiguration, afin de maintenir la protection en toute confiance et de garder son fonctionnement sous contrôle.

Conclusion
Liens utiles
DocIconDocumentation FunCaptcha (Arkose Labs CAPTCHA)DocIconFormulaire pour demander l'intégration de FunCaptchaDocIconDocumentation CapMonster Cloud (travail avec FunCaptcha)