Skip to main content

HSTS Parser

Lint Codebase Build Releases Licence Python 3.11.x PyPI Downloads Copr build status

HSTS Parser is a simple tool to parse Firefox and Chrome's HSTS databases into actually helpful forensic artifacts! You can read more about the research behind this tool and potential uses for it over on my blog!

Installation

HSTS Parser can be installed via pip, or as a native executable.

From PyPi

If you already have Python installed, you can install HSTS Parser using pip.

pip install hstsparser

On Fedora

HSTS Parser is available through Fedora COPR for Fedora 38+.

dnf copr enable thebeanogamer/hstsparser
dnf install hstsparser

On Windows

Windows binaries are published by GitHub Actions CI for each release of HSTS Parser. You can download these on the releases page.

Usage

All of the below documentation is written for the Python version rather than the standalone executable, but the commands will be the same.

$ hstsparser -h
usage: hstsparser [-h] [-w WORDLIST] [--csv CSV] (--firefox | --chrome) FILE

Process HSTS databases

positional arguments:
  FILE         The path to the database to be processed

optional arguments:
  -h, --help   show this help message and exit
  -w WORDLIST  The path to the database to be processed
  --csv CSV    Output to a CSV file
  --firefox    Process a Firefox database
  --chrome     Process a Chrome database

Examples

Firefox

hstsparser --firefox SiteSecurityServiceState.txt

Chrome

hstsparser --chrome TransportSecurity

Chrome with Wordlist

hstsparser -w wordlist.txt --chrome TransportSecurity

Screenshots

Firefox

Screenshot of Firefox Processing

Chrome with Wordlist

Screenshot of Chrome Processing with a wordlist

Links

Metadata

Release files for hstsparser 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hstsparser 1.2.0
File Size Uploaded Provenance Actions
hstsparser-1.2.0.tar.gz 5.2 kB Without provenance Details for hstsparser-1.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hstsparser 1.2.0
File Interpreter ABI Platform Actions
hstsparser-1.2.0-py3-none-any.whl Python 3 none any Details for hstsparser-1.2.0-py3-none-any.whl

Total release size: 11.5 kB

Release files / hstsparser-1.2.0.tar.gz

Download URL hstsparser-1.2.0.tar.gz
Size 5.2 kB
Tags Source
SHA-256 checksum
How to use checksums
56447fcdaf83acedacb4ff6ee56a695de4d3fe194cbd924c5d3723b37522d843
BLAKE2b-256 checksum
How to use checksums
6346757dc85525170fc12a5be68f7d7b2ed39730d200f7d736a71ab62d9cbccc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.5.0 CPython/3.11.3 Linux/5.15.0-1038-azure

Release files / hstsparser-1.2.0-py3-none-any.whl

Download URL hstsparser-1.2.0-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1a1fed8ce2c7c472684e0f26817a3d650c7f945bfd635f967db30e582632568e
BLAKE2b-256 checksum
How to use checksums
cd365db1a412dd6e49fa004f17d1fd9bc1b5b36d2a02f1f05b936e238c180155
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.5.0 CPython/3.11.3 Linux/5.15.0-1038-azure

Security for hstsparser 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page