Najczęstsze pytania

Czy warto używać reCAPTCHA Enterprise?

reCAPTCHA Enterprise oferuje do 10 tys. testów miesięcznie bez opłat,a także dodatkowe funkcje. Inne funkcje, takie jak statystyki w czasie rzeczywistym, to najlepsze miejsce na początek dla większości deweloperów. Zacznij tutaj.

Czy mogę używać reCAPTCHA z rozwiązaniami innych firm?

Tak, możesz używać zarówno reCAPTCHA (wersja inna niż Enterprise), jak i reCAPTCHA Enterprise. Zwykle rozwiązanie innej firmy prosi o klucz publiczny oraz klucz obiektu tajnego lub klucz interfejsu API. Pamiętaj, aby podawać klucz obiektu tajnego i klucz interfejsu API tylko zaufanym osobom trzecim.

Jak przejść na reCAPTCHA Enterprise z wersji 2 lub 3?

Proces migracji trwa 5–10 minut i nie wymaga żadnych zmian w kodzie.

Czy mam używać reCAPTCHA w wersji 2 czy 3?

reCAPTCHA w wersji 3 jest przeznaczona dla właścicieli witryn, którzy chcą uzyskać więcej danych o ruchu. Więcej informacji znajdziesz w przewodniku dla programistów reCAPTCHA w wersji 3.

W przypadku wersji 2 dbamy o bezpieczeństwo i użyteczność.

Więcej informacji o różnicach między reCAPTCHA w wersji 2 i 3 znajdziesz w porównaniu wersji.

Czy reCAPTCHA używa plików cookie?

reCAPTCHA ustawia niezbędny plik cookie (_GRECAPTCHA) podczas wykonywania analizy ryzyka. Jeśli nie chcesz używać domeny www.google.com, która może mieć ustawione inne pliki cookie, możesz zamiast niej użyć domeny www.recaptcha.net.

Czy korzystanie z reCAPTCHA podlega limitom zapytań na sekundę lub limitom dziennym?

Jeśli chcesz wykonywać więcej niż 1000 wywołań na sekundę lub 1 000 000 wywołań miesięcznie, musisz użyć reCAPTCHA Enterprise lub wypełnić ten formularz i poczekać na zatwierdzenie wyjątku. Jeśli klucz witryny przekroczy 1000 zapytań na sekundę, niektóre żądania mogą nie zostać przetworzone. Jeśli klucz witryny w wersji 3 przekroczy miesięczny limit, `site_verify` może nie działać prawidłowo i zwracać stały wynik 0,9 oraz komunikat o błędzie `"Over free quota."` do końca miesiąca. Gdy witryny w wersji 3 przekroczą limit, nie są wyświetlane żadne powiadomienia widoczne dla użytkowników. Jeśli klucz witryny w wersji 2 przekroczy miesięczny limit, do końca miesiąca w widżecie reCAPTCHA może wyświetlać się użytkownikom następujący lub podobny komunikat: `Ta witryna przekracza limit reCAPTCHA`.Zanim limit zostanie wyegzekwowany, właściciele witryn otrzymają 3 powiadomienia e-mailem i będą mieli co najmniej 90 dni na przejście na reCAPTCHA Enterprise. Klucze witryny są uznawane za przekraczające limit, jeśli w przypadku dowolnej domeny użyto ponad 1 000 000 wywołań miesięcznie. Dotyczy to również sytuacji, gdy ten wolumen jest rozłożony na wiele kluczy w tej samej domenie.

Chcę ukryć plakietkę reCAPTCHA. Co jest dozwolone?

Możesz ukryć plakietkę, pod warunkiem że w widoczny sposób umieścisz logo reCAPTCHA we wzorcu przeglądania. Dołącz ten tekst:

This site is protected by reCAPTCHA.

Na przykład:

Uwaga: jeśli zdecydujesz się ukryć plakietkę, użyj

.grecaptcha-badge { visibility: hidden; }

Chcę przeprowadzać automatyczne testy za pomocą reCAPTCHA. Co mam zrobić?

W przypadku reCAPTCHA w wersji 3 utwórz osobny klucz dla środowisk testowych. Wyniki mogą być niedokładne, ponieważ reCAPTCHA w wersji 3 opiera się na rzeczywistym ruchu.

W przypadku reCAPTCHA w wersji 2 użyj tych kluczy testowych. Zawsze będziesz otrzymywać No CAPTCHA, a wszystkie żądania weryfikacji będą przechodzić pomyślnie.

• Klucz witryny: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• Klucz tajny: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Widżet reCAPTCHA wyświetli komunikat ostrzegawczy, aby upewnić się, że nie jest używany do ruchu produkcyjnego.

Jak uniknąć przechodzenia do kodu reCAPTCHA podczas debugowania witryny?

Aby uniknąć przechodzenia do kodu reCAPTCHA podczas debugowania innego kodu JavaScript w witrynie, dodaj skrypt reCAPTCHA /recaptcha__.+\.js$ do listy ignorowanych fragmentów kodu w przeglądarce. Instrukcje dotyczące Chrome znajdziesz w artykule Ignorowanie niestandardowej listy skryptów. Podobne funkcje są dostępne w innych przeglądarkach.

Jak mogę dowiedzieć się więcej o ruchu w mojej witrynie?

reCAPTCHA raportuje dzienne statystyki w konsoli administracyjnej.

Czy mogę używać reCAPTCHA na całym świecie?

Tak, użyj „www.recaptcha.net” w kodzie, jeśli „www.google.com” jest niedostępne.

• Najpierw zastąp <script src="https://www.google.com/recaptcha/api.js"></script> ciągiem <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
• Następnie zastosuj tę samą zmianę we wszystkich innych miejscach w witrynie, w których używany jest adres „www.google.com/recaptcha/”.

Czy mogę dostosować widżet lub plakietkę reCAPTCHA?

Tak. reCAPTCHA oferuje 2 motywy, jasny i ciemny, jak pokazano poniżej. Aby wybrać motyw, wystarczy ustawić atrybut data-theme w parametrze grecaptcha.render.

Jasny motyw:

Ciemny motyw:

Jak mogę dostosować reCAPTCHA w wersji 3?

Interfejs JavaScript API dostępny w przypadku niewidocznej reCAPTCHA działa też w wersji 3. Wystarczy użyć interfejsu JavaScript API, aby wyraźnie wyrenderować reCAPTCHA za pomocą klucza witryny w wersji 3 i uzyskać dostęp do opcji takich jak zmiana położenia plakietki lub zmiana motywu.

Podczas renderowania reCAPTCHA w wersji 3 za pomocą tej metody pamiętaj, aby ustawić parametr size na 'invisible' i użyć identyfikatora klienta zwróconego przez grecaptcha.render podczas wywoływania grecaptcha.execute zamiast klucza witryny.

Od niedawna mój widżet reCAPTCHA wyświetla komunikat „Nieprawidłowy klucz witryny”. Co się dzieje?

Jeśli widzisz ten błąd, oznacza to, że klucz witryny reCAPTCHA utracił ważność. Aby aktywować, zarejestruj nowy klucz i postępuj zgodnie z instrukcjami na tej stronie.

Wyświetla mi się nieprzechwycony błąd SecurityError: zablokowano ramkę ze źródła „https://www.google.com” przed dostępem do ramki ze źródła „<Twoja domena>”. Co mam zrobić?

Zwykle dzieje się tak, gdy element HTML widżetu reCAPTCHA zostanie usunięty programowo po kliknięciu pola wyboru przez użytkownika. Zalecamy użycie funkcji JavaScript grecaptcha.reset(), aby zresetować widżet reCAPTCHA.

W mojej witrynie używam standardu Content Security Policy (CSP). Jak mogę skonfigurować go do działania z reCAPTCHA?

Zalecamy użycie podejścia opartego na liczbie jednorazowej, które jest opisane w dokumentacji CSP3. Pamiętaj, aby uwzględnić liczbę jednorazową w tagu skryptu api.js reCAPTCHA, a my zajmiemy się resztą.

Uwaga: reCAPTCHA działa też z dyrektywą 'strict-dynamic' w przeglądarkach, które ją obsługują.

Możesz też dodać do dyrektyw te wartości:

• script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
• frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
• connect-src https://www.google.com/recaptcha/

Wyświetla się błąd „Localhost is not in the list of supported domains” (Localhost nie znajduje się na liście obsługiwanych domen). Co mam zrobić?

Domeny localhost nie są domyślnie obsługiwane. Jeśli chcesz nadal obsługiwać je na potrzeby programistyczne, możesz dodać je do listy obsługiwanych domen dla klucza witryny. Otwórz konsolę reCAPTCHA Enterprise lub konsolę reCAPTCHA, aby zaktualizować listę obsługiwanych domen. Zalecamy używanie osobnych kluczy do programowania i produkcji oraz zezwalanie na localhost tylko w przypadku klucza witryny programistycznej.

Czy tylko w systemie iOS 10 strona przewija się na dół, gdy użytkownik ukończy wyzwanie?

Jest to błąd związany z ustawianiem ostrości po stronie Apple, który został przez nas zgłoszony. Problem dotyczy tylko użytkowników systemu iOS 10 i tylko niektórych witryn. Jeśli ten problem dotyczy Twojej witryny, możesz go obejść, przenosząc widżet reCAPTCHA wyżej lub niżej na stronie albo używając reCAPTCHA w wersji 3.

Mój komputer lub moja sieć może wysyłać automatyczne zapytania?

Jeśli przekierowano Cię na tę stronę z widżetu reCAPTCHA, wyświetlił się komunikat „Przepraszamy, ale Twój komputer lub Twoja sieć może wysyłać automatyczne zapytania. Aby chronić naszych użytkowników, nie możemy teraz przetworzyć Twojej prośby”.

Może się to zdarzyć z kilku powodów:

• Być może korzystasz z sieci udostępnionej, która jest używana w niewłaściwy sposób.
• Dostawca usług internetowych mógł niedawno przypisać Ci podejrzany adres IP.
• Witryna, do której próbujesz uzyskać dostęp, może być obecnie celem intensywnego ataku

Aby rozwiązać te problemy, zapoznaj się ze stroną pomocy dotyczącą nietypowego ruchu lub spróbuj ponownie później.

Jakie nazwy działań są prawidłowe?

Działania mogą zawierać tylko znaki alfanumeryczne, ukośniki i podkreślenia. Działania nie mogą być związane z konkretnym użytkownikiem.