API CapMonster Cloud
Extension pour navigateurs
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 reCAPTCHA V2, 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 reCAPTCHA V2 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.
Lors des tests de formulaires contenant reCAPTCHA V2, il est souvent nécessaire de vérifier que la captcha fonctionne et qu’elle est correctement intégrée.
Vous pouvez contrôler manuellement la captcha intégrée à votre site.
Pour une résolution automatique, utilisez des outils comme CapMonster Cloud qui reçoivent les paramètres de la captcha, les traitent sur leurs serveurs et renvoient un jeton prêt à l’emploi. Insérez ce jeton dans le formulaire pour passer la vérification sans interaction utilisateur.
Travailler avec CapMonster Cloud via l’API comprend généralement les étapes suivantes :
Création de la tâche
Envoyer une requête APIVotre requête pour résoudre reCAPTCHA v2 doit inclure les paramètres suivants :
type - RecaptchaV2Task;
websiteURL - l’adresse de la page où apparaît la captcha;
websiteKey - le sitekey indiqué sur votre page avec la captcha.
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV2Task",
"websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
"websiteKey": "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
}
}
{
"errorId":0,
"taskId":407533072
}
Réception du résultathttps://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "03AFcWeA66ZARdA5te7acD9vSwWE2hEQ2-B2aqFxm455iMA-g-Jis…"
}
}
Insertion du jeton sur la page// npm install playwright @zennolab_com/capmonstercloud-client
// npx playwright install chromium
const { chromium } = require('playwright');
const { CapMonsterCloudClientFactory, ClientOptions, RecaptchaV2Request } = require('@zennolab_com/capmonstercloud-client');
(async () => {
const browser = await chromium.launch({ headless: false });
const page = await browser.newPage();
const TARGET_URL = 'https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high';
const WEBSITE_KEY = '6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd';
const CMC_API_KEY = 'your_capmonster_cloud_api_key';
const cmc = CapMonsterCloudClientFactory.Create(new ClientOptions({ clientKey: CMC_API_KEY }));
await page.goto(TARGET_URL, { waitUntil: 'domcontentloaded' });
// Résolution de la captcha
const solution = await cmc.Solve(new RecaptchaV2Request({ websiteURL: TARGET_URL, websiteKey: WEBSITE_KEY }));
const token = solution.solution.gRecaptchaResponse;
// Insérez le jeton et envoyez le formulaire (remplacez par le sélecteur souhaité)
await page.evaluate((t) => {
const ta = document.querySelector('textarea#g-recaptcha-response');
if (ta) ta.value = t;
document.querySelector('form.formular')?.submit();
}, token);
console.log('Captcha résolue et formulaire envoyé !');
})();1. Accédez à la page de la console d’administration reCAPTCHA.
2. Enregistrez un nouveau site.
Choisissez le type de captcha — reCAPTCHA v2 (case à cocher avec défis ou variante invisible).
3. Obtenez deux clés :
Ouvrez les paramètres pour préciser les domaines autorisés à utiliser reCAPTCHA ou pour choisir le niveau de sécurité, du plus simple au plus strict.
4. Exemple de code côté client. Formulaire HTML avec reCAPTCHA v2 (vous pouvez coller cet extrait dans le corps de la page) :
Formulaire HTML avec reCAPTCHA v2Pour le widget avec case :
<html>
<head>
<title>reCAPTCHA demo</title>
<script src="https://www.google.com/recaptcha/api.js" async defer></script>
</head>
<body>
<form action="submit" method="POST">
<div class="g-recaptcha" data-sitekey="your_site_key"></div>
<br/>
<input type="submit" value="Submit">
</form>
</body>
</html>Ce code charge la bibliothèque Google reCAPTCHA et crée un formulaire qui envoie les données en POST. <div class="g-recaptcha" data-sitekey="your_site_key"></div> affiche le widget reCAPTCHA v2 avec votre clé publique. En cliquant sur "Submit", le formulaire est envoyé avec le jeton g-recaptcha-response pour vérification côté serveur.
Pour reCAPTCHA v2 invisible :
<html>
<head>
<title>reCAPTCHA demo</title>
<script src="https://www.google.com/recaptcha/api.js" async defer></script>
<script>
function onSubmit(token) {
document.getElementById("demo-form").submit();
}
</script>
</head>
<body>
<form id="demo-form" action="?" method="POST">
<button class="g-recaptcha" data-sitekey="your_site_key" data-callback="onSubmit">Submit</button>
<br/>
</form>
</body>
</html>Le bouton <button class="g-recaptcha" data-sitekey="your_site_key" data-callback="onSubmit">Submit</button> exécute automatiquement la captcha invisible, génère un jeton et appelle onSubmit.
La fonction onSubmit(token) reçoit le jeton g-recaptcha-response et envoie le formulaire à votre serveur pour vérification.
Contrairement au widget avec case, l’utilisateur ne voit pas la captcha : la vérification se déroule en arrière-plan.
5. Validez la réponse côté serveur.
Exemple en PHPVérifier la méthode et lire les données
?php
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
http_response_code(405);
exit('Méthode non autorisée');
}
// Récupération du jeton reCAPTCHA
$token = $_POST['g-recaptcha-response'] ?? '';
$secret = 'YOUR_SECRET_KEY';
if (!$token) {
exit('Captcha non validée');
}Vérifier la captcha via Google
$response = file_get_contents(
"https://www.google.com/recaptcha/api/siteverify?secret=$secret&response=$token"
);
$result = json_decode($response, true);
if (!empty($result['success'])) {
echo "<h3>Formulaire envoyé avec succès !</h3>";
} else {
echo "Erreur de vérification de la captcha.";
}
?>
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 reCAPTCHA V2, 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 reCAPTCHA V2 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.
Documentation reCAPTCHA v2 →Documentation CapMonster Cloud (reCAPTCHA v2) →Résoudre reCAPTCHA v2 avec CapMonster Cloud →Comment résoudre reCAPTCHA v2 en JavaScript avec Selenium & CapMonster Cloud →Comment résoudre reCAPTCHA v2 en Python avec Selenium & CapMonster Cloud →Comment résoudre reCAPTCHA v2 en C# avec Selenium & CapMonster Cloud →