Search packages, repositories and app categories

Package detailsv3.0.2

http_certificate_pinning

Https Certificate pinning for Flutter. Checks the equality between the known SHA-1 or SHA-256 fingerprint and the SHA-1 or SHA-256 of the target server.

AndroidiOS
30-day downloads
36K
Likes
163
Pub points
125

Install package

flutter pub add http_certificate_pinning

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that enables HTTPS certificate pinning to enhance security by verifying server certificates against known SHA-1 or SHA-256 fingerprints. It ensures the connection is secure by validating that the server's certificate matches a predefined, trusted fingerprint, protecting against man-in-the-middle attacks. The package integrates with HTTP clients and supports both Android and iOS platforms.

Use cases

  • Securing API communications in sensitive apps
  • Preventing MITM attacks on mobile networks
  • Validating server identity in financial or healthcare apps
  • Enforcing trust in custom or internal APIs

Key features

  • Supports SHA-1 and SHA-256 fingerprint validation
  • Easy integration with HTTP clients
  • Cross-platform (Android & iOS)
  • Simple configuration via fingerprints
  • Runtime certificate verification

Suitable for

  • Security-conscious mobile applications
  • Apps handling sensitive user data
  • Enterprise-grade network communication
  • Developers implementing strict TLS policies

Considerations

  • Requires accurate and up-to-date certificate fingerprints
  • Fingerprint changes require app updates
  • Not suitable for dynamic or frequently changing endpoints
  • Manual management of certificate trust boundaries

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

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;
  }
}

Categories

Dependencies

Dependency list 2 items

Source repository

Projects using this package