SSL Pinning 底层实现：通过 `SecurityContext` 定制 Dart `HttpClient`

大家好，今天我们来深入探讨一个重要的安全话题：SSL Pinning。在移动应用和客户端应用中，SSL Pinning 是一种增强 HTTPS 连接安全性的技术，旨在防止中间人攻击。我们将专注于如何在 Dart 语言中使用 SecurityContext 定制 HttpClient 来实现 SSL Pinning。

1. SSL Pinning 的必要性

在理解 SSL Pinning 的实现之前，我们先来了解它为何如此重要。传统的 HTTPS 连接依赖于证书颁发机构 (CA) 的信任链。客户端验证服务器证书的过程是：客户端信任 CA 列表 -> CA 签发服务器证书 -> 客户端验证服务器证书是否由受信任的 CA 签发。

这种模式存在潜在的风险：

CA 被攻破： 如果攻击者能够攻破一个受信任的 CA，他们就可以颁发伪造的证书，从而进行中间人攻击。
流氓 CA： 有些 CA 可能不够谨慎，颁发了不应该颁发的证书。
配置错误： 客户端可能配置了过于宽松的信任策略，信任了过多的 CA。

SSL Pinning 通过在客户端硬编码或配置服务器的证书或公钥指纹（Pin），从而绕过对 CA 的信任链的依赖，直接验证服务器证书的有效性。这样，即使 CA 被攻破或者存在流氓 CA，只要攻击者无法获取服务器的私钥，就无法成功进行中间人攻击。

2. SSL Pinning 的实现方式

SSL Pinning 主要有三种实现方式：

证书 Pinning： 将服务器的完整证书（通常是 PEM 格式）嵌入到客户端代码中。客户端在建立 HTTPS 连接时，将服务器返回的证书与嵌入的证书进行比较，如果一致则认为连接安全。
公钥 Pinning： 将服务器证书的公钥（通常是 Subject Public Key Info，SPKI）的哈希值（指纹）嵌入到客户端代码中。客户端在建立 HTTPS 连接时，计算服务器证书公钥的哈希值，并与嵌入的哈希值进行比较，如果一致则认为连接安全。
中间证书 Pinning： Pinning 中间证书的公钥或证书。这在服务器证书由中间 CA 签发的情况下有用。

通常，公钥 Pinning 被认为是一种更好的选择，因为它更容易维护。当服务器更换证书时，只需要更新公钥哈希值，而不需要更新整个证书。

3. Dart 中使用 SecurityContext 实现 SSL Pinning 的原理

在 Dart 中，HttpClient 类用于发起 HTTP 请求。而 HttpClient 的安全性依赖于 SecurityContext 类。SecurityContext 类允许我们配置 TLS/SSL 连接的各种参数，包括：

trustedCertificates: 指定客户端信任的证书列表。我们可以将服务器的证书添加到这个列表中，从而实现证书 Pinning。
withTrustedRoots: 指示是否使用系统默认的信任根证书。如果设置为 false，则只信任 trustedCertificates 中指定的证书。
alpnProtocols: 指定应用层协议协商 (ALPN) 协议列表。

通过定制 SecurityContext，我们可以控制 HttpClient 的信任策略，从而实现 SSL Pinning。

4. 代码实现：证书 Pinning

下面是一个使用证书 Pinning 的示例代码：

import 'dart:io';
import 'dart:convert';

Future<void> main() async {
  // 1. 读取服务器证书
  final certificateFile = File('path/to/your/server.pem'); // 替换为你的证书文件路径
  final certificate = certificateFile.readAsStringSync();

  // 2. 创建 SecurityContext
  final securityContext = SecurityContext()
    ..setTrustedCertificatesBytes(utf8.encode(certificate));

  // 3. 创建 HttpClient
  final client = HttpClient(context: securityContext);

  try {
    // 4. 发起 HTTPS 请求
    final request = await client.getUrl(Uri.parse('https://your.domain.com')); // 替换为你的服务器地址
    final response = await request.close();

    // 5. 处理响应
    if (response.statusCode == HttpStatus.ok) {
      final body = await response.transform(utf8.decoder).join();
      print('Response body: $body');
    } else {
      print('Request failed with status: ${response.statusCode}.');
    }
  } catch (e) {
    print('An error occurred: $e');
  } finally {
    client.close();
  }
}

代码解释：

读取服务器证书： 首先，我们需要将服务器的证书（PEM 格式）读取到内存中。certificateFile 变量指向证书文件的路径。
创建 SecurityContext： 创建一个 SecurityContext 实例，并使用 setTrustedCertificatesBytes() 方法将证书添加到信任列表中。utf8.encode() 用于将字符串转换为字节数组。
创建 HttpClient： 创建一个 HttpClient 实例，并将 SecurityContext 传递给它的构造函数。
发起 HTTPS 请求： 使用 client.getUrl() 方法发起 HTTPS 请求。
处理响应： 处理服务器返回的响应。

注意事项：

确保 server.pem 文件包含有效的 PEM 格式的证书。
将 path/to/your/server.pem 替换为实际的证书文件路径。
将 https://your.domain.com 替换为实际的服务器地址。
如果服务器的证书链中包含中间证书，需要将所有证书添加到 trustedCertificates 列表中。

5. 代码实现：公钥 Pinning

下面是一个使用公钥 Pinning 的示例代码：

import 'dart:io';
import 'dart:convert';
import 'dart:typed_data';

import 'package:crypto/crypto.dart';
import 'package:pointycastle/asymmetric/api.dart';
import 'package:pointycastle/asn1/asn1_parser.dart';
import 'package:pointycastle/asn1/primitives/asn1_octet_string.dart';
import 'package:pointycastle/asn1/primitives/asn1_sequence.dart';

String calculateSPKIHash(String certificate) {
  final asn1Parser = ASN1Parser(Uint8List.fromList(certificate.codeUnits));
  final topLevelSequence = asn1Parser.nextObject() as ASN1Sequence;
  final certificateSequence = topLevelSequence.elements![0] as ASN1Sequence;
  final subjectPublicKeyInfo = certificateSequence.elements![6] as ASN1Sequence; // Adjust index if needed
  final publicKeyBitString = subjectPublicKeyInfo.elements![1] as ASN1OctetString;
  final publicKeyBytes = publicKeyBitString.stringValues[0];

  final sha256Hash = sha256.convert(publicKeyBytes);
  return base64Encode(sha256Hash.bytes);
}

Future<void> main() async {
  // 1. 读取服务器证书
  final certificateFile = File('path/to/your/server.pem'); // 替换为你的证书文件路径
  final certificate = certificateFile.readAsStringSync();

  // 2. 计算证书公钥的 SHA256 哈希值 (指纹)
  final expectedSPKIHash = calculateSPKIHash(certificate);

  // 3. 创建 SecurityContext
  final securityContext = SecurityContext();

  // 4. 创建 HttpClient
  final client = HttpClient(context: securityContext);

  client.badCertificateCallback = (X509Certificate cert, String host, int port) {
    try {
      // Parse the certificate to extract the SPKI
      final asn1Parser = ASN1Parser(cert.der);
      final topLevelSequence = asn1Parser.nextObject() as ASN1Sequence;
      final tbsCertificate = topLevelSequence.elements![0] as ASN1Sequence;
      final subjectPublicKeyInfo = tbsCertificate.elements![6] as ASN1Sequence;
      final publicKeyBitString = subjectPublicKeyInfo.elements![1] as ASN1OctetString;
      final publicKeyBytes = publicKeyBitString.stringValues[0];

      // Calculate the SHA-256 hash of the SPKI
      final spkiHash = sha256.convert(publicKeyBytes);
      final spkiHashBase64 = base64Encode(spkiHash.bytes);

      // Compare the calculated hash with the expected hash
      if (spkiHashBase64 == expectedSPKIHash) {
        print('Certificate validated using SPKI pinning.');
        return true; // Accept the certificate
      } else {
        print(
            'Certificate validation failed: SPKI hash mismatch. Expected: $expectedSPKIHash, Actual: $spkiHashBase64');
        return false; // Reject the certificate
      }
    } catch (e) {
      print('Error during certificate validation: $e');
      return false; // Reject the certificate in case of error
    }
  };

  try {
    // 5. 发起 HTTPS 请求
    final request = await client.getUrl(Uri.parse('https://your.domain.com')); // 替换为你的服务器地址
    final response = await request.close();

    // 6. 处理响应
    if (response.statusCode == HttpStatus.ok) {
      final body = await response.transform(utf8.decoder).join();
      print('Response body: $body');
    } else {
      print('Request failed with status: ${response.statusCode}.');
    }
  } catch (e) {
    print('An error occurred: $e');
  } finally {
    client.close();
  }
}

代码解释：

读取服务器证书： 与证书 Pinning 相同，首先读取服务器证书。
计算证书公钥的 SHA256 哈希值 (指纹)： 使用 calculateSPKIHash 函数计算证书公钥的 SHA256 哈希值。这个函数使用 pointycastle 包来解析证书的 ASN.1 结构，提取公钥，并计算哈希值。函数首先将PEM格式的证书转换成DER格式, 然后解析DER格式的证书，拿到公钥进行hash计算。
创建 SecurityContext： 创建一个 SecurityContext 实例。这里不需要添加任何证书到trustedCertificates，因为我们使用badCertificateCallback进行自定义验证。
创建 HttpClient： 创建一个 HttpClient 实例，并将 SecurityContext 传递给它的构造函数。
设置 badCertificateCallback： badCertificateCallback 是一个回调函数，当服务器证书验证失败时（例如，证书不在系统信任列表中），该函数会被调用。我们在这个回调函数中实现公钥 Pinning 的逻辑。
- 在 badCertificateCallback 中，我们首先获取服务器返回的证书 (X509Certificate)。
- 然后，我们计算证书公钥的 SHA256 哈希值，并与预期的哈希值进行比较。
- 如果哈希值匹配，则返回 true，表示接受该证书；否则，返回 false，表示拒绝该证书。
发起 HTTPS 请求： 与证书 Pinning 相同，使用 client.getUrl() 方法发起 HTTPS 请求。
处理响应： 与证书 Pinning 相同，处理服务器返回的响应。

注意事项：

需要添加 pointycastle 和 crypto 包到你的 pubspec.yaml 文件中。
确保 server.pem 文件包含有效的 PEM 格式的证书。
将 path/to/your/server.pem 替换为实际的证书文件路径。
将 https://your.domain.com 替换为实际的服务器地址。
在生产环境中，应该将 expectedSPKIHash 硬编码到代码中，或者从安全的地方读取。

6. 选择合适的 Pinning 策略

选择哪种 Pinning 策略取决于你的具体需求：

策略	优点	缺点	适用场景
证书 Pinning	简单易懂，容易实现。	证书过期或更换时，需要更新客户端代码。	证书更换频率较低，并且有能力控制客户端更新的应用。
公钥 Pinning	更灵活，证书更换时只需要更新公钥哈希值，不需要更新整个证书。	实现相对复杂，需要解析证书并计算公钥哈希值。	证书更换频率较高，或者需要更灵活的证书管理的应用。
中间证书 Pinning	可以减少维护工作，因为中间证书通常比服务器证书更稳定。	需要确保选择的中间证书是可信的，并且不会被轻易撤销。	服务器证书由中间 CA 签发，并且希望减少维护工作量的应用。

7. 动态 Pinning 和 Pinning 的备份

在实际应用中，最好采用动态 Pinning 和 Pinning 的备份策略：

动态 Pinning： 从服务器动态获取 Pinning 信息。客户端第一次连接服务器时，服务器返回 Pinning 信息（例如，公钥哈希值）。客户端将这些信息存储起来，并在后续的连接中使用。
Pinning 的备份： 配置多个 Pinning 值，以防止证书更换或 CA 被攻破导致客户端无法连接服务器。例如，可以同时 Pinning 当前证书和备用证书的公钥。

8. 安全风险和最佳实践

虽然 SSL Pinning 可以增强 HTTPS 连接的安全性，但也存在一些风险：

误 Pinning： 如果 Pinning 了错误的证书或公钥，会导致客户端无法连接服务器。
证书更新问题： 如果服务器更换证书，而客户端没有及时更新 Pinning 信息，会导致客户端无法连接服务器。
代码泄露： 如果客户端代码被泄露，攻击者可以获取 Pinning 信息，并绕过 Pinning 机制。

为了降低这些风险，建议采用以下最佳实践：

谨慎选择 Pinning 对象： 选择服务器证书或中间证书的公钥进行 Pinning。
实施 Pinning 的备份： 配置多个 Pinning 值，以防止证书更换或 CA 被攻破。
使用动态 Pinning： 从服务器动态获取 Pinning 信息。
定期更新 Pinning 信息： 定期检查和更新 Pinning 信息，以确保其有效性。
保护客户端代码： 采取措施保护客户端代码，防止代码泄露。
监控 Pinning 失败事件： 监控 Pinning 失败事件，及时发现和解决问题。
使用专业的 SSL Pinning 库： 如果可能，使用专业的 SSL Pinning 库，这些库通常提供了更安全和更易用的 API。

9. 其他注意事项

在 Android 上，可以使用 Network Security Configuration 文件来配置 SSL Pinning。
在 iOS 上，可以使用 Info.plist 文件来配置 SSL Pinning。
确保你的服务器配置正确，并且使用了安全的 TLS/SSL 协议。

SSL Pinning 的核心在于信任的锚点转移

SSL Pinning 将信任的锚点从 CA 转移到了客户端自身，通过预先设定的证书或公钥指纹，绕过了对 CA 信任链的依赖，有效防范了中间人攻击，提高了应用程序的安全性。

选择合适的 Pinning 策略并实施备份是关键

根据实际需求选择合适的 Pinning 策略，并实施备份机制，可以最大限度地降低风险，确保应用程序的稳定性和安全性。

不断学习和实践是安全的关键

安全是一个持续的过程，需要不断学习和实践，才能应对不断变化的安全威胁。希望这次的分享能帮助你更好地理解和应用 SSL Pinning 技术。

SSL Pinning 底层实现：通过 SecurityContext 定制 Dart HttpClient

发表回复 取消回复

SSL Pinning 底层实现：通过 `SecurityContext` 定制 Dart `HttpClient`

发表回复取消回复