
代理支援案件常因兩種情況停滯:報告只寫「代理很慢」,或直接附上暴露憑證、Cookie、客戶資料與無關流量的原始日誌。前者無法定位,後者會製造新的安全事件。
高品質證據包應規模小、可重現、有明確時間範圍,並指出失敗發生在哪個階段。它要讓供應商能關聯同一路線,同時把驗證資訊與業務承載內容排除在案件之外。
先寫一句可驗證的事件描述
使用中性句型:在精確 UTC 窗口內,產品 P、地區 R 的獲授權請求在階段 S 的終態失敗率高於約定基準,而控制路線仍在正常範圍。
證據不足時不要先下原因結論。「出口容量耗盡」是推測,「32% 請求在 CONNECT 後逾時」才是觀察結果。
限定最小必要範圍
記錄代理產品類型、國家或 ASN 等選擇條件、代理通訊協定與端點標籤、工作階段模式、測試目的地類型、UTC 起訖時間、樣本量、並行數、客戶端與 TLS 程式庫版本,以及問題影響所有節點或單一環境。
不要把多個產品、國家與應用程式版本混進同一案件。彼此獨立的失敗模式應分開處理。
標記第一個失敗階段
「請求失敗」過於寬泛,應標記第一個未達預期的階段:
- 代理端點 DNS 解析;
- 到代理的 TCP 連線;
- 與 HTTPS 代理的 TLS 交握;
- 代理驗證,包括 407;
- CONNECT 通道建立;
- 目的地 TLS 交握;
- HTTP 回應標頭;
- 回應本文傳輸;
- 回傳結果的業務驗證。
如此可避免把目的地限流報成代理驗證故障,或把解析器錯誤當作路線問題。若第一個失敗階段是驗證,可參考代理驗證 407 疑難排解指南。
建立有限且可重現的樣本
使用獲授權測試端點與受控請求,把速率和並行數控制在不會扭曲服務的範圍。
- 依基準穩定性執行 20 至 100 次。
- 固定設定與請求形狀。
- 為每次嘗試配置唯一關聯 ID。
- 加入控制路線或上一個已知正常版本。
- 原始測量輪次停用自動重試。
- 必要時再依正式環境重試政策執行第二輪。
間歇性問題應使用多個短窗口,而非一次無控制突發。保留精確 UTC 區間,方便供應商關聯閘道與上游日誌。
每列保留最小有用欄位
遮罩後的證據列應包含關聯 ID、毫秒級 UTC 時間、產品與端點標籤、請求地區、工作階段模式、客戶端版本、嘗試序號、失敗階段、客戶端結果碼、可取得時的 HTTP 狀態、連線與總延遲、收發位元組數、新建或重用連線、必要時雜湊或截短的出口識別碼,以及最終驗證結果。
絕不能包含代理使用者名稱、密碼、驗證標頭、原始 Cookie、權杖、工作階段權杖、私密金鑰或完整代理 URL。
遮罩不能破壞診斷價值
遮罩應保持確定性。同一敏感值在同一案件內替換為相同標籤,以保留重複行為。
- 真實代理使用者名稱替換為中性案件標籤。
- 不需要完整 IP 時使用帶密鑰雜湊或約定前綴。
- 商業敏感目的地替換為目的地類型標籤。
- 查詢參數值與請求本文非必要時全部移除。
- Cookie 與驗證標頭完整刪除。
附件至少審查兩次:先自動掃描 URL、標頭、權杖、電子郵件、Cookie 與私密金鑰標記,再由理解工作負載和支援受眾的人員手動檢查。
用統計分布取代截圖
一張逾時截圖證據很弱。應附上終態成功率、依階段和代碼統計的失敗、連線與總延遲 p50/p95、重試放大、地區相符率、黏性工作階段存活率及控制路線比較。407、429 與 5xx 必須分開統計。
不要把不同性質的錯誤平均成一個「可用率」。大型回應傳輸慢與 TCP 連線失敗不可直接合併。
明確要求供應商做什麼
案件結尾提出一個具體要求:
- 以閘道日誌關聯所給請求 ID;
- 判斷 UTC 窗口內是否發生容量或路由事件;
- 說明驗證政策變更;
- 確認正式輪換語意;
- 判斷 SLA 分類;
- 提供緩解後的安全重測窗口。
目標是得到可驗證的下一步,而非籠統要求「修好全部問題」。
後續溝通也不能傳送憑證
若支援人員要求真實使用者名稱、密碼、Cookie 或完整代理 URL,不要直接貼到聊天、電子郵件、截圖或案件留言。應使用供應商核准的安全流程,並優先建立權限受限的臨時測試憑證。
若憑證可能已洩漏,應立即輪換並使相關工作階段失效。可依代理憑證輪換執行受控處置。
建議證據包順序
- 一句話事件描述;
- 不含個人資料的業務影響;
- 產品、地區、工作階段與 UTC 範圍;
- 客戶端與環境版本;
- 重現步驟;
- 彙總結果表;
- 遮罩後的樣本列;
- 預期與實際行為;
- 控制路線結果;
- 請求供應商採取的動作;
- 附件保留與刪除日期。
原始擷取資料應存放在受控內部儲存區,案件只包含經縮減與複核的證據包。
驗證供應商處理結果
不能因支援回覆「已解決」就關閉事件。應使用相同門檻重複同一有限測試,比較相同指標並記錄新的 UTC 窗口。
涉及容錯移轉時可執行代理容錯移轉復原演練;需要合約層級判斷時搭配代理 SLA 驗證。
傳送前檢查清單
- 事件描述中性且可觀察。
- 所有時間使用 UTC,並給出精確窗口。
- 已說明產品、地區、工作階段政策、樣本量與並行數。
- 已依階段與代碼分類失敗。
- 包含控制路線或已知正常基準。
- 重試與第一次嘗試結果分開。
- 不含憑證、Cookie、權杖、個人資料與完整代理 URL。
- 附件通過自動與人工複核。
- 供應商動作要求具體明確。
- 已設定附件保留與刪除日期。
常見問題
應附上完整 HAR 檔案嗎?
通常不應。HAR 常含 Cookie、驗證標頭、查詢參數與回應本文。只匯出必要欄位,並在遮罩與複核後提交。
應傳送多少筆失敗請求?
傳送具代表性的有限樣本與彙總計數。缺少階段、時間和設定範圍時,增加原始列數也無助益。
是否應包含出口 IP?
僅在必要且允許時包含。優先使用案件內雜湊、截短形式或供應商請求 ID。
可以傳送真實代理 URL 嗎?
不要在一般案件中放入憑證。透過核准安全流程傳遞權限受限的測試憑證,調查結束後立即撤銷。
合規說明
只能從獲授權系統與流量收集證據。請遵守隱私法律、合約、資料最小化要求、保留期限與供應商支援規則。證據包不得包含無關使用者資料或任何秘密。