Cennik rozwiązania reCAPTCHA v2 Enterprise
| CAPTCHA | Cena (USD) |
|---|---|
$ 1.00 1000 tokenów |
W tym artykule staraliśmy się odpowiedzieć na wszystkie najważniejsze pytania. Pierwszym krokiem w rozwiązywaniu problemu jest ustalenie, jaki system ochrony jest używany. W tym celu możesz skorzystać z listy popularnych captcha i systemów ochrony antybotowej, gdzie znajdziesz przykłady graficzne oraz kluczowe cechy, które pomogą szybko rozpoznać, z czym masz do czynienia.
Jeśli okaże się, że na Twojej stronie używany jest reCAPTCHA v2 Enterprise, kolejnym krokiem będzie dokładniejsze poznanie jej właściwości i sposobu działania. W tym artykule możesz również zapoznać się z instrukcją integracji systemu reCAPTCHA v2 Enterprise, aby w pełni zrozumieć, jak funkcjonuje on na Twojej stronie. Dzięki temu nie tylko lepiej poznasz obecną ochronę, ale też świadomie zaplanujesz jej dalsze utrzymanie.
Jak rozwiązać reCAPTCHA v2 Enterprise za pomocą CapMonster Cloud
Podczas testowania formularzy z reCAPTCHA v2 Enterprise często trzeba zweryfikować, czy captcha jest poprawnie zintegrowana i działa.
Możesz ręcznie sprawdzić captchę na swojej stronie.
- Otwórz stronę formularza i upewnij się, że captcha się wyświetla.
- Spróbuj wysłać formularz bez rozwiązania — serwer powinien zwrócić błąd.
- Po poprawnym rozwiązaniu formularz musi wysłać się bez problemów.
Do automatycznego rozwiązywania wykorzystaj narzędzia takie jak CapMonster Cloud, które przyjmują parametry captcha, przetwarzają je na serwerach i zwracają gotowy token. Wstaw go do formularza, aby przejść weryfikację bez udziału użytkownika.
Praca z CapMonster Cloud poprzez API zazwyczaj obejmuje następujące kroki:
Tworzenie zadania
Wysyłanie żądania APIW żądaniu podaj:
type - RecaptchaV2EnterpriseTask;
websiteURL - adres strony z captchą;
websiteKey - sitekey widoczny na stronie;
enterprisePayload - przekaż go, jeśli widget reCAPTCHA Enterprise wysyła dodatkowe pole s w strukturze przekazywanej do grecaptcha.enterprise.render wraz z sitekey;
pageAction - wartość action wysyłana do Google (domyślnie verify).
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV2EnterpriseTask",
"websiteURL": "https://mydomain.com/page-with-recaptcha-enterprise",
"websiteKey": "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
"pageAction": "verify",
"enterprisePayload": {
"s": "SOME_ADDITIONAL_TOKEN"
}
}
}
{
"errorId":0,
"taskId":407533072
}
Odebranie wynikuhttps://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "03AFcWeA66ZARdA5te7acD9vSwWE2hEQ2-B2aqFxm455iMA-g-Jis..."
}
}
Umieszczenie tokenu na stronieimport { chromium } from 'playwright';
import { CapMonsterCloudClientFactory, ClientOptions, RecaptchaV2EnterpriseRequest } from '@zennolab_com/capmonstercloud-client';
(async () => {
const browser = await chromium.launch({ headless: false });
const context = await browser.newContext();
const page = await context.newPage();
// 2. Otwórz stronę z captchą
await page.goto('https://example.com');
// 3. Utwórz klienta CapMonster Cloud
const cmcClient = CapMonsterCloudClientFactory.Create(
new ClientOptions({ clientKey: '<your_capmonster_cloud_api_key>' })
);
// 4. Skonfiguruj zapytanie rozwiązujące
const recaptchaRequest = new RecaptchaV2EnterpriseRequest({
websiteURL: page.url(),
websiteKey: '6Lf76sUnAAAAAIKLuWNyegRsFUfmI-3Lex3xT5N'
// enterprisePayload: { s: 'SOME_ADDITIONAL_TOKEN' } // Opcjonalny parametr enterprise
});
// 5. Rozwiąż captchę przez CapMonster
const solution = await cmcClient.Solve(recaptchaRequest);
const token = solution.solution.gRecaptchaResponse;
console.log('Token captchy:', token);
// 6. Wstaw token do ukrytego pola
await page.evaluate((t) => {
const el = document.getElementById('g-recaptcha-response');
if (el) el.value = t;
}, token);
// 7. (Opcjonalnie) wyślij formularz — dopasuj selektor
await page.click('button[data-action="submit"]');
await page.waitForTimeout(5000);
await browser.close();
})();Ponieważ reCAPTCHA Enterprise działa w Google Cloud, najpierw musisz utworzyć projekt w konsoli:
1. Przejdź do Google Cloud Console.
2. W górnym menu wybierz istniejący projekt lub kliknij Nowy projekt.
3. Wprowadź nazwę projektu, określ swoją organizację i potwierdź utworzenie.
4. Otwórz stronę API: reCAPTCHA Enterprise API i kliknij Włącz.
5. W konsoli przejdź do Utwórz klucz i kliknij Utwórz klucz.
6. Skonfiguruj podstawowe ustawienia:
- Nazwa wyświetlana: dowolna etykieta, która pomoże Ci rozpoznać klucz (np. MySite Login Page).
- Typ aplikacji: wybierz WEB (witryny) lub Aplikacja mobilna. Tego wyboru nie można później zmienić.
- Lista domen: dodaj domeny, w których ten klucz będzie używany.
Następnie otwórz Dodatkowe ustawienia, włącz opcję Czy będziesz używać wyzwań (challenges)? i aktywuj Checkbox Challenge.
7. Kliknij Utwórz. Otrzymasz klucz, który należy dodać do witryny, aby aktywować ochronę.
8. Dodaj skrypt do swojej strony.
Przykładowy fragment HTML, który możesz osadzić w swojej witrynie<html>
<head>
<title>reCAPTCHA demo: Simple page</title>
<script src="https://www.google.com/recaptcha/enterprise.js" async defer></script>
</head>
<body>
<form action="" method="POST">
<div class="g-recaptcha" data-sitekey="YOUR_SITEKEY" data-action="LOGIN"></div>
<br/>
<input type="submit" value="Submit">
</form>
</body>
</html>9. Zweryfikuj odpowiedź po stronie serwera.
Przykład w PHPToken (g-recaptcha-response) jest wysyłany do backendu.
Jest ważny przez 2 minuty, więc zweryfikuj go jak najszybciej po odebraniu! Do bezpiecznej komunikacji z API zalecamy oficjalne biblioteki Google Cloud:
<?php
require 'vendor/autoload.php';
// Zainstaluj biblioteki Google Cloud za pomocą Composer
use Google/Cloud/RecaptchaEnterprise/V1/RecaptchaEnterpriseServiceClient;
use Google/Cloud/RecaptchaEnterprise/V1/Event;
use Google/Cloud/RecaptchaEnterprise/V1/Assessment;
use Google/Cloud/RecaptchaEnterprise/V1/CreateAssessmentRequest;
use Google/Cloud/RecaptchaEnterprise/V1/TokenProperties/InvalidReason;
/**
* Zwaliduj token reCAPTCHA Enterprise i pobierz wynik ryzyka.
*
* @param string $recaptchaKey Klucz reCAPTCHA Twojej witryny/aplikacji
* @param string $token Token otrzymany od klienta
* @param string $projectId ID projektu Google Cloud
* @param string $action Nazwa akcji powiązana z tokenem
*/
function create_assessment(string $recaptchaKey, string $token, string $projectId, string $action): void {
$client = new RecaptchaEnterpriseServiceClient();
$projectName = $client->projectName($projectId);
// Utwórz zdarzenie oceny (assessment)
$event = (new Event())->setSiteKey($recaptchaKey)->setToken($token);
$assessment = (new Assessment())->setEvent($event);
$request = (new CreateAssessmentRequest())->setParent($projectName)->setAssessment($assessment);
try {
$response = $client->createAssessment($request);
if (!$response->getTokenProperties()->getValid()) {
echo 'Token jest nieprawidłowy: ' . InvalidReason::name($response->getTokenProperties()->getInvalidReason());
return;
}
if ($response->getTokenProperties()->getAction() === $action) {
echo 'Wynik ryzyka: ' . $response->getRiskAnalysis()->getScore();
} else {
echo 'Akcja w tagu reCAPTCHA nie zgadza się z oczekiwaną wartością';
}
} catch (Exception $e) {
echo 'Błąd podczas sprawdzania reCAPTCHA: ' . $e->getMessage();
}
}
// Wywołaj funkcję z podanymi zmiennymi
create_assessment(
'YOUR_SITE_KEY',
'YOUR_USER_RESPONSE_TOKEN',
'YOUR_PROJECT_ID',
'YOUR_RECAPTCHA_ACTION'
);
?>
Obsługiwane captchas
reCAPTCHA v2reCAPTCHA v3reCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
FriendlyJeśli przejąłeś stronę internetową, na której jest już zainstalowany captcha lub inny system zabezpieczeń, a jednocześnie nie masz dostępu do kodu — to nic strasznego! Dość łatwo jest ustalić, jaka dokładnie technologia jest używana. Aby sprawdzić poprawność działania, możesz skorzystać z usługi rozpoznawania CapMonster Cloud w odizolowanym środowisku testowym, żeby upewnić się, że mechanizm przetwarzania tokenów i logika weryfikacji działają prawidłowo.
W przypadku reCAPTCHA v2 Enterprise wystarczy rozpoznać system, przeanalizować jego zachowanie i upewnić się, że zabezpieczenie działa poprawnie. W artykule pokazaliśmy, jak zidentyfikować reCAPTCHA v2 Enterprise oraz gdzie znaleźć instrukcje dotyczące jego podłączenia lub ponownej konfiguracji, aby móc pewnie utrzymywać ochronę i kontrolować jej działanie.
Najczęściej zadawane pytania o reCAPTCHA v2 Enterprise
