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 takie jak analityka w czasie rzeczywistym to najlepsze miejsce na rozpoczęcie pracy dla większości deweloperów. Zacznij tutaj.

Czy mogę używać reCAPTCHA z usługami innych firm?

Tak, możesz używać zarówno reCAPTCHA (wersja inna niż Enterprise), jak i reCAPTCHA Dla firm. Zwykle rozwiązanie zewnętrzne prosi o klucz publiczny oraz klucz tajny lub klucz API. Pamiętaj, aby podać tylko tajny klucz i klucz interfejsu API do zaufanych firm zewnętrznych.

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

Proces migracji trwa 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.

W wersji 2 zapewniamy bezpieczeństwo i wygodę użytkowania.

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 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 użyć domeny www.recaptcha.net.

Czy w przypadku korzystania z reCAPTCHA obowiązują jakieś limity dotyczące liczby zapytań na sekundę lub limitów dziennych?

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 przekroczy swój miesięczny limit, funkcja site_verify może nie otworzyć się, zwracając stały wynik 0,9 i komunikat o błędzie „Over free quota” (Powyżej bezpłatnego limitu). Do końca miesiąca. Nie ma żadnych widocznych dla użytkownika wskazań, że witryny w wersji 3 przekroczyły 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 procesie użytkownika widoczne jest oznaczenie 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ć testy automatyczne z 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 v2 użyj tych kluczy testowych. Zawsze będziesz widzieć CAPTCHA nie, a wszystkie żądania weryfikacji będą pozytywnie rozpatrywane.

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

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

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

Aby podczas debugowania innych skryptów JavaScript w witrynie nie wchodzić w kod reCAPTCHA, dodaj skrypt reCAPTCHA /recaptcha__.+\.js$ do listy ignorowanych skryptów 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ę uzyskać więcej informacji o ruchu w mojej witrynie?

reCAPTCHA raportuje statystyki dzienne w konsoli administracyjnej.

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

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 dla niewidocznej usługi reCAPTCHA działa też w przypadku wersji 3. Wystarczy użyć interfejsu JavaScript API, aby jawnie renderować reCAPTCHA za pomocą klucza witryny v3 i uzyskać dostęp do opcji takich jak zmiana położenia plakietki lub motywu.

Podczas renderowania reCAPTCHA v3 za pomocą tej metody pamiętaj, aby ustawić parametr size na wartość 'invisible' i użyć identyfikatora klienta zwracanego przez funkcję grecaptcha.render zamiast klucza witryny.

Ostatnio na moim 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 nie jest już ważny. Aby aktywować usługę, zarejestruj nowy klucz i postępuj zgodnie z instrukcjami podanymi 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. Zalecamy użycie funkcji JavaScript grecaptcha.reset(), aby zresetować widżet reCAPTCHA.

W swojej witrynie używam nagłówka 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 umieścić swój identyfikator nonce w tagu skryptu reCAPTCHA api.js, a my zajmiemy się resztą.

Uwaga: reCAPTCHA działa też w trybie „strict-dynamic” w obsługiwanych przeglądarkach.

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/

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 korzystać z tych domen na potrzeby programowania, możesz je dodać do listy obsługiwanych domen dla klucza witryny. Aby zaktualizować listę obsługiwanych domen, otwórz konsolę reCAPTCHA Enterprise lub konsolę reCAPTCHA. Zalecamy używanie oddzielnych kluczy do programowania w środowisku produkcyjnym i zezwolenie na hostowanie lokalne tylko w kluczu witryny programowania.

Tylko w iOS 10, gdy użytkownik ukończy wyzwanie, strona przewija się do dołu?

To błąd związany z ostrzeżeniem na stronie Apple, który zgłosiliśmy do firmy. 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.

Możliwe, że Twój komputer lub Twoja 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. Chcąc chronić naszych użytkowników, nie możemy teraz przetworzyć Twojej prośby.

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

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 znaki podkreślenia. Działania nie mogą być związane z konkretnymi użytkownikami.