Cloudsurf 瀏覽器代理
Cloudsurf 是由 Shopify 營運的瀏覽器代理。此代理會在雲端中執行網頁瀏覽器,讓 Shopify AI 代理程式與工具能夠像人類一樣造訪網頁並與之互動。這種類型的瀏覽稱為代理瀏覽 (agentic browsing)。
Cloudsurf 只有在 Shopify 工具指示時才會造訪網頁。它不會自行檢索或建立網路索引。當 Shopify 工具為商家或顧客進行瀏覽時,您可能會在您的網路商店或任何公開網站上注意到 Cloudsurf 的流量。
Cloudsurf 要求可攜帶 Web Bot Auth 簽章與 Shopify 使用者代理 (user agent),即要求中用來識別發送要求的軟體的文字。您可以使用這些詳細資訊,在日誌和機器人管理工具中識別 Cloudsurf 流量。
Cloudsurf 使用案例
Shopify 工具使用 Cloudsurf 瀏覽網頁的用途如下:
- AI 代理程式:Sidekick 等 Shopify AI 代理程式會瀏覽網頁,以完成商家或顧客要求的工作。
- 測試與品質檢查:Shopify 工具會載入網頁來進行測試、擷取螢幕截圖,並檢查顯示問題。
網路商店上的 Cloudsurf 流量
Cloudsurf 對您網路商店的造訪,可能來自您使用的 Shopify 工具、為顧客瀏覽網頁的 Shopify AI 代理程式,或是透過 Shopify 工具執行的內部測試與研究。請深入瞭解識別網路商店上的機器人活動。
Web Bot Auth 簽章
使用 Cloudsurf 的 Shopify 工具可以使用 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 標頭:
| 標頭 | 值 |
|---|---|
| Signature-Agent | "https://cloudsurf.shopify.io" |
| Signature-Input | 簽章參數,包含金鑰 ID、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 Web Key (JWK) 指紋 (thumbprint)。
支援 Web Bot Auth 的機器人管理服務可以驗證要求。服務會從金鑰目錄擷取金鑰,並尋找符合 keyid 參數的金鑰。接著會檢查簽章及其到期時間。如果您使用機器人管理服務,請參閱其說明文件,以瞭解如何允許經過驗證的機器人。
Cloudsurf 使用者代理
預設情況下,Cloudsurf 會將 Shopify/Cloudsurf (bot; +https://www.shopify.com) 文字新增至瀏覽器標準使用者代理的結尾。有些 Shopify 工具會將整個使用者代理替換成自己的使用者代理。
請檢閱下表以瞭解 Cloudsurf 流量中的使用者代理範例:
| 來源 | 使用者代理 | 詳情 |
|---|---|---|
| Cloudsurf | <browser user agent> Shopify/Cloudsurf (bot; +https://www.shopify.com) | 預設的使用者代理。字串的開頭是執行工作階段的瀏覽器的標準使用者代理,因此會隨著瀏覽器及其版本而變更。 |
| 行動裝置模擬 | 標準的 iPhone 或 Android 使用者代理 | 測試網頁在手機上顯示方式的工具,會傳送該手機的使用者代理,且不包含 Cloudsurf 文字。如果其中一個要求已經過簽署,您就可以使用 Web Bot Auth 進行驗證。 |
使用者代理可能會在 Shopify 工具更新時變更。若要可靠地識別 Cloudsurf 流量,請驗證其 Web Bot Auth 簽章,而不是只比對使用者代理。