HSTS Parser
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
Chrome with 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.