Браузерний агент Cloudsurf

Cloudsurf — це браузерний агент, яким керує Shopify. Він запускає веббраузери в хмарі, щоб ШІ-агенти та інструменти Shopify могли відвідувати вебсторінки та взаємодіяти з ними так само, як це робить людина. Цей тип перегляду називається агентним (agentic browsing).

Cloudsurf відвідує сторінку, лише коли його спрямовує інструмент Shopify. Він не сканує і не індексує веб самостійно. Ви можете помітити трафік Cloudsurf у своєму інтернет-магазині або на будь-якому загальнодоступному вебсайті, коли інструмент Shopify переглядає сторінки для продавця або клієнта.

Запити Cloudsurf можуть містити підпис Web Bot Auth та агент користувача Shopify — текст у запиті, який ідентифікує програмне забезпечення, що його надіслало. Ви можете використовувати ці дані, щоб розпізнавати трафік Cloudsurf у своїх журналах та інструментах керування ботами.

Випадки використання Cloudsurf

Інструменти Shopify використовують Cloudsurf для перегляду вебсторінок із такою метою:

  • ШІ-агенти: Sidekick та інші ШІ-агенти Shopify переглядають вебсторінки для виконання завдань за запитом продавця або клієнта.
  • Тестування та перевірка якості: інструменти Shopify завантажують вебсторінки для їх тестування, створення знімків екрана та перевірки на наявність проблем із відображенням.

Трафік Cloudsurf в інтернет-магазинах

Візити Cloudsurf до вашого інтернет-магазину можуть здійснюватися з інструментів Shopify, які ви використовуєте, від ШІ-агентів Shopify, які переглядають сторінки для клієнтів, або в межах внутрішнього тестування й досліджень, що проводяться за допомогою інструментів Shopify. Дізнатися більше про Ідентифікацію активності ботів у вашому інтернет-магазині.

Підписи Web Bot Auth

Інструменти Shopify, що використовують Cloudsurf, можуть підписувати свої запити за допомогою Web Bot Auth, який використовує підписи повідомлень HTTP. Дійсний підпис підтверджує, що Shopify авторизував запит. Оскільки будь-хто може скопіювати агента користувача, підпис є найнадійнішим способом ідентифікації трафіку Cloudsurf.

Не кожен запит Cloudsurf є підписаним, оскільки підписування вмикається окремо для кожного інструмента Shopify. Якщо запит ідентифікується як такий, що надійшов від Cloudsurf, але не має дійсного підпису, ви не зможете перевірити, чи дійсно він від Shopify.

Підписані запити Cloudsurf використовують Signature-Agent зі значенням "https://cloudsurf.shopify.io". Cloudsurf підписує кожен запит для інструмента Shopify, який його використовує, і термін дії кожного підпису закінчується через 60 секунд після створення. Cloudsurf публікує свої відкриті ключі в каталозі ключів за адресою https://cloudsurf.shopify.io/.well-known/http-message-signatures-directory.

Підписані запити містять такі HTTP-заголовки:

Заголовки Web Bot Auth, які містять підписані запити Cloudsurf, зі значенням або форматом кожного заголовка
ЗаголовокЗначення
Signature-Agent"https://cloudsurf.shopify.io"
Signature-InputПараметри підпису, зокрема ідентифікатор ключа, алгоритм ed25519, час створення та завершення терміну дії, а також тег web-bot-auth.
SignatureПідпис Ed25519 для запиту.

У цьому прикладі показано формат заголовків, які додає 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>:

Параметр keyid у кожному підписі — це відбиток ключа JSON (JWK) того ключа, яким його було підписано.

Служба керування ботами, яка підтримує Web Bot Auth, може перевірити запит. Вона отримує ключі з каталогу ключів і знаходить той, що відповідає параметру keyid. Потім перевіряє підпис і термін його дії. Якщо ви використовуєте службу керування ботами, зверніться до її документації, щоб дізнатися, як дозволити роботу перевірених ботів.

Агенти користувача Cloudsurf

За замовчуванням Cloudsurf додає текст Shopify/Cloudsurf (bot; +https://www.shopify.com) у кінці стандартного агента користувача браузера. Деякі інструменти Shopify замінюють весь агент користувача на свій власний.

Перегляньте наведену нижче таблицю, щоб ознайомитися з прикладами агентів користувача в трафіку Cloudsurf:

Агенти користувача, які можуть передаватися в трафіку Cloudsurf, за інструментом або режимом Shopify, що їх надсилає
ДжерелоАгент користувачаВідомості
Cloudsurf<агент користувача браузера> Shopify/Cloudsurf (bot; +https://www.shopify.com)Агент користувача за замовчуванням. Початок рядка — це стандартний агент користувача браузера, у якому запущено сеанс, тому він змінюється залежно від браузера та його версії.
Емуляція мобільного пристроюСтандартний агент користувача iPhone або AndroidІнструменти, що тестують відображення сторінки на телефоні, надсилають агент користувача цього телефона без тексту Cloudsurf. Якщо один із таких запитів підписано, ви можете перевірити його за допомогою Web Bot Auth.

Агенти користувача можуть змінюватися після оновлення інструментів Shopify. Щоб надійно ідентифікувати трафік Cloudsurf, перевіряйте його підпис Web Bot Auth, а не лише співставляйте агенти користувача.