Najczęstsze pytania

Czy warto używać reCAPTCHA Enterprise?

reCAPTCHA Enterprise oferuje do 10 tys. ocen miesięcznie bez opłat i zapewnia dodatkowe funkcje. Inne funkcje , takie jak Analityka 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 (wersji niekomercyjnej), jak i reCAPTCHA Enterprise. Zwykle rozwiązanie innej firmy prosi o klucz publiczny oraz klucz tajny lub klucz interfejsu API. Pamiętaj, aby udostępniać klucz obiektu tajnego i klucz interfejsu API tylko zaufanym firmom.

Jak przeprowadzić migrację z reCAPTCHA w wersji 2 lub 3 do reCAPTCHA Enterprise?

Proces migracji trwa 5–10 minut i nie wymaga 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 wygodę użytkowania.

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?

Gdy usługa reCAPTCHA jest uruchamiana w celu przeprowadzenia analizy ryzyka, ustawia niezbędny plik cookie (_GRECAPTCHA). Jeśli nie chcesz używać domeny www.google.com, w której mogą być ustawione inne pliki cookie, możesz zamiast niej użyć domeny www.recaptcha.net.

Czy istnieją limity zapytań na sekundę lub limity dzienne dotyczące korzystania z reCAPTCHA?

Jeśli chcesz wykonywać więcej niż 1000 wywołań na sekundę lub 1 000 000 wywołań miesięcznie, musisz używać reCAPTCHA Enterprise lub wypełnić ten formularz i poczekać na zatwierdzenie wyjątku. Jeśli klucz witryny przekracza 1000 zapytań na sekundę, niektóre żądania mogą nie zostać przetworzone. Jeśli klucz witryny w wersji 3 przekroczy miesięczny limit, funkcja site_verify może zwracać stały wynik 0,9 i komunikat o błędzie „Over free quota” (Przekroczono bezpłatny limit) do końca miesiąca. Gdy witryny w wersji 3 przekroczą limit, użytkownicy nie zobaczą żadnych powiadomień. Jeśli klucz witryny w wersji 2 przekroczy miesięczny limit, użytkownikom może się wyświetlać w widżecie reCAPTCHA następujący lub podobny komunikat: „Ta witryna przekracza limit reCAPTCHA”. Właściciele witryn będą 3 razy powiadamiani e-mailem o przekroczeniu limitu, zanim zaczniemy egzekwować limit. 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żywanych jest więcej niż 1 000 000 wywołań miesięcznie. Dotyczy to również sytuacji, gdy ten wolumin jest rozłożony na wiele kluczy w tej samej domenie.

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

Możesz ukryć plakietkę, o ile w sposób widoczny umieścisz logo reCAPTCHA w procesie użytkownika. Wpisz ten tekst:

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

Na przykład:

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

.grecaptcha-badge { visibility: hidden; }

Chcę przeprowadzać automatyczne testy z użyciem reCAPTCHA. Co mam zrobić?

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

W przypadku reCAPTCHA v2 użyj tych kluczy testowych. Zawsze otrzymasz odpowiedź „No CAPTCHA” i wszystkie żądania weryfikacji zostaną zaakceptowane.

• Klucz witryny: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• Klucz obiektu tajnego: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

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

Jak mogę uniknąć wchodzenia w kod reCAPTCHA podczas debugowania witryny?

Aby uniknąć wchodzenia w kod reCAPTCHA podczas debugowania innego kodu JavaScript w witrynie, dodaj skrypt reCAPTCHA /recaptcha__.+\.js$ do listy ignorowanych 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ę wyświetlić więcej informacji o ruchu w mojej witrynie?

reCAPTCHA raportuje dzienne statystyki w konsoli administracyjnej.

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

Tak, w sytuacjach, gdy „www.google.com” jest niedostępny, użyj w kodzie adresu „www.recaptcha.net”.

• Najpierw zastąp ciąg <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ę w każdym innym miejscu w witrynie, w którym 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, po prostu ustaw atrybut data-theme w parametrze grecaptcha.render.

Jasny motyw:

Ciemny motyw:

Jak mogę dostosować reCAPTCHA v3?

Interfejs JavaScript API dostępny w przypadku niewidocznej reCAPTCHA działa też w wersji 3. Aby uzyskać dostęp do opcji takich jak zmiana położenia plakietki czy zmiana motywu, wystarczy użyć interfejsu JavaScript API do jawnego renderowania reCAPTCHA za pomocą klucza witryny w wersji 3.

Podczas renderowania reCAPTCHA v3 tą metodą pamiętaj, aby ustawić parametr size na 'invisible' i używać identyfikatora klienta zwróconego przez grecaptcha.render podczas wywoływania grecaptcha.execute zamiast klucza witryny.

Ostatnio w widżecie reCAPTCHA zaczął się 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ć klucz, zarejestruj nowy klucz i postępuj zgodnie z instrukcjami na tej stronie.

Pojawia się nieobsłużony błąd SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "&ltyour domain&gt". Co mam zrobić?

Zwykle ma to miejsce, gdy element HTML widżetu reCAPTCHA jest programowo usuwany jakiś czas po kliknięciu pola wyboru przez użytkownika. Aby zresetować widżet reCAPTCHA, zalecamy użycie funkcji JavaScript grecaptcha.reset().

W mojej witrynie używam standardu Content Security Policy (CSP). Jak skonfigurować go do współpracy z reCAPTCHA?

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

Uwaga: reCAPTCHA działa też z wartością „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 mi się błąd „Localhost is not in the list of supported domains” (Localhost nie należy do listy obsługiwanych domen). Co mam zrobić?

Domeny localhost nie są domyślnie obsługiwane. Jeśli chcesz nadal obsługiwać te domeny na potrzeby programowania, 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 deweloperskiej.

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

To błąd ostrości po stronie Apple, który zgłosiliśmy tej firmie. Dotyczy to tylko użytkowników iOS 10 i tylko niektórych witryn. Jeśli ten problem Cię dotyczy, możesz przenieść widżet reCAPTCHA wyżej lub niżej na stronie albo użyć reCAPTCHA w wersji 3.

Czy mój komputer lub moja sieć mogą wysyłać automatyczne zapytania?

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

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

• Możesz korzystać z udostępnionej sieci, która jest wykorzystywana w sposób niezgodny z zasadami.
• 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 poddawana intensywnemu atakowi.

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ć powiązane z konkretnym użytkownikiem.