為什麼憑證固定(Pinning)應用與 mTLS 在 SWG 檢查下會中斷

瞭解為何使用 TLS 憑證固定或雙向 TLS(mTLS)的應用程式即使在 MDM 已信任企業根憑證的 macOS 上,仍會在企業 SWG HTTPS 解密檢查下交握失敗。

SWG bar · 更新日期

在受 MDM 管理的 Mac 上,員工常會發現一般網站能在企業安全 Web 閘道(SWG)後順利運作,但特定的桌面應用程式、資安更新程式、行動端 SDK 或開發者 API 卻立刻發生 TLS 交握失敗。多數情況下,主因都是**憑證固定(Certificate Pinning)或雙向 TLS(mTLS)**與 SWG 的 **HTTPS/SSL 解密檢查(Break-and-Inspect)**發生衝突。

為什麼 MDM 根憑證信任無法解決憑證固定

在一般 HTTPS 瀏覽時,Safari 與 Chrome 會信任任何連結至 macOS 鑰匙圈內有效根機構的憑證鏈——包括透過 MDM 部署的企業根憑證。

而實作 **TLS 憑證固定(HPKP / SPKI 固定)**的應用程式則會多做一層防護:它們將預期的公開金鑰雜湊(SPKI)或分葉/中繼憑證直接內嵌於應用程式二進位檔中。當企業 SWG 終止 TLS 並以自家企業根憑證重新簽發憑證時:

  1. macOS 鑰匙圈判定該 SWG 憑證有效。
  2. 啟用固定的應用程式將收到的 SWG 憑證公開金鑰指紋與內建的固定指紋比對。
  3. 指紋不符——應用程式隨即中斷 TLS 交握,以防範中間人攔截。

為什麼雙向 TLS(mTLS)在解密重簽期間會失敗

在**雙向 TLS(mTLS)**下,連線雙方會進行雙向驗證:在取得存取權之前,用戶端必須向來源伺服器出示用戶端憑證(常見於金融 API、B2B 端點、零信任 API 以及具備硬體保護的開發者服務)。

如果 SWG 居於中間終止 TLS 連線以解密 HTTP 承載資料,來源伺服器看到的是 SWG 發起的連線,而非你 Mac 上的用戶端 TLS 交握——除非閘道器單純以加密透傳模式運作,或對該主機停用解密,否則端到端的用戶端憑證驗證必定中斷。

診斷 Mac 上哪些主機名稱正遭到攔截

在向 IT 申請閘道器規則或設定本機規則之前,請先找出發生問題的固定憑證或 mTLS 應用程式所連線的確切主機名稱:

  1. 開啟 SWG bar,並在你的應用程式中重現連線失敗。
  2. 檢查 SWG bar → 網域(或執行 swgbar domains list --status confirmed),找出該應用程式連線的確切 API、CDN 或更新主機名稱。
  3. 檢視該網域詳細資訊與憑證分頁,確認是否由企業 SWG 根憑證正在為該主機終止 TLS。
SWG bar 憑證分頁示意,顯示中間人根憑證與關聯網域數量。

在 SWG bar 中驗證應用程式的 API 或更新主機名稱是否出現在檢查 CA 憑證叢集之下。

選擇合適的解決方案

  • 正式環境 / 受管企業工作流程:向 IT 或資安管理員為該憑證固定或 mTLS 主機名稱申請精準的 TLS 解密例外(不解密直通規則),在保留閘道器路由的同時避免破壞 TLS 憑證固定。請參閱 SWG 繞過與 TLS 解密例外對比。
  • 獲授權的本機測試與開發:在你自行管理或獲准測試的網路上,透過網域介面或 swgbar bypass enable <domain> 使用單網域 SWG 繞過,讓該特定主機名稱在不經閘道器解密的情況下連線。
  • CLI 與 AI 執行環境 CA 憑證庫錯誤:如果問題並非嚴格的憑證固定,而是 git、npm、Python、Claude Code 或 Cursor 忽略了 macOS 鑰匙圈,請遵循修復 Mac 終端機 CLI 與 AI 工具中的 SWG TLS/SSL 憑證錯誤。