Agent przeglądarki Cloudsurf

Cloudsurf to agent przeglądarki obsługiwany przez Shopify. Uruchamia on przeglądarki internetowe w chmurze, dzięki czemu narzędzia i agenty AI Shopify mogą odwiedzać strony internetowe i wchodzić z nimi w interakcje w taki sam sposób, jak robi to człowiek. Ten rodzaj przeglądania jest określany jako przeglądanie oparte na agentach (ang. agentic browsing).

Cloudsurf odwiedza stronę tylko wtedy, gdy narzędzie Shopify wyda mu takie polecenie. Nie przeszukuje ani nie indeksuje sieci samodzielnie. Możesz zauważyć ruch Cloudsurf w swoim sklepie online lub na dowolnej publicznej stronie internetowej, gdy narzędzie Shopify przegląda ją w imieniu sprzedawcy lub klienta.

Żądania Cloudsurf mogą zawierać sygnaturę Web Bot Auth oraz agenta użytkownika Shopify, czyli tekst w żądaniu identyfikujący oprogramowanie, które je wysłało. Możesz użyć tych danych, aby rozpoznać ruch Cloudsurf w logach oraz w narzędziach do zarządzania botami.

Przypadki użycia Cloudsurf

Narzędzia Shopify używają Cloudsurf do przeglądania stron internetowych w następujących celach:

  • Agenty AI: Sidekick i inne agenty AI Shopify przeglądają strony internetowe, aby wykonać zadania zlecone przez sprzedawcę lub klienta.
  • Testowanie i kontrole jakości: narzędzia Shopify ładują strony internetowe, aby je przetestować, wykonać zrzuty ekranu i sprawdzić pod kątem problemów z wyświetlaniem.

Ruch Cloudsurf w sklepach online

Odwiedziny Cloudsurf w Twoim sklepie online mogą pochodzić z narzędzi Shopify, których używasz, od agentów AI Shopify przeglądających w imieniu klientów lub z wewnętrznych testów i badań prowadzonych za pomocą narzędzi Shopify. Dowiedz się więcej o identyfikacji aktywności botów w sklepie online.

Sygnatury Web Bot Auth

Narzędzia Shopify korzystające z Cloudsurf mogą podpisywać swoje żądania za pomocą rozwiązania Web Bot Auth, które wykorzystuje sygnatury wiadomości HTTP. Prawidłowa sygnatura dowodzi, że Shopify autoryzowało żądanie. Każdy może skopiować agenta użytkownika, więc sygnatura jest najbardziej niezawodnym sposobem identyfikacji ruchu Cloudsurf.

Nie każde żądanie Cloudsurf jest podpisane, ponieważ podpisywanie jest włączane osobno dla każdego narzędzia Shopify. Jeśli żądanie wydaje się pochodzić z Cloudsurf, ale nie ma prawidłowej sygnatury, nie można zweryfikować, czy faktycznie pochodzi od Shopify.

Podpisane żądania Cloudsurf używają wartości Signature-Agent równej "https://cloudsurf.shopify.io". Cloudsurf podpisuje każde żądanie dla narzędzia Shopify, które z niego korzysta, a każda sygnatura wygasa po 60 sekundach od utworzenia. Cloudsurf publikuje swoje klucze publiczne w katalogu kluczy pod adresem https://cloudsurf.shopify.io/.well-known/http-message-signatures-directory.

Podpisane żądania zawierają następujące nagłówki HTTP:

Nagłówki Web Bot Auth, które są zawarte w podpisanych żądaniach Cloudsurf, wraz z określeniem wartości lub formatu każdego z nich
NagłówekWartość
Signature-Agent"https://cloudsurf.shopify.io"
Signature-InputParametry sygnatury, w tym ID klucza, algorytm ed25519, czas utworzenia i wygaśnięcia oraz tag web-bot-auth.
SygnaturaSygnatura Ed25519 żądania.

Poniższy przykład ilustruje format nagłówków dodawanych przez Cloudsurf:

Signature-Agent: "https://cloudsurf.shopify.io"
Signature-Input: sig1=("@authority" "signature-agent");created=<timestamp>;keyid="<key ID>";alg="ed25519";expires=<timestamp>;nonce="<nonce>";tag="web-bot-auth"
Signature: sig1=:<signature>:

Parametr keyid w każdej sygnaturze to odcisk palca (thumbprint) formatu JSON Web Key (JWK) klucza, który ją podpisał.

Usługa zarządzania botami obsługująca rozwiązanie Web Bot Auth może zweryfikować żądanie. Usługa pobiera klucze z katalogu i znajduje klucz pasujący do parametru keyid. Następnie sprawdza sygnaturę i jej czas wygaśnięcia. Jeśli korzystasz z usługi zarządzania botami, zapoznaj się z jej dokumentacją, aby dowiedzieć się, jak zezwolić na działanie zweryfikowanych botów.

Agenty użytkownika Cloudsurf

Domyślnie Cloudsurf dodaje tekst Shopify/Cloudsurf (bot; +https://www.shopify.com) na końcu standardowego agenta użytkownika przeglądarki. Niektóre narzędzia Shopify zastępują całego agenta użytkownika własnym.

Zapoznaj się z poniższą tabelą, aby poznać przykłady agentów użytkownika w ruchu Cloudsurf:

Agenty użytkownika, które mogą być przenoszone przez ruch Cloudsurf, posortowane według narzędzia lub trybu Shopify wysyłającego każdy z nich
ŹródłoAgent użytkownikaSzczegóły
Cloudsurf<browser user agent> Shopify/Cloudsurf (bot; +https://www.shopify.com)Domyślny agent użytkownika. Początek ciągu znaków to standardowy agent użytkownika przeglądarki, w której działa sesja, dlatego zmienia się on w zależności od przeglądarki i jej wersji.
Emulacja urządzenia mobilnegoStandardowy agent użytkownika iPhone'a lub urządzenia z systemem AndroidNarzędzia testujące sposób wyświetlania strony na telefonie wysyłają agenta użytkownika tego telefonu, bez tekstu Cloudsurf. Jeśli jedno z tych żądań jest podpisane, możesz je zweryfikować za pomocą rozwiązania Web Bot Auth.

Agenty użytkownika mogą ulegać zmianie w przypadku aktualizacji narzędzi Shopify. Aby niezawodnie identyfikować ruch Cloudsurf, weryfikuj jego sygnaturę Web Bot Auth zamiast opierać się wyłącznie na dopasowaniu agenta użytkownika.