SSL Pinning 是一种通过确保应用只连接受信任服务器，保护移动应用免受中间人（MITM）攻击的方法。其原理是将证书或公钥嵌入应用，并在与服务器证书不匹配时阻止连接。以下是您需要了解的内容：
- 为什么它很重要：保护金融交易和登录凭据等敏感数据免受拦截。
- 主流实现工具:
- TrustKit：支持 iOS 和 Android，可自动管理证书。
- OkHttp：适用于 Android，需手动处理证书。
- Capacitor 插件: @capgo/capacitor-ssl-pinning 适用于使用 Capacitor 构建的应用。
- 实现类型:
- 证书固定 (Certificate Pinning)：安全性高，但证书变更时需要更新。
- 公钥固定 (Public Key Pinning)：维护成本低，仅在密钥变更时需要更新。
- 混合方案：结合固定与动态方法，兼顾灵活性。
快速对比
| 工具 | 平台 | 证书管理 | 支持备用 Pin |
|---|---|---|---|
| TrustKit | iOS 和 Android | 自动化 | 是 |
| OkHttp | Android | 手动 | 是 |
| Capacitor 插件 | Capacitor 应用 | 原生配置文件 | 是 |
SSL pinning 对保障应用通信安全至关重要。请根据您的平台和维护需求选择合适的工具。
SSL Pinning 详解
SSL Pinning 工具与库
让我们深入了解一些专为原生和 Capacitor 应用量身定制的顶级 SSL pinning 解决方案。
iOS 与 Android 库
TrustKit 是一个强大的库，支持在 iOS 和 Android 平台上进行 SSL 固定 [2]。它为运行 Android N 及更高版本的设备提供原生实现，同时也为旧版本提供自定义解决方案 [2].
OkHttp另一方面，是 Android 设备上 SSL 固定的热门选择，包括运行 Android 7 以下版本的设备 [4].
| 功能 | TrustKit | OkHttp |
|---|---|---|
| 平台支持 | iOS 和 Android | 仅限 Android |
| 版本兼容性 | 所有 iOS、Android N+ | 所有 Android |
| 实现类型 | 原生/自定义 | 自定义 |
| 证书管理 | 自动化 | 手动 |
| 支持备用 Pin | 是 | 是 |
Capacitor 应用也有专门用于有效处理 SSL pinning 的插件。
Capacitor 插件
对于 Capacitor 应用， @capgo/capacitor-ssl-pinning 是推荐选项。该插件通过将 CapacitorHttp 在 iOS 和 Android 上的 HTTPS 连接固定到随包内置的证书，实现无缝集成。
工具对比
选择合适的 SSL pinning 工具取决于应用的安全需求，以及你愿意投入多少维护精力。以下是两种常见方法的对比：
| 维度 | 证书固定 (Certificate Pinning) | 公钥固定 (Public Key Pinning) |
|---|---|---|
| 安全等级 | 高 | 极高 |
| 存储占用 | 较大 | 极小 |
| 维护频率 | 每次证书续期 | 仅在密钥变更时 |
| 实现复杂度 | 较低 | 较高 |
“SSL Pinning 确保你的应用仅使用受信任的证书与服务器通信，从而增强对中间人 (MITM) 攻击的防护。” [7] - Ajmal Hasan，软件工程师
为避免潜在的锁定，请先关闭强制 Pinning (enforcePinning="false") 并启用备用 Pin [6]。定期检查并更新证书，让你的应用保持安全 [3].
SSL Pinning 方法
SSL pinning 可以通过多种方式实现，每种方式提供的安全性和适应性各不相同。下面我们来拆解这些关键方法及其独特之处。
固定证书 Pinning
这种方法将服务器证书直接嵌入到应用中。虽然概念上很简单，但也有一些特定的取舍：
| 维度 | 影响 | 注意事项 |
|---|---|---|
| 安全等级 | 非常高 | 确保针对嵌入的 pins 进行直接验证。 |
| 维护 | 高 | 需要 应用更新 每当证书发生变化时。 |
| 实现 | 中等 | 依赖原生配置文件。 |
| 用户体验 | 变量 | 证书变更可能会导致应用功能中断。 |
实时证书更新
动态 Pinning 无需通过应用商店提交即可更新证书，提供了更灵活的解决方案。该方法依赖以下关键实践：
- 证书通过以下方式更新： 加密通道.
- 每个证书都会 经过严格验证 后再使用。
- 设有备份机制以应对潜在故障。
组合 Pinning 策略
混合方案结合了固定 Pinning 与动态 Pinning，在强安全性与运维灵活性之间取得了平衡。其工作原理如下：
| 组成部分 | 用途 | 更新频率 |
|---|---|---|
| 基础证书 | 充当核心安全层 | 随应用版本更新。 |
| 动态更新 | 为变更提供灵活性 | 按需应用。 |
面向 Capacitor 应用的平台特定实现
Capacitor 应用的 SSL 固定实现取决于平台：
| 平台 | 配置文件 | 证书存储 |
|---|---|---|
| Android | network_security_config.xml |
存储在 res/raw 文件夹。 |
| iOS | Info.plist |
打包在应用内。 |
为了保障安全性，定期更新至关重要。接下来的章节将探讨测试 SSL pinning 实现的工具与方法。
SSL Pinning 测试
测试您的 SSL pinning 配置可以确保 App 仅与受信任的服务器通信，从而保护敏感数据免遭拦截。
测试工具
以下是验证 SSL pinning 的一些必备工具：
| 工具 | 主要功能 | 核心功能 |
|---|---|---|
| Charles Proxy | 流量检查 | 证书生成， 断点调试 |
| Burp Suite | 安全测试 | 高级拦截、自动化扫描 |
| mitmproxy | HTTPS 分析 | 自定义证书支持、命令行界面 |
| OpenSSL | 证书处理 | 指纹生成、验证测试 |
其中， mitmproxy 在指定证书方面尤为灵活 [9].
测试指南
要确认 SSL pinning 实现，请按以下测试步骤操作：
| 测试类型 | 用途 | 预期结果 |
|---|---|---|
| MITM 攻击模拟 | 验证证书校验 | 使用无效证书时连接失败 |
| 证书轮换 | 测试备用证书处理 | 平滑过渡到备用证书 |
| 网络监控 | 追踪证书变更 | 成功检测并记录证书更新 |
“如果你用 mitmproxy 或 Burp 等工具设置 SSL 拦截，并把该拦截代理的 CA 证书导入 Android 证书库并设为信任，就应该能拦截连接并读取明文。反之，如果应用失败并抛出 SSL 验证失败的错误，那它很可能实现了 SSL pinning。” – Steffen Ullrich [10]
一个真实案例凸显了稳健测试的重要性：2021 年 7 月，安全研究员 Tim Perry 演示了像 Frida 可以在 Android 应用中测试 SSL 固定。他的发现表明，即使是像 Twitter 这样具有强大保护的应用，也能通过正确的测试方法检查其 HTTPS 流量。
为了进一步增强您的 SSL 固定实现：
- 添加运行时保护以补充固定机制。
- 启用 root 检测以识别已越狱的设备。
- 纳入防篡改措施。
- 监控应用日志中的 SSL 握手异常 [8].
定期自动化测试并更新固定配置，以维持安全性。
下一节将介绍 Capgo 等解决方案如何通过集成更多安全功能来扩展这些实践。
Capgo SSL Pinning 支持
Capgo 专注于自动化安全和无缝 Live Updates，从而强化 SSL pinning。通过严格测试验证 SSL pinning 后，开发者可以依靠 Capgo 在更新发布期间简化安全流程，兼顾速度与防护。
Capgo 功能特性
Capgo 集成了 SSL pinning，在实现应用即时更新的同时提供强大的安全性。其设计确保更新过程既安全又不会影响性能：
| 功能 | 优势 | 指标 |
|---|---|---|
| 端到端加密 | 确保只有授权用户才能访问更新 | 434 ms API 响应 |
| 全球 CDN 分发 | 提供安全快速的更新分发 | 5 MB bundle 仅需 114 ms |
| 版本控制 | 支持安全回滚功能 | 24 小时内用户更新率达 95% |
| 实时分析 | 监控更新成功率 | 全球成功率达 82% |
已有超过 1,700 款应用使用该平台，Capgo 在快速更新与 SSL pinning 的完整性之间取得了有效平衡。
安全标准
Capgo 的安全框架符合应用商店的严格规范，截至 2025 年 5 月，已成功处理 1.6 万亿次更新。
下面介绍 Capgo 如何确保顶级安全性：
| 安全功能 | 实现 | 优势 |
|---|---|---|
| 证书验证 | 自动验证证书 | 防止中间人攻击 |
| 更新通道系统 | 定向更新分发 | 支持安全测试 |
| CI/CD 集成 | 部署期间的自动化安全检查 | 确保一致的保护 |
- 自动化安全检查：确保更新期间 SSL pinning 保持有效。
- 灵活的部署选项：提供云托管和自托管方案，满足不同需求。
- 实时监控：跟踪更新性能和安全指标，以保持可靠性。
Capgo 的架构支持固定证书 pinning 和动态证书更新，让开发者能灵活选择最适合其应用的 SSL pinning 策略。这确保符合 Apple 和 Android 标准，同时全程保持强大的安全性。
总结
SSL pinning 对确保移动应用安全通信至关重要。下面拆解有效实施 SSL pinning 的关键方法、优势和要点。
核心要点
现代 SSL 固定工具支持多种平台，主要强调以下三种策略：
| 策略 | 核心优势 | 最佳适用场景 |
|---|---|---|
| 证书固定 (Certificate Pinning) | 简化验证流程 | 证书配置稳定的应用 |
| 公钥固定 (Public Key Pinning) | 降低维护要求 | 需要灵活证书配置的应用 |
| 混合方案 | 兼顾安全性与适应性 | 复杂的企业级应用 |
2011 年荷兰 DigiNotar 事件敲响了警钟，让人们深刻认识到证书验证的重要性。该事件暴露了移动应用安全中的漏洞，并推动了 SSL pinning 实践的进步。
“无论你选择哪种实现方式，都要记住 Android Certificate Pinning 是必须的。它是确保网络真正安全的唯一手段。这也是 OWASP Mobile 将证书 pinning 认定为防御中间人攻击最有效手段的原因。” —— OWASP Mobile [1]
Android 和 iOS 的实现方式各不相同，需要针对各平台的安全需求采取定制化方案。Capgo 的安全更新功能就展示了如何有效应用 SSL pinning，在强大安全措施与顺畅部署流程之间取得平衡。
这些要点凸显了选择正确 pinning 策略的重要性：既保护应用安全，又保证用户体验流畅。
常见问题
::: 常见问题
证书锁定（Certificate Pinning）和公钥锁定（Public Key Pinning）有什么区别？我该如何为我的应用选择合适的方案？
证书固定（Certificate pinning）和公钥固定（Public key pinning）是两种用于保护 SSL/TLS 连接的方法，但它们的运作方式截然不同。
证书固定 将您的应用直接绑定到特定的服务器证书。在 SSL 握手期间，应用仅信任该确切证书。这种方法能有效防御中间人（MITM）攻击，但存在一个缺点：每当证书续期时，应用也必须更新以反映这一变化。
公钥固定相比之下，侧重于证书中包含的公钥。这种方法更灵活，因为相同的公钥可以在证书续期过程中保持一致，从而最大限度地减少频繁更新的需求。然而，它不会验证整个证书链，如果受信任的证书颁发机构（CA）被攻破，可能会带来风险。
两者之间的选择取决于您应用的需求。如果您的证书经常更新，公钥固定可以帮您避免持续更新。但如果您追求更严格的安全性和更强的控制力，证书固定可能是更好的选择。 :::
::: 常见问题
当证书发生变化时，如何保持 SSL 固定的安全性和功能性？
为了在证书更新时保持 SSL 固定的安全性和功能性，明智的做法是使用 多个具有交错过期日期的证书固定 。这样，如果一个证书过期，您的应用可以无缝切换到另一个有效证书，而不会中断服务。
养成习惯，每当服务器的 SSL 证书发生变化时，更新您应用 code 中的固定证书。使用 CI/CD 流水线 能让流程更顺畅，并降低出现安全漏洞的风险。专为 SSL 固定（pinning）打造的工具和库也能简化配置，同时保持严格的安全实践。对于 Capacitor 应用，像 Capgo 这样的平台提供了额外优势，允许实时更新，同时符合 Apple 和 Android 的指南。 :::
::: 常见问题
在移动应用中测试 SSL 固定以防止中间人（MITM）攻击的最佳实践是什么？
要正确测试移动应用中的 SSL 固定并防范 中间人 (MITM) 攻击，开发者应关注几个关键步骤。首先，同时使用 证书固定 以及 公钥固定。这种方法确保应用仅接受受信任的证书或公钥，使攻击者更难拦截敏感信息。
测试在此处至关重要。像 Burp Suite 或 OWASP ZAP 可以模拟 MITM 攻击，让你验证应用是否正确拒绝了未授权的证书。请确保保持固定证书的最新状态——过期或过时的证书可能会削弱应用的安全性。定期测试和维护你的配置是保持安全的关键。
对于使用 Capacitor 构建的应用，像 Capgo 可以带来变革性的改变。Capgo 不仅支持 Live Update，还能安全地集成到你应用的 CI/CD pipeline 中。这使得快速部署修复或更新变得更加容易，同时符合 Apple 和 Android 的指南。 :::
继续了解 SSL Pinning 实现：工具和插件
如果你正在使用 SSL Pinning 实现方案：工具与插件 来规划安全与合规，请结合 加密 了解 Encryption 的实现细节， 合规性 了解合规部分的实现细节， Capgo 安全扫描器 了解 Capgo Security Scanner 的产品工作流， Capgo 安全 用于 Capgo 安全的产品工作流，以及 Capgo 信任中心 用于 Capgo 信任中心的产品工作流。
