Important
Web Bot Authentication 目前處於預覽階段。 預覽功能沒有服務等級協議,也不建議用於生產工作負載。 功能、限制和可用性可能會改變。
瀏覽網頁的 AI 代理經常遇到反機器人防禦措施,例如驗證碼挑戰、速率限制以及被封鎖的請求。 網站利用這些防禦手段阻止惡意自動化流量,但由於無法可靠區分合法代理與惡意機器人,他們常常也會封鎖合法代理。 Web Bot Auth 透過為自動化流量實作 IETF 的 HTTP 訊息簽章草案架構 來解決這個問題。
當您為 Playwright 工作區啟用 Web Bot Authentication 時,Playwright 工作區的 MCP 會以私鑰加密方式為每個瀏覽器請求簽名,並新增驗證標頭。 機器人管理提供者會根據公鑰目錄驗證簽章,並套用網站擁有者設定的存取政策。 這個流程讓合法自動化有了標準化、可驗證的身分識別方式,而網站擁有者則掌控誰能存取。 Web Bot Auth 無法解決 CAPTCHA 或繞過網站政策。 它支援即時代理與託管代理程式,不需要代理程式或連線變更,也沒有額外成本。
選擇一個金鑰選項
| Option | 運作原理 | 提供者註冊 | 最適合用於 |
|---|---|---|---|
| Microsoft 金鑰(預覽版) | 請求使用由 Microsoft 管理的平台識別碼。 | Microsoft 會在您的興趣表單核准後註冊工作區。 | 開始使用,無需管理提供者帳戶。 |
| 客戶專用金鑰 | 請求使用一對專屬於您工作區的金鑰對。 私鑰會保留在 Microsoft 管理的保險庫中,而公鑰目錄則託管在您的工作區目錄 URL 上。 | 您將您的目錄 URL 提供給各個供應商。 | 想要擁有自己已驗證機器人身分的組織。 |
你可以之後再切換金鑰選項,但流量一次只能用一個選項簽署。 使用客戶專用金鑰時,工作空間中的所有客服人員共享一個簽名的身份。 如果需要獨立身份,請為每個代理使用獨立的工作區。 使用 Microsoft 金鑰時,提供者會看到 Microsoft 的平台識別,而非您組織的識別。
運作原理
- 啟用 Web Bot 認證,並為你的工作區選擇一個金鑰選項。
- 向參與的機器人管理服務提供商註冊。 在註冊確認前,請求仍可能受到挑戰。
- 瀏覽器請求包括
Signature、Signature-Input、 和Signature-Agent標頭。 - 提供者會驗證簽章、快取結果,並套用網站的政策。
開始之前
- Playwright 工作區。 您可以使用現有的工作區或 建立工作區。
- 選擇支援的區域:美國東部、東亞、美國西部 3、西歐、澳洲東部、日本東部或瑞士北部。
- 決定是使用 Microsoft 金鑰還是客戶專用金鑰。
Web Bot Authentication 預設為關閉狀態。
啟用 Web Bot 認證
在 Azure 入口網站中,開啟您的 Playwright 工作區。 在「設定>驗證碼」中,將「驗證碼(Web Bot Auth)」設為啟用,並選擇「Microsoft 金鑰」或「客戶專用金鑰」。
或者,您也可以使用 Azure Resource Manager REST API 更新工作區。 以下範例啟用使用客戶專用金鑰的 Web Bot 驗證。 請將佔位符替換為您的訂閱 ID、資源群組名稱、工作區名稱及 Microsoft Entra 存取權杖。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LoadTestService/playwrightWorkspaces/{workspaceName}?api-version=2026-11-10-preview
Authorization: Bearer {accessToken}
Content-Type: application/json
{
"properties": {
"webBotAuth": {
"status": "Enabled",
"signingKey": "Workspace"
}
}
}
啟用 Web Bot Auth 是一項持續時間很長的作業,可能需要幾分鐘。 要驗證設定,請對工作區發送 GET 請求並確認是否 properties.webBotAuth.status 為 Enabled。
連接您的工作空間並註冊服務提供者
將工作區連接到您的 Microsoft Foundry 專案,並將瀏覽器自動化工具新增至提示或託管代理程式中。 如需說明,請參閱 「使用瀏覽器自動化工具」。
完成您所選擇的金鑰選項的註冊:
Microsoft 金鑰
填寫 興趣表。 Microsoft 會審核您的請求,並向參與的提供者註冊您的工作空間。 審查時間不一。
客戶專用金鑰
- 從 Azure 入口網站的工作區概覽頁面複製您的公鑰目錄 URL。 或者,使用 REST API 來擷取工作區資訊並讀取
properties.webBotAuth.publicKeyDirectoryUri中的內容。 - 將目錄 URL 提交給每個提供者。 相關範例請參閱 Akamai 機器人代理註冊 及 Cloudflare 機器人註冊指引。 您可以向多個提供者註冊相同的 URL。
- 請提供每個提供者所要求的資訊,例如機器人名稱、描述、類別、文件網址、操作員及聯絡方式。
確認註冊後,請在受保護的網站上執行您的代理程式。 如果網站政策允許已簽章的流量,頁面可以在沒有 CAPTCHA 挑戰的情況下載入。 如果存取仍被封鎖,請根據您的金鑰選項與提供者或 Microsoft 合作。
支援的機器人管理提供者
針對 Microsoft 金鑰,劇作家工作區 與 Microsoft Foundry 中的瀏覽器自動化工具支援以下提供者進行 Web Bot 認證:
- Cloudflare
- Akamai 技術
- F5
關閉 Web Bot Authentication
在 Azure 入口網站中,開啟您的工作區並前往設定>驗證碼。 關閉 Web Bot Authentication 設定。 新的代理程式工作階段會停止簽署請求,受保護的網站也可能再次顯示 CAPTCHA 挑戰。
疑難排解
| 徵兆 | 可能原因 | 怎麼辦? |
|---|---|---|
| 代理仍會收到 CAPTCHA 挑戰或封鎖頁面。 | 提供者註冊未被確認,或網站封鎖已簽名的機器人。 | 完成與提供者的註冊。 如果問題持續存在,請依照您的金鑰選項聯絡供應商或 Microsoft。 網站擁有者控制存取權限。 |
該 webBotAuth 屬性被拒絕。 |
請求使用了錯誤的 API 版本或屬性名稱。 | 檢查 REST API 範例中的 API 版本與屬性名稱。 |
常見問題
我需要更改我的經紀人代碼嗎?
No. Web Bot Auth 支援提示式與託管代理程式,無需更改代理程式程式碼或連線。
提供者註冊是自動的嗎?
No. 對於 Microsoft 金鑰,請提交興趣表單並等待核准。 對於客戶專用金鑰,請直接向每個提供者登記您的目錄 URL。
我可以在現有工作區啟用 Web Bot Auth 嗎?
Yes. 您可以在現有的 Playwright 工作區上啟用 Web Bot 驗證。
需要額外付費嗎?
No. Web Bot 認證不需額外收費。