GitHub 上線工作流程觸發保護：代理 CI 團隊應檢查什麼
GitHub 於 2026 年 9 月 17 日宣布，GitHub Actions 的工作流程執行保護已正式可用。企業、組織和儲存庫可以規定誰能觸發工作流程，以及哪些事件能夠啟動工作流程。正式版也加入依工作流程檔案定向、策略洞察與 REST API 管理能力。
對於維護代理用戶端、瀏覽器自動化、廣告驗證或合規資料蒐集任務的團隊，這項變更直接關係到代理憑證、地區路由與生產目的地的安全。一個事件能夠發生，不代表它應取得敏感執行權限。觸發者信任、工作流程用途與密鑰範圍必須一起設計。
這次更新改變了什麼
執行保護會在工作流程執行前評估兩類策略：
- 參與者規則：限制哪些人員、角色或可信自動化身分可以觸發工作流程。
- 事件規則：限制推送、提取請求、手動呼叫等哪些事件可以啟動工作流程。
規則現在可以只針對某個工作流程檔案，而不是一次覆蓋整個儲存庫。低風險的格式檢查可以維持較寬入口，部署或代理驗證工作流程則使用更嚴格的人員與事件允許清單。洞察頁面用於觀察允許和阻止結果，API 則支援在多個儲存庫中以程式碼管理策略。
GitHub 也說明了一個面向公共儲存庫的安全預設值：如果儲存庫沒有適用的事件策略，pull_request_target 會先進入評估模式，並計畫在 2026 年 11 月 2 日執行限制。該事件可能在基礎儲存庫上下文中執行，如果把不可信變更與高權限或密鑰混在一起，風險會明顯放大。
先盤點敏感代理工作流程
優先檢查能夠讀取或修改下列內容的工作流程：
- 代理使用者名稱、密碼、權杖或允許清單管理憑證；
- 住宅、機房或輪替代理入口；
- 國家、地區、ASN、工作階段或 IP 位址族選擇；
- 生產蒐集排程、並行與重試上限；
- 瀏覽器設定、Cookie 或已登入的目標帳號；
- 部署環境、容器登錄或雲端角色；
- 可能包含 URL、識別碼或回應本文的結果封存。
為每個工作流程記錄檔案路徑、負責人、允許事件、預期觸發者、密鑰來源、網路目的地與回復路徑。密鑰只記錄別名，禁止把真實值複製到盤點表。
如果稽核發現多個任務共用一套代理憑證，可參考代理憑證輪替手冊進行拆分與替換。
把基礎驗證與高權限執行分開
來自不可信貢獻者的提取請求可能需要格式檢查、靜態分析與單元測試，但通常不需要生產代理憑證，也不需要存取真實蒐集目標。
建議依信任階段拆分：
- 使用本機固定樣本執行無憑證測試。
- 在低權限上下文中建置成品。
- 只有獲准的人員與事件才能啟動受控整合測試。
- 僅在受保護階段注入最小範圍的代理身分。
- 透過獨立策略控制發布或部署工作流程。
不要把憑證放進儲存庫變數、產生檔案或成品來規避觸發風險。如果密鑰在管線早期就可用，即使最終部署作業受到保護，暴露面仍然存在。
強制執行前使用評估模式
策略修改可能中斷正常的排程任務、發布流程或緊急路徑。先在評估模式中涵蓋至少一個具代表性的週期，再審查哪些執行會被阻止：
| 結果 | 處理方式 |
|---|---|
| 預期阻止 | 保留規則並記錄保護邊界 |
| 意外阻止 | 在執行前修正參與者、事件或檔案範圍 |
| 意外放行 | 收緊策略或拆分工作流程 |
| 無法判斷 | 暫停執行，由明確負責人作出決定 |
測試視窗沒有觸發事件，不等於策略有效。應使用合成輸入涵蓋排程、手動、提取請求、發布與緊急路徑，並確認被阻止的工作流程不會轉向一個未保護的副本。
同時保護代理憑證與對外連線
觸發策略只是其中一層。可信觸發仍可能執行不安全程式碼、使用過寬權限或存取任意外部位址。每個工作負載應使用獨立代理身分，並在服務支援時限制產品、地區、並行、來源網路與有效期。
日誌遮罩很重要，但不能作為第一道控制。不要輸出完整代理 URL，因為其中可能包含使用者名稱、密碼或工作階段選擇器。日常證據只保留淨化後的路線類型與不可逆請求識別碼。
觸發規則也應與對外連線允許清單配合。驗證任務只應存取代理閘道、獲准測試目標，以及必要的套件與成品服務。如果測試要求代理路徑，直接連線備援必須失敗關閉。可用NO_PROXY 測試指南檢查是否有設定把流量悄悄送出預期代理路徑。
遷移檢查清單
- 列出所有可存取代理或目標憑證的工作流程。
- 為每類參與者和事件標註信任等級。
- 將低風險驗證與高權限整合、部署分開。
- 僅對敏感工作流程檔案套用嚴格策略。
- 使用具代表性的事件在評估模式執行規則。
- 檢查意外放行與意外阻止。
- 確認
pull_request_target已停用或有明確理由。 - 將密鑰限制在受保護作業和環境中。
- 限制對外目的地並關閉意外直接連線備援。
- 在不削弱基線的情況下測試回復和緊急存取。
- 保存經過淨化的策略證據與變更負責人。
- 在 11 月 2 日預設執行日期前再次複核。
常見問題
工作流程執行保護能替代分支保護嗎？
不能。分支規則管理程式碼變更與合併，執行保護管理工作流程能否啟動。敏感代理 CI 還需要最小權限密鑰與網路控制。
是否應禁止所有提取請求執行 CI？
不需要。不可信提取請求仍可針對本機樣本執行低權限檢查，但不應自動取得生產憑證或部署權限。
更換代理 IP 能讓不可信工作流程變安全嗎？
不能。路線變化不會改變觸發者、事件、程式碼或權限邊界。住宅代理或輪替代理無法修復不安全的觸發策略。
上線後應觀察什麼指標？
依工作流程、參與者類型和事件統計允許與阻止結果，同時觀察意外策略結果比例、正常阻止的處理時間、繞過使用情況以及密鑰或對外連線違規。不要以工作流程執行量作為唯一目標。
合規說明
代理和資料蒐集自動化僅應用於已獲授權的目的地與資料。遵守平台條款和目標限制，執行最小權限，減少資料保留，不得用 IP 輪替規避明確的存取決定。策略測試應使用合成憑證和受控端點。
內部來源記錄：GitHub，《Workflow execution protections in GitHub Actions generally available》，2026 年 9 月 17 日。
