Najczęstsze pytania

Czy mam korzystać z reCAPTCHA Enterprise?

reCAPTCHA Enterprise oferuje do 10 tys. ocen miesięcznie bez opłat i udostępnia dodatkowe funkcje. Większości deweloperów najlepiej zacząć od innych funkcji, takich jak analityka w czasie rzeczywistym. Wypróbuj

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

Tak, możesz używać zarówno reCAPTCHA (w wersji innej niż Enterprise), jak i reCAPTCHA Enterprise. Zazwyczaj rozwiązanie innej firmy prosi o podanie klucza publicznego i klucza tajnego lub klucza interfejsu API. Tajny klucz i klucz interfejsu API udostępniaj tylko zaufanym firmom zewnętrznym.

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

Proces migracji może potrwać 5–10 minut i nie wymaga wprowadzania zmian w kodzie.

Używam 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.

Dbamy o bezpieczeństwo i łatwość obsługi wersji 2.

Więcej informacji o różnicach między reCAPTCHA w wersjach 2 i 3 znajdziesz w sekcji Porównanie wersji.

Czy reCAPTCHA używa plików cookie?

reCAPTCHA ustawia wymagany plik cookie (_GRECAPTCHA) na potrzeby analizy ryzyka. Jeśli nie chcesz używać domeny www.google.com, w której mogą być ustawione inne pliki cookie, możesz użyć www.recaptcha.net.

Czy podczas korzystania z reCAPTCHA obowiązują jakieś limity zapytań na sekundę lub limity dzienne?

Jeśli chcesz wykonywać ponad 1000 wywołań na sekundę lub 1000 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 przekracza 1000 zapytań na sekundę, niektóre żądania mogą nie zostać przetworzone. Jeśli klucz witryny w wersji 3 przekracza limit miesięczny, witryna site_verify może się nie otworzyć przez zwrócenie wyniku statycznego 0,9 i komunikatu o błędzie „Przekroczono limit.” do końca miesiąca. Brak widocznych dla użytkowników informacji o tym, że witryny w wersji 3 przekraczają limit. Jeśli klucz witryny w wersji 2 Klucze witryny są uznawane za przekroczone limit, jeśli w którejkolwiek domenie używanych jest ponad 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 widocznym miejscu w ścieżce użytkownika znajduje się wyraźnie widoczna marka reCAPTCHA. Podaj 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 chcesz 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 oddzielny klucz dla środowisk testowych. Wyniki mogą nie być dokładne, ponieważ reCAPTCHA w wersji 3 wymaga śledzenia rzeczywistego ruchu.

W przypadku reCAPTCHA w wersji 2 użyj poniższych kluczy testowych. Zawsze wyświetli się Brak CAPTCHA, a wszystkie żądania weryfikacji zostaną zaakceptowane.

• Klucz witryny: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• Tajny klucz: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Widżet reCAPTCHA będzie wyświetlać ostrzeżenie, aby sprawdzić, czy nie jest on używany w ruchu produkcyjnym.

Jak uniknąć logowania się w kodzie 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 fragmentów przeglądarki. Instrukcje dotyczące Chrome znajdziesz w artykule Ignorowanie niestandardowej listy skryptów. Podobne funkcje są dostępne w innych przeglądarkach.

Jak mogę uzyskać więcej informacji o ruchu w mojej witrynie?

reCAPTCHA raportuje dzienne statystyki w konsoli administracyjnej.

Czy mogę używać reCAPTCHA globalnie?

Tak, należy używać w kodzie „www.recaptcha.net” w przypadkach, gdy witryna „www.google.com” nie jest dostępna.

• 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 go na wszystkich innych stronach, które korzystają z adresu „www.google.com/recaptcha/” w swojej witrynie.

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 dostosować reCAPTCHA w wersji 3?

Interfejs JavaScript API dostępny w przypadku Invisible reCAPTCHA działa również w wersji 3. Wystarczy, że użyjesz interfejsu JavaScript API, aby bezpośrednio wyrenderować reCAPTCHA za pomocą klucza witryny w wersji 3, aby uzyskać dostęp do opcji takich jak zmiana położenia plakietki czy 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 przy wywoływaniu funkcji grecaptcha.execute zamiast klucza witryny.

Mój widżet reCAPTCHA zaczął ostatnio wyświetlać komunikat „Nieprawidłowy klucz witryny”. Co się dzieje?

Jeśli widzisz ten błąd, oznacza to, że klucz witryny reCAPTCHA nie jest już prawidłowy. Aby aktywować klucz, zarejestruj nowy klucz i postępuj zgodnie z instructions na tej stronie.

Widzę nieprzechwycony błąd SecurityError: ramka z pierwotnym źródłem „https://www.google.com” zablokowała dostęp do ramki o źródle „&lttwoja domena&gt”. Co mam zrobić?

Dzieje się tak zwykle wtedy, gdy element HTML widżetu reCAPTCHA zostanie automatycznie usunięty jakiś czas po kliknięciu tego pola przez użytkownika. Do zresetowania widżetu reCAPTCHA zalecamy użycie funkcji JavaScript grecaptcha.reset().

W swojej witrynie używam Content-Security-Policy (CSP). Jak mogę skonfigurować tę usługę pod kątem współpracy z reCAPTCHA?

Zalecamy stosowanie metody opartej na liczbie jednorazowej udokumentowanej w CSP3. Pamiętaj, aby uwzględnić identyfikator jednorazowy w tagu skryptu reCAPTCHA api.js, a my zajmiemy się resztą.

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

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

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

Pojawia się błąd „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 wspierać te domeny w programowaniu, możesz dodać je do listy obsługiwanych domen dla Twojego klucza witryny. Otwórz konsolę reCAPTCHA Enterprise lub odpowiednio konsolę reCAPTCHA, aby zaktualizować listę obsługiwanych domen. Zalecamy używanie osobnych kluczy do programowania i produkcji oraz zezwalanie w kluczu witryny programistycznej tylko na host lokalny.

Tylko w systemie iOS 10 strona przewija się w dół, gdy użytkownik wykonuje zadanie?

Jest to błąd skupiony na stronie firmy Apple, który mu zawiadomiliśmy. Dotyczy to tylko użytkowników urządzeń z systemem iOS 10 i tylko w niektórych witrynach. W tym przypadku możesz obejść ten problem, przenosząc widżet reCAPTCHA wyżej lub niżej na stronie albo używając funkcji reCAPTCHA v3.

Być może mój komputer lub sieć wysyła automatyczne zapytania?

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

Może się tak zdarzyć w przypadku dobrych użytkowników z kilku powodów:

• Być może korzystasz z sieci współdzielonej, która jest nadużywana.
• Twój dostawca usług internetowych mógł ostatnio przypisać Ci podejrzany adres IP
• Strona, którą próbujesz otworzyć, może być obecnie zaatakowana intensywnie

Aby rozwiązać te problemy, przeczytaj informacje na stronie pomocy dotyczącej nietypowego ruchu lub spróbuj ponownie później.

Które 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 konkretnymi użytkownikami.