Source: https://swgbar.com/zh-TW/guides/certificate-pinning-mtls-swg-inspection-macos/
Language: zh-TW

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

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

SWG bar · 更新日期 2026年11月18日

在受 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](<https://swgbar.com/zh-TW/install/>)，並在你的應用程式中重現連線失敗。
2.  檢查 **SWG bar → 網域**（或執行 `swgbar domains list --status confirmed`），找出該應用程式連線的確切 API、CDN 或更新主機名稱。
3.  檢視該網域詳細資訊與**憑證**分頁，確認是否由企業 SWG 根憑證正在為該主機終止 TLS。

![SWG bar 憑證分頁示意，顯示中間人根憑證與關聯網域數量。](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

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

## 選擇合適的解決方案

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

## 延伸閱讀

*   [如何在 Mac 上繞過 SWG（單網域一鍵繞過與 CLI 指令）](<https://swgbar.com/zh-TW/guides/how-to-bypass-swg/>)
*   [如何在 Mac 上繞過 SSL 檢查（企業 SWG 單網域直連方案）](<https://swgbar.com/zh-TW/guides/bypass-ssl-inspection-mac/>)
*   [如何在 macOS 上繞過 HTTPS 與 TLS 檢查（Break-and-Inspect 指南）](<https://swgbar.com/zh-TW/guides/bypass-https-tls-inspection-mac/>)
*   [如何在 Mac 上繞過企業代理伺服器與 SWG SSL 檢查](<https://swgbar.com/zh-TW/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [如何判斷 Mac 是否被 SWG 劫持（偵測 HTTPS 與 SSL 檢查）](<https://swgbar.com/zh-TW/guides/detect-https-inspection/>)
*   [如何檢查公司或工作用 Mac 是否正在攔截 HTTPS（SSL 檢查）](<https://swgbar.com/zh-TW/guides/check-if-work-mac-intercepting-https/>)
*   [Mac 專用 SSL 檢查偵測工具：在選單列即時發現 HTTPS 攔截](<https://swgbar.com/zh-TW/guides/ssl-inspection-checker-mac/>)
*   [Mac 上的 Zscaler SSL 檢查：如何偵測並按網域繞過](<https://swgbar.com/zh-TW/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Netskope SSL 檢查：偵測解密與單網域繞過指南](<https://swgbar.com/zh-TW/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Cloudflare WARP 與 Zero Trust TLS 檢查：偵測與繞過](<https://swgbar.com/zh-TW/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar 中的「已確認」與「疑似」HTTPS 檢查狀態解析](<https://swgbar.com/zh-TW/guides/confirmed-vs-suspected-https-inspection/>)
*   [在 SWG bar 中檢查中間人根憑證與核發機構](<https://swgbar.com/zh-TW/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac 上的企業 SWG 與 MDM HTTPS 解密檢查解析](<https://swgbar.com/zh-TW/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 繞過與 TLS 解密例外（Break-and-Inspect）對比](<https://swgbar.com/zh-TW/guides/swg-bypass-vs-tls-exception/>)
*   [在 Mac 上為多網域 Web 應用、SSO、CDN 與 API 設定 SWG 繞過](<https://swgbar.com/zh-TW/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [排解 Mac 上 SWG 繞過的「恢復中」「已暫停」與連線錯誤](<https://swgbar.com/zh-TW/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 虛擬介面與 SWG HTTPS 檢查比較](<https://swgbar.com/zh-TW/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [修復 Mac 終端機 CLI 與 AI 工具中的 SWG TLS/SSL 憑證錯誤](<https://swgbar.com/zh-TW/guides/swg-tls-certificate-errors-macos/>)
*   [Mac 在 SWG 下的 Homebrew、Docker、Python 與 Node.js CA 信任設定](<https://swgbar.com/zh-TW/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [修復 Mac 上 Claude Code 與 Cursor 的 'unable to get local issuer certificate' 錯誤（SWG 與 MCP）](<https://swgbar.com/zh-TW/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [在 Mac 上使用 openssl 與 security verify-cert 驗證 TLS 憑證](<https://swgbar.com/zh-TW/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 權限、本機隱私與 TLS 探測上限說明](<https://swgbar.com/zh-TW/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar 如何檢查 HTTPS 解密](<https://swgbar.com/zh-TW/how-it-works/>)
*   [下載並安裝 Mac 版 SWG bar（macOS 14+）](<https://swgbar.com/zh-TW/install/>)
*   [偵測 SSL 與 HTTPS 檢查的 Chrome 擴充功能（SWG bar 配套外掛）](<https://swgbar.com/zh-TW/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-TW/cli/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-TW/mcp/>)
*   [SWG bar 版本資訊](<https://swgbar.com/zh-TW/releases/>)
*   [關於 SWG bar](<https://swgbar.com/zh-TW/about/>)
