Najczęstsze pytania

Czy mam korzystać z reCAPTCHA Enterprise?

reCAPTCHA Enterprise oferuje milion bezpłatnych testów miesięcznie. Inne funkcje, takie jak analityka w czasie rzeczywistym, to najlepsze rozwiązanie na początek dla większości deweloperów. Rozpocznij tutaj bezpłatnie

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

Tak. Możesz używać jednocześnie usługi reCAPTCHA (w wersji innej niż Enterprise) i reCAPTCHA Enterprise. Zwykle rozwiązanie innej firmy wymaga podania klucza publicznego oraz tajnego klucza lub klucza interfejsu API. Pamiętaj, aby podawać swój tajny klucz i klucz interfejsu API 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 żadnych zmian w kodzie.

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

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

Zapewniamy bezpieczeństwo i użyteczność wersji 2.

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

Czy mogę uruchomić reCAPTCHA w wersjach 2 i 3 na tej samej stronie?

Aby to zrobić, wczytaj klucz witryny v3 jako udokumentowany, a następnie wyraźnie wyrenderuj wersję 2 za pomocą grecaptcha.render.

<html>
  <head>
    <title>reCAPTCHA demo: Running both v2 and v3</title>
    <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script>
    <script>
      grecaptcha.ready(() => {
        grecaptcha.render('html_element', {
           'sitekey' : 'v2_site_key'
        });
      });
    </script>
    <script>
      function onSubmit() {
        grecaptcha.ready(() => {
            grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => {
               ...
            });
        });
      }
    </script>
  </head>
</html>

Czy reCAPTCHA używa plików cookie?

reCAPTCHA uruchamia niezbędny plik cookie (_GRECAPTCHA) w celu przeprowadzenia analizy ryzyka. Jeśli nie chcesz korzystać z domeny www.google.com, która może ustawiać inne pliki cookie, możesz użyć adresu www.recaptcha.net.

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

Jeśli chcesz wykonywać więcej niż 1000 połączeń na sekundę lub 1000 000 miesięcznie, musisz użyć CAPTCHA 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 być przetwarzane. Jeśli klucz witryny w wersji 3 przekracza miesięczny limit, narzędzie site_verify nie przejdzie do końca miesiąca, wybierając statyczny wynik 0,9 i komunikat o błędzie „Przekroczono limit”. Gdy liczba witryn w wersji 3 przekracza limit, nie ma żadnych wskaźników widocznych dla użytkowników. Jeśli klucz witryny w wersji 2 przekracza miesięczny limit, do końca miesiąca może wyświetlić się następujący widżet (lub inny podobny) użytkownikom: Jeśli w danej domenie używanych jest więcej niż 1 000 000 wywołań miesięcznie, klucze witryny są uznawane za przekraczające limit. Obejmuje to także to, czy wolumin jest rozłożony na kilka kluczy w tej samej domenie.

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

Możesz ukryć plakietkę, pod warunkiem że wyraźnie umieszczasz markę reCAPTCHA w przepływie pracy 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.

Przykład:

Uwaga: jeśli chcesz ukryć plakietkę, użyj wartości 

.grecaptcha-badge { visibility: hidden; }

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

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

W przypadku reCAPTCHA v2 użyj poniższych kluczy testowych. Nie otrzymasz żadnego obrazka CAPTCHA, a wszystkie prośby o weryfikację zostaną zaliczone.

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

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

Jak mogę uzyskać 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, wpisz „www.recaptcha.net” w swoim kodzie, jeśli witryna „www.google.com” jest niedostępna.

  • Najpierw zastąp <script src="https://www.google.com/recaptcha/api.js" async defer></script> kodem <script src="https://www.recaptcha.net/recaptcha/api.js" async defer></script>
  • Następnie zastosuj to samo ustawienie w pozostałych miejscach w witrynie, które korzystają z adresu „www.google.com/recaptcha/”.

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

Tak. reCAPTCHA udostępnia 2 motywy: jasny i ciemny, jak pokazano poniżej. Aby wybrać motyw, ustaw atrybut data-theme w parametrze grecaptcha.render.

Jasny motyw:

Tryb ciemny:

Jak dostosować reCAPTCHA w wersji 3?

Interfejs JavaScript API dostępny dla Invisible reCAPTCHA działa też w wersji 3. Wystarczy użyć interfejsu JavaScript API, aby srenderować reCAPTCHA z kluczem witryny v3, aby uzyskać dostęp do opcji takich jak zmiana pozycji plakietki czy zmiana motywu.

Renderując przy użyciu tej metody usługę reCAPTCHA w wersji 3, ustaw parametr size na 'invisible' i użyj identyfikatora klienta zwróconego przez grecaptcha.render podczas wywoływania grecaptcha.execute zamiast klucza witryny.

Od niedawna widżet reCAPTCHA wyświetla komunikat „Nieprawidłowy klucz witryny”. Co tu się odbywa?

Jeśli widzisz ten błąd, Twój klucz reCAPTCHA będzie już nieważny. Aby aktywować klucz, zarejestruj nowy klucz i postępuj zgodnie z instrukcjami podanymi na tej stronie.

Występuje nieprzechwycony błąd SecurityError: ramka o źródle „https://www.google.com” została zablokowana, by nie miał dostępu do ramki o źródle „&lttwoja domena&gt”. Co mam zrobić?

Zwykle ma to miejsce, gdy element HTML widżetu reCAPTCHA jest automatycznie usuwany jakiś czas po kliknięciu tego pola przez użytkownika. Zalecamy resetowanie widżetu reCAPTCHA za pomocą funkcji JavaScript grecaptcha.reset().

Korzystam z Content-Security-Policy (CSP) w swojej witrynie. Jak skonfigurować go do współpracy z reCAPTCHA?

Zalecamy stosowanie podejścia opartego na jednorazowych rozwiązaniach opisanych w dokumencie CSP3. Pamiętaj, aby umieścić swoją wartość cząstkową w tagu skryptu reCAPTCHA api.js, a my zajmiemy się resztą.

Uwaga: reCAPTCHA współpracuje też z „strict-dynamic” w przeglądarkach, które obsługują tę funkcję.

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 „Host lokalny nie znajduje się na liście obsługiwanych domen”. Co mam zrobić?

Domeny lokalne localhost nie są domyślnie obsługiwane. Jeśli chcesz, aby nadal były obsługiwane przez dewelopera, możesz dodać je do listy domen obsługiwanych przez Twój klucz witryny. Otwórz konsolę reCAPTCHA Enterprise lub konsolę reCAPTCHA, aby zaktualizować listę obsługiwanych domen. Zalecamy używanie osobnych kluczy na potrzeby środowiska deweloperskiego i produkcyjnego oraz pozwalanie wyłącznie na host lokalny w kluczu witryny programistycznej.

Tylko w iOS 10 przewija stronę w dół, gdy użytkownik ukończy wyzwanie?

To główny problem Apple, który został nam przez nas zgłoszony. Ma to wpływ tylko na użytkowników systemu iOS 10 i tylko na niektórych stronach. Jeśli problem nie dotyczy aplikacji, możesz obejść widżet reCAPTCHA w górę lub w dół na stronie albo użyć reCAPTCHA w wersji 3.

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

Przekierowanie do tej strony z widżetu reCAPTCHA powodowałoby wyświetlenie komunikatu „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:

  • Możesz korzystać z udostępnionej sieci, która jest używana w nieodpowiedni sposób
  • Twój dostawca usług internetowych mógł ostatnio przypisać Ci podejrzany adres IP
  • Witryna, którą próbujesz otworzyć, może być w trakcie ataku

Aby rozwiązać te problemy, przejdź na stronę pomocy dotyczącą 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ą dotyczyć konkretnych użytkowników.