先界定秘密值可能經過的路徑
許多團隊把秘密掃描等同於檢查 Git 儲存庫,但 CI/CD 的暴露面遠大於原始碼。API 金鑰可能被寫進設定檔,部署憑證可能出現在除錯輸出,Docker 建置參數可能留在映像層,前端環境變數也可能被打包進 JavaScript。即使檔案沒有提交,快取、測試報告、建置紀錄與可下載的 artifact 仍可能把秘密值保存下來。
第一步不是立即採購工具,而是畫出秘密值的資料流:由誰建立、存在哪裡、哪個工作需要讀取、會傳給哪些程序,以及最後可能出現在哪些輸出。判斷某個值是否應視為秘密時,不只看名稱,也要看它能做什麼。具備資料讀取、系統管理、簽章或部署能力的憑證,都應有明確的擁有者、用途、環境範圍與撤銷方式。
在提交前與合併前設置兩道檢查
開發端的 pre-commit 掃描能快速回饋,但不能作為唯一防線,因為本機 hook 可以被略過,也可能沒有安裝。CI 必須再次掃描 pull request 的差異內容,並定期掃描完整歷史。差異掃描適合阻止新問題,完整掃描則能發現早期提交、產生檔案或近期新增規則才辨識得出的憑證格式。
有效的掃描策略通常會結合已知格式、關鍵字與高熵字串。只使用熵值會產生大量誤報,只依賴供應商格式則會漏掉內部 token。規則應允許有期限、有原因且可追蹤的例外,而不是永久忽略整個路徑。測試需要假憑證時,應使用明確無效的固定值,並以註解或 allowlist 指紋精準排除。
- 提交前:掃描 staged files,讓開發者在秘密值進入 Git 歷史前修正。
- Pull request:將秘密掃描設為必要檢查,未通過就不得合併。
- 主分支與歷史:排程掃描完整儲存庫,涵蓋舊提交與自動產生內容。
- 例外管理:要求負責人、原因與到期日,並定期清除失效例外。
讓 Pipeline 取得身分,而不是長期持有密碼
更好的設計是減少 CI 能接觸到的長效秘密。若雲端平台與 CI 供應商支援工作負載身分或 OIDC federation,pipeline 可以用經驗證的儲存庫、分支與工作資訊交換短效憑證,不必保存永久雲端金鑰。權限應依工作拆分:測試工作不需要部署權限,預覽環境不應能修改正式環境,正式部署則只接受受保護分支或已核准的環境。
仍需使用秘密值時,將它們保存在 CI 的 secret store 或集中式秘密管理服務,並在執行階段按需注入。不要把完整秘密放進命令列參數、一般環境報告或可重用的快取鍵。遮罩日誌只是最後一道保護,因為編碼、切割或重新格式化後的值可能避開遮罩。對來自 fork 的 pull request,也不應自動提供具權限的秘密;需要整合測試時,可改用無權限測試帳號、隔離環境或經人工核准的工作。
掃描真正交付的產物
通過原始碼掃描不代表產物安全。建置工具會合併環境設定、展開範本並產生新的檔案,因此應在發布前掃描容器映像、壓縮包、前端 bundle、source map、行動應用程式套件與基礎設施設定。前端框架中特定前綴的環境變數通常會被視為公開設定;把秘密值放入這些變數,即使它來自受保護的 CI store,仍會送到瀏覽器。
容器建置尤其需要注意層級歷史。先將憑證複製進映像再於後續步驟刪除,資料仍可能存在於較早的 layer。需要在建置期間存取私有套件庫時,應使用 BuildKit secret mount 或等效的暫時掛載機制,並確認憑證不會被寫入套件管理器設定、shell 歷史或快取。發布流程應以不可變 digest 綁定已掃描的產物,避免掃描後又重新建置不同內容。
偵測到秘密值時,先撤銷再清理
CI 發現疑似秘密值時應預設阻擋發布,但告警必須提供可操作資訊,例如檔案位置、規則類型、提交者與修復指引,同時避免在報告中重印完整值。團隊也需要定義誤報處理時限與責任人,否則工程師會因為檢查經常阻塞而尋找繞過方式。高可信度憑證格式可以直接失敗;模糊的高熵結果則可先要求人工確認,再逐步收緊政策。
若真實秘密已進入提交或 artifact,刪除目前版本並不足夠。正確順序是立即撤銷或輪替、檢查使用紀錄、停止散布中的產物,再清理 Git 歷史、快取與發布檔案。最後應追查為何 pipeline 能接觸或輸出該秘密,並以縮小權限、短效憑證或產物掃描修補流程。成熟的 CI/CD 防護不是一條掃描命令,而是讓秘密值即使被誤用,也難以長期存活或擴大影響的系統設計。