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.
Na tej stronie
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łówek | Wartość |
|---|---|
| Signature-Agent | "https://cloudsurf.shopify.io" |
| Signature-Input | Parametry sygnatury, w tym ID klucza, algorytm ed25519, czas utworzenia i wygaśnięcia oraz tag web-bot-auth. |
| Sygnatura | Sygnatura 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:
| Źródło | Agent użytkownika | Szczegół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 mobilnego | Standardowy agent użytkownika iPhone'a lub urządzenia z systemem Android | Narzę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.