har-capture 0.3.3

HAR capture and PII sanitization library for network traffic analysis

har-capture

Capture and sanitize HAR (HTTP Archive) files with deep PII removal. Perfect for support diagnostics, security reviews, and test fixtures.

Quick Start

Windows

1. Install Python from the Microsoft Store or python.org
2. Open PowerShell and run:

pip install har-capture[full]
python -m har_capture get https://example.com

macOS / Linux

pip install har-capture[full]
har-capture get https://example.com

Already have a HAR file?

pip install har-capture
har-capture sanitize myfile.har

---

Why har-capture?

Chrome DevTools now sanitizes cookies and auth headers, but HAR files contain much more sensitive data: IP addresses, MAC addresses, emails, passwords in form bodies, serial numbers, device names, WiFi credentials, session tokens, and API keys.

How har-capture compares:

Feature	har-capture	DevTools	Google/Cloudflare
Deep sanitization (IPs, MACs, emails)	✅	❌	❌
Correlation-preserving hashes	✅	❌	❌
Interactive review	✅	❌	Varies
Custom patterns	✅	❌	Limited
Local + CLI automation	✅	No CLI	Varies

Key benefits:

• Zero dependencies - Core sanitization uses only Python stdlib
• Format-preserving hashes - Track the same device across requests without exposing real values
• One-command workflow - Capture, sanitize, and compress in a single step

See detailed comparison with all tools →

---

Installation

# Core only (sanitization - zero dependencies)
pip install har-capture

# With browser capture support
pip install har-capture[capture]
playwright install chromium

# Full installation (recommended)
pip install har-capture[full]

---

Usage

Command Line

# Capture and sanitize
har-capture get https://example.com

# Sanitize existing HAR
har-capture sanitize capture.har

# Interactive mode (review suspicious values)
har-capture sanitize capture.har --interactive

# Validate for PII leaks
har-capture validate capture.har

Full CLI reference →

Python API

from har_capture.sanitization import sanitize_html, sanitize_har_file
from har_capture.sanitization.report import HeuristicMode

# Sanitize HTML (correlation-preserving by default)
clean_html = sanitize_html(raw_html)

# Sanitize with consistent salt (correlate across captures)
clean_html = sanitize_html(raw_html, salt="my-secret-key")

# Enable heuristic detection for WiFi, SSIDs, device names
clean_html = sanitize_html(raw_html, heuristics=HeuristicMode.REDACT)

# Sanitize HAR file
sanitize_har_file("capture.har")  # → capture.sanitized.har

# Custom patterns (e.g., modem serials, customer IDs)
custom = {"patterns": {"modem_sn": {"regex": r"SN[0-9]{10}", "replacement_prefix": "MODEM"}}}
sanitize_har_file("capture.har", custom_patterns=custom)

---

Documentation

• Comparison with Other Tools - DevTools, Google, Cloudflare, Edgio
• Correlation-Preserving Redaction - How format-preserving hashing works
• PII Categories - What gets sanitized
• Custom Patterns - Add organization-specific patterns
• CLI Reference - Detailed command documentation
• Interactive Sanitization - Review edge cases manually

---

Use Cases

• Support diagnostics - Users submit sanitized HAR files without exposing credentials
• Security review - Validate HAR files for PII leaks before sharing
• Test fixtures - Generate reproducible traffic captures
• Modem debugging - Capture router/modem traffic with sensitive data removed

---

What Gets Sanitized

Category	Examples	Output
Network	IPs, MACs	192.168.1.1 → 10.255.42.17
Personal	Emails, phones	[e-mail] → [e-mail]
Credentials	Passwords, tokens	password=secret → password=PASS_a1b2c3d4
Device	Serials, WiFi, SSIDs	SN123456 → SERIAL_a1b2c3d4
HTTP	Auth headers, cookies	Cookie: session=xyz → Cookie: session=TOKEN_a1b2

See complete PII categories list →

---

Platform Support

Component	Windows	macOS	Linux
Sanitization	✅	✅	✅
Validation	✅	✅	✅
CLI	✅	✅	✅
Capture	✅	✅	✅

---

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

---

License

MIT License - see LICENSE for details.