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

# 为什么证书固定（Pinning）应用与 mTLS 在 SWG 检查下会失效

解析为何采用 TLS 证书固定或双向 TLS（mTLS）的应用即使在 MDM 已信任企业根证书的 Mac 上，仍会在 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 根证书信任无法解决证书固定

在日常浏览网页时，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-CN/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 解密例外（不解密直通规则）**，在保留网关路由的同时避免破坏证书固定。参见[SWG 绕过与 TLS 解密例外对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)。
*   **获授权的本地测试与开发**：在你自行管理或获准测试的网络中，可通过**域名**界面或 `swgbar bypass enable <domain>` 启用[单域名 SWG 绕过](<https://swgbar.com/zh-CN/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-CN/guides/swg-tls-certificate-errors-macos/>)。

## 继续阅读

*   [如何在 Mac 上绕过 SWG（单域名一键绕过与 CLI 命令）](<https://swgbar.com/zh-CN/guides/how-to-bypass-swg/>)
*   [如何在 Mac 上绕过 SSL 检查（企业 SWG 单域名绕过指南）](<https://swgbar.com/zh-CN/guides/bypass-ssl-inspection-mac/>)
*   [如何在 macOS 上绕过 HTTPS 与 TLS 检查（Break-and-Inspect 指南）](<https://swgbar.com/zh-CN/guides/bypass-https-tls-inspection-mac/>)
*   [如何在 Mac 上绕过企业代理与 SWG SSL 检查](<https://swgbar.com/zh-CN/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [如何判断我的电脑是否被 SWG 劫持（Mac 上检测 HTTPS/SSL 检查）](<https://swgbar.com/zh-CN/guides/detect-https-inspection/>)
*   [如何检查公司或办公 Mac 是否正在拦截 HTTPS（SSL 检查排查）](<https://swgbar.com/zh-CN/guides/check-if-work-mac-intercepting-https/>)
*   [Mac SSL 检查检测工具：菜单栏实时侦测 HTTPS 拦截](<https://swgbar.com/zh-CN/guides/ssl-inspection-checker-mac/>)
*   [Mac 上的 Zscaler SSL 检查：如何检测并按域名绕过](<https://swgbar.com/zh-CN/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Netskope SSL 检查：检测解密与单域名绕过指南](<https://swgbar.com/zh-CN/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Mac 上的 Cloudflare WARP 与 Zero Trust TLS 检查：检测与绕过](<https://swgbar.com/zh-CN/guides/cloudflare-warp-tls-inspection-mac/>)
*   [SWG bar 中的“已确认”与“疑似”HTTPS 检查状态解析](<https://swgbar.com/zh-CN/guides/confirmed-vs-suspected-https-inspection/>)
*   [在 SWG bar 中检查中间人根证书与签发机构](<https://swgbar.com/zh-CN/guides/inspect-mitm-root-certificates-macos/>)
*   [Mac 上的企业 SWG 与 MDM HTTPS 解密检查解析](<https://swgbar.com/zh-CN/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG 绕过与 TLS 解密例外（Break-and-Inspect）对比](<https://swgbar.com/zh-CN/guides/swg-bypass-vs-tls-exception/>)
*   [在 Mac 上为多域名 Web 应用、SSO、CDN 与 API 配置 SWG 绕过](<https://swgbar.com/zh-CN/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [排查 Mac 上 SWG 绕过的“恢复中”“已暂停”与连接错误](<https://swgbar.com/zh-CN/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [macOS VPN 虚拟网卡与 SWG HTTPS 检查对比](<https://swgbar.com/zh-CN/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [修复 Mac 终端 CLI 与 AI 工具中的 SWG TLS/SSL 证书错误](<https://swgbar.com/zh-CN/guides/swg-tls-certificate-errors-macos/>)
*   [Mac 在 SWG 下的 Homebrew、Docker、Python 与 Node.js CA 信任配置](<https://swgbar.com/zh-CN/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-CN/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [在 Mac 上使用 openssl 与 security verify-cert 验证 TLS 证书](<https://swgbar.com/zh-CN/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar 权限、本地隐私与 TLS 探测限额说明](<https://swgbar.com/zh-CN/guides/macos-network-extension-privacy-probe-limits/>)
*   [SWG bar 如何检查 HTTPS 解密](<https://swgbar.com/zh-CN/how-it-works/>)
*   [下载并安装 Mac 版 SWG bar（macOS 14+）](<https://swgbar.com/zh-CN/install/>)
*   [检测 SSL 与 HTTPS 检查的 Chrome 扩展（SWG bar 配套插件）](<https://swgbar.com/zh-CN/chrome-extension/>)
*   [SWG bar CLI 使用指南](<https://swgbar.com/zh-CN/cli/>)
*   [SWG bar MCP 使用指南](<https://swgbar.com/zh-CN/mcp/>)
*   [SWG bar 版本信息](<https://swgbar.com/zh-CN/releases/>)
*   [关于 SWG bar](<https://swgbar.com/zh-CN/about/>)
