搜索插件、代码仓与 APP 分类

插件详情v3.0.2

http_certificate_pinning

Flutter 的 HTTPS 证书固定。检查已知的 SHA-1 或 SHA-256 指纹与目标服务器的 SHA-1 或 SHA-256 是否相等。

AndroidiOS
近 30 天下载
3.6万
喜欢数
163
Pub 分数
125

安装插件

flutter pub add http_certificate_pinning

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个 Flutter 包,通过将服务器证书与已知的 SHA-1 或 SHA-256 指纹进行验证,增强安全性。它通过验证服务器证书是否匹配预定义的可信指纹来确保连接安全,从而防范中间人攻击。该包与 HTTP 客户端集成,并支持 Android 和 iOS 平台。

适合场景

  • 在敏感应用中保护API通信
  • 防止移动网络上的中间人攻击
  • 在金融或医疗应用中验证服务器身份
  • 在自定义或内部 API 中强制执行信任

主要特点

  • 支持 SHA-1 和 SHA-256 指纹验证
  • 与HTTP客户端的轻松集成
  • 跨平台(Android 和 iOS)
  • 通过指纹进行简单配置
  • 运行时证书验证

适合对象

  • 注重安全的移动应用程序
  • 处理敏感用户数据的应用程序
  • 企业级网络通信
  • 实施严格 TLS 策略的开发人员

使用建议

  • 需要准确且最新的证书指纹
  • 指纹更改需要应用更新
  • 不适合动态或频繁变化的端点
  • 手动管理证书信任边界

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Http Certificate Pinning

Https Certificate pinning for Flutter

This project is based on ssl_pinning_plugin

Any help is appreciated! Comment, suggestions, issues, PR's!

Getting Started

In your flutter or dart project add the dependency:

dependencies:
  ...
  http_certificate_pinning: 3.0.1

Get Certificate FingerPrint

To get SHA256 certificate fingerprint run in console:

openssl x509 -noout -fingerprint -sha256 -inform pem -in [certificate-file.crt]

The Result is like:

'59:58:57:5A:5B:5C:5D:59:58:57:5A:5B:5C:5D:59:58:57:5A:5B:5C:5D:59:58:57:5A:5B:5C:5D:59:58:57:5A:5B:5C:5D'

Usage example

Using Dio
import 'package:http_certificate_pinning/http_certificate_pinning.dart';
  
  // Add CertificatePinningInterceptor in dio Client
  Dio getClient(String baseUrl, List<String> allowedSHAFingerprints) {
      var dio = Dio(BaseOptions(baseUrl: baseUrl))
        ..interceptors.add(CertificatePinningInterceptor(allowedSHAFingerprints));
      return dio;
  }

  myRepositoryMethod() {
    dio.get("myurl.com");
  }
Using Http
import 'package:http_certificate_pinning/secure_http_client.dart';
  
  // Uses SecureHttpClient to make requests
  SecureHttpClient getClient(List<String> allowedSHAFingerprints) {
      final secureClient = SecureHttpClient.build(certificateSHA256Fingerprints);
      return secureClient;
  }

  myRepositoryMethod() {
    secureClient.get("myurl.com");
  }
Other Client
import 'package:http_certificate_pinning/http_certificate_pinning.dart';
  
Future myCustomImplementation(String url, Map<String,String> headers, List<String> allowedSHAFingerprints) async {
  try {
    final secure = await HttpCertificatePinning.check(
      serverURL: url,
      headerHttp: headers,
      sha: SHA.SHA256,
      allowedSHAFingerprints: allowedSHAFingerprints,
      timeout : 50
    );

    return secure.contains("CONNECTION_SECURE");
  } catch(e) {
    return false;
  }
}

所属分类

依赖

依赖清单 2 项

源码仓库

使用此插件的项目