Najczęstsze pytania

Czy mam korzystać z reCAPTCHA Enterprise?

reCAPTCHA Enterprise oferuje do 10 tys. testów miesięcznie bez opłat a także dodatkowe funkcje. Inne funkcje np. analityka w czasie rzeczywistym to dobry punkt wyjścia dla większości deweloperów. Rozpocznij 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 Dla firm. Zwykle rozwiązanie innej firmy prosi o klucz publiczny i tajny klucz albo klucz interfejsu API. Pamiętaj, aby podać tylko tajny klucz i klucz interfejsu API do zaufanych firm zewnętrznych.

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

proces migracji Zajmie to 5–10 minut i nie wymaga żadnych 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?

Podczas wykonywania reCAPTCHA ustawia niezbędny 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ć więcej niż 1000 połączeń na sekundę lub 1000000 połączeń miesięcznie, musisz użyć funkcji reCAPTCHA Enterprise lub wypełnij ten formularz i zaczekać 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, może się nie udać otworzyć witryna site_verify zwracając statyczny wynik 0,9 i wyświetlając komunikat o błędzie „Przekroczono limit”. do końca miesiąca. Nie ma żadnych informacji widocznych dla użytkowników, Witryny w wersji 3 przekraczają limit. Jeśli klucz witryny w wersji 2 przekracza limit miesięczny, to: wiadomość może być wyświetlana użytkownikom w widżecie reCAPTCHA do końca dnia miesiąca: „Ta witryna przekracza limit reCAPTCHA”. Przed wyegzekwowaniem limitów właściciele witryn 3 razy dostaną e-maila z powiadomieniem i masz co najmniej 90 dni na migrację do reCAPTCHA Enterprise. Klucze witryny są uznawane za przekroczone, jeśli zostanie wykonane ponad 1 000 000 wywołań miesięcznie dla dowolnej domeny. Bierzemy pod uwagę, że wielkość sprzedaży jest rozłożona w wielu 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 przycisku

.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, użyj adresu „www.recaptcha.net” w kodzie w przypadku, gdy adres „www.google.com” jest niedostępny.

• Najpierw zastąp <script src="https://www.google.com/recaptcha/api.js"></script> z <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
• Następnie zastosuj go na wszystkich urządzeniach, które korzystają z adresu „www.google.com/recaptcha/” w Twojej witrynie.

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

Tak. reCAPTCHA oferuje 2 motywy: jasny i ciemny, jak pokazano poniżej. Aby wybrać motyw, ustaw atrybut data-theme w 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ć, zarejestruj nowy klucz i postępuj zgodnie z instrukcjami na tej stronie.

Pojawia się nieprzechwycony błąd SecurityError: ramka o źródle „https://www.google.com” została zablokowana dostępu do ramki z punktem początkowym „&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 kontynuować wsparcie dla możesz dodać je do listy obsługiwanych domen dla Twojego klucza witryny. Przejdź do Konsola reCAPTCHA Enterprise lub w konsoli reCAPTCHA. aby zaktualizować listę obsługiwanych domen. Zalecamy używanie oddzielnych kluczy do programowania w środowisku produkcyjnym i zezwolenie na hostowanie lokalne tylko w kluczu witryny programowania.

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, do której próbujesz uzyskać dostęp, może być obecnie atakowana 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.