logo
bars

FunCaptcha
i CapMonster Cloud

Rozwiązywanie captchy, instalacja na stronie i testowanie.
Odziedziczyłeś stronę z już wdrożoną captchą lub ochroną, ale bez dostępu do kodu źródłowego? Naturalnie pojawia się pytanie, jaka technologia jest używana, czy działa poprawnie i jak ją przetestować.

W tym artykule staraliśmy się odpowiedzieć na wszystkie najważniejsze pytania. Pierwszym krokiem w rozwiązywaniu problemu jest ustalenie, jaki system ochrony jest używany. W tym celu możesz skorzystać z listy popularnych captcha i systemów ochrony antybotowej, gdzie znajdziesz przykłady graficzne oraz kluczowe cechy, które pomogą szybko rozpoznać, z czym masz do czynienia.

Jeśli okaże się, że na Twojej stronie używany jest FunCaptcha (Arkose Labs CAPTCHA), kolejnym krokiem będzie dokładniejsze poznanie jej właściwości i sposobu działania. W tym artykule możesz również zapoznać się z instrukcją integracji systemu FunCaptcha (Arkose Labs CAPTCHA), aby w pełni zrozumieć, jak funkcjonuje on na Twojej stronie. Dzięki temu nie tylko lepiej poznasz obecną ochronę, ale też świadomie zaplanujesz jej dalsze utrzymanie.

Czym jest FunCaptcha
Czym jest FunCaptcha
FunCaptcha to interaktywny system ochrony przed botami opracowany przez Arkose Labs. Sprawdza, czy użytkownik jest prawdziwym człowiekiem, poprzez grywalne i wizualne zadania, które są łatwe dla ludzi, ale trudne do automatyzacji. FunCaptcha stosuje się do ochrony rejestracji, logowania, płatności online, kampanii marketingowych oraz zapobiegania oszustwom, spamowi i masowym automatycznym działaniom.
Background
Przykłady FunCaptcha
Obrót obiektu 3D
Obrót obiektu 3D
Użytkownik obraca model 3D lub figurę, aby ustawić ją w prawidłowej pozycji.
Wybór obiektów według reguły
Wybór obiektów według reguły
Należy wybrać obrazy lub elementy zgodne z określoną regułą (np. 'wybierz wszystkie jabłka').
Zadania interaktywne (przeciągnij i upuść / podążanie ścieżką)
Zadania interaktywne (przeciągnij i upuść / podążanie ścieżką)
Wykonuje działania na elementach, np. przeciąga je wzdłuż określonej ścieżki.
Pytania audio
Pytania audio
Użytkownik słucha audio i wybiera poprawną odpowiedź (rzadziej używane jako alternatywa dla zadań wizualnych).

Jak rozwiązać FunCaptcha przez CapMonster Cloud

Podczas testowania formularzy z FunCaptcha często pojawia się potrzeba sprawdzenia działania captchy i upewnienia się, że jest poprawnie zintegrowana.
Możesz ręcznie przetestować captchę umieszczoną na swojej stronie.
  • Otwórz stronę z formularzem i upewnij się, że captcha jest widoczna.
  • Spróbuj wysłać formularz bez rozwiązania captchy — serwer powinien zwrócić błąd.
  • Po poprawnym rozwiązaniu captchy — formularz powinien zostać wysłany bez błędów.
Aby automatycznie rozpoznać captchę można użyć specjalistycznych usług, np. CapMonster Cloud — narzędzie, które przyjmuje parametry captchy, przetwarza je na swoich serwerach i zwraca gotowy token. Token można wstawić do formularza, aby przejść weryfikację bez udziału użytkownika.

Praca z CapMonster Cloud poprzez API zazwyczaj obejmuje następujące kroki:

Tworzenie zadaniaTworzenie zadania
arrow
Wysyłanie żądania APIWysyłanie żądania API
arrow
Odebranie wynikuOdebranie wyniku
arrow
Umieszczenie tokenu na stronieUmieszczenie tokenu na stronie
arrow
Jak podłączyć FunCaptcha do swojej strony
Aby pewnie orientować się w działaniu captchy na swojej stronie, rozumieć logikę weryfikacji i ewentualnie ponownie podłączyć lub skonfigurować ochronę, zalecamy zapoznanie się z tym działem. Opisuje on proces podłączenia ochrony i pozwala szybko zrozumieć wszystkie szczegóły.
  1. Zarejestruj się w Arkose Labs i uzyskaj dostęp do Arkose Command Center (można wysłać dane w czacie w formularzu — np. tutaj lub tutaj).
  2. Po uzyskaniu dostępu pobierz dwa klucze (Public / Private) w sekcji Settings → Keys.

    HowTo Connect image 1

  3. W razie potrzeby skontaktuj się z Customer Success Manager (CSM) w celu:

    • uzyskania niestandardowych domen API;
    • weryfikacji schematów żądań i odpowiedzi API.

Zalecenia Arkose

  • Do testów używaj Development Key.
  • Dla każdego workflow używaj osobnego Production Key (login, rejestracja, zakup itd.).
  • Używaj różnych kluczy dla różnych stron.

Ogólny proces działania

  • Klient zbiera dane i w razie potrzeby pokazuje challenge.
  • Klient otrzymuje jednorazowy token.
  • Serwer weryfikuje token przez Arkose Verify API.

Krok 1. Integracja po stronie klienta

Po stronie przeglądarki (Arkose Bot Manager):

  • analizuje zachowanie użytkownika;
  • pokazuje w razie potrzeby Enforcement Challenge;
  • zwraca token sesji.

Client API:

  • Do testów można użyć:
    client-api.arkoselabs.com
  • Dla produkcji warto wskazać niestandardową domenę:
    <company>-api.arkoselabs.com

Główne wymagania

Wynik klienta — token, który należy wysłać na serwer.

Krok 2. Weryfikacja po stronie serwera

Na serwerze wykonywana jest weryfikacja tokena przez Arkose Verify API.

Verify API endpoint

Wymagane parametry żądania

Przykład ciała żądania POST

Odpowiedź API zawiera informacje o sesji i wynik weryfikacji.

Kluczowe punkty

Jak to działa:

Background
Możliwe błędy i debugowanie
Bug Icon
Nieprawidłowe parametry żądania
Upewnij się, że podałeś poprawny Public Key dla klienta i Private Key dla serwera oraz przesyłasz poprawny session_token do Verify API.
Bug Icon
Pusty lub nieprawidłowy session_token
Serwer otrzyma pusty wynik lub błąd weryfikacji. Sprawdź, czy klient prawidłowo przesyła token po rozwiązaniu captchy.
Bug Icon
Przekroczono czas rozwiązania
Jeśli użytkownik nie zakończy weryfikacji na czas, serwer Arkose może zwrócić błąd lub odrzucić weryfikację. Zwiększ dopuszczalny czas oczekiwania po stronie serwera.
Sprawdzenie odporności ochrony
Rekomendacje dotyczące bezpieczeństwa i optymalizacji
<b>Przechowuj Private Key tylko na serwerze</b>, nie umieszczaj go w kodzie JS klienta.
Loguj pełne odpowiedzi Arkose Verify API, w tym status weryfikacji, kod błędu i przesłane parametry — to pomaga szybciej diagnozować problemy.
Używaj <b>HTTPS</b> dla wszystkich żądań (klient → serwer → Verify API), aby wykluczyć podszywanie się pod dane.
Umieść na stronie linki do <b>Polityki prywatności</b> i <b>Warunków korzystania z Arkose Labs</b>, zgodnie z wymogami licencji.
Wnioski

Jeśli przejąłeś stronę internetową, na której jest już zainstalowany captcha lub inny system zabezpieczeń, a jednocześnie nie masz dostępu do kodu — to nic strasznego! Dość łatwo jest ustalić, jaka dokładnie technologia jest używana. Aby sprawdzić poprawność działania, możesz skorzystać z usługi rozpoznawania CapMonster Cloud w odizolowanym środowisku testowym, żeby upewnić się, że mechanizm przetwarzania tokenów i logika weryfikacji działają prawidłowo.

W przypadku FunCaptcha wystarczy rozpoznać system, przeanalizować jego zachowanie i upewnić się, że zabezpieczenie działa poprawnie. W artykule pokazaliśmy, jak zidentyfikować FunCaptcha oraz gdzie znaleźć instrukcje dotyczące jego podłączenia lub ponownej konfiguracji, aby móc pewnie utrzymywać ochronę i kontrolować jej działanie.

Conclusion
Przydatne linki
DocIconDokumentacja FunCaptcha (Arkose Labs CAPTCHA)DocIconFormularz zgłoszeniowy podłączenia FunCaptchaDocIconDokumentacja CapMonster Cloud (praca z FunCaptcha)