Skip to content

v2.2.1 - TPM Documentation Update

Latest

Choose a tag to compare

@Johnsonajibi Johnsonajibi released this 21 Dec 05:47
· 25 commits to main since this release

Device Fingerprinting Pro v2.2.1

Release Date

December 21, 2025

Overview

This release updates PyPI documentation to include comprehensive TPM (Trusted Platform Module) dual-mode architecture documentation.

What's New

Documentation Updates

  • Added TPM/Secure Hardware Fingerprinting section to PyPI README
  • Documented dual-mode architecture (software and tpm_strict modes)
  • Added platform-specific TPM support details
  • Included code examples for both enforcement modes

TPM Dual-Mode Architecture (from v2.2.0)

Mode A: Software (Default)

  • Optional TPM usage with graceful fallback
  • Works on all platforms
  • Recommended for general-purpose deployments

Mode B: TPM-Strict

  • Mandatory TPM hardware attestation
  • Explicit failure if TPM unavailable
  • Recommended for high-security deployments

Platform Support

  • Windows: TPM 2.0 via PowerShell/WMI
  • macOS: Secure Enclave (T2 chip, Apple Silicon)
  • Linux: TPM 2.0 via /sys/class/tpm

Installation

pip install device-fingerprinting-pro==2.2.1

Usage Examples

Software Mode (Default)

import device_fingerprinting as df

df.enable_tpm_fingerprinting(enabled=True)
fingerprint = df.generate_fingerprint(method="stable", mode="software")

TPM-Strict Mode

import device_fingerprinting as df

try:
    fingerprint = df.generate_fingerprint(method="stable", mode="tpm_strict")
except RuntimeError as e:
    print(f"TPM required: {e}")

Full Changelog

v2.2.1 (2025-12-21)

  • Updated PyPI README with TPM dual-mode documentation
  • Enhanced code examples for TPM usage
  • Added platform compatibility matrix

v2.2.0 (2025-12-21)

  • Added TPM/Secure Hardware fingerprinting support
  • Implemented dual-mode architecture (software/tpm_strict)
  • Cross-platform TPM detection (Windows, macOS, Linux)
  • Hardware attestation with privacy-preserving obfuscation
  • Enhanced security for deployments requiring hardware-backed identity

Links

Contributors

@Johnsonajibi

License

MIT License