Axeman

Harvester of certificates, bearer of flannel.

What?

Axeman is a utility for downloading, parsing, and storing Certificate Transparency Lists using python3's concurrency and multi-processing. Its aim is to download and parse certificates relatively quickly and efficiently, storing them in CSVs on the local filesystem.

Installing it

Installation should be super straight forward, but you need a newer version of python (3.5+) to run it.

pip3 install axeman

Usage

$ axeman -h
usage: axeman [-h] [-f LOG_FILE] [-s START_OFFSET] [-l] [-u CTL_URL]
              [-o OUTPUT_DIR] [-v] [-c CONCURRENCY_COUNT]

Pull down certificate transparency list information

optional arguments:
  -h, --help            show this help message and exit
  -f LOG_FILE           location for the axeman log file
  -s START_OFFSET       Skip N number of lists before starting
  -l                    List all available certificate lists
  -u CTL_URL            Retrieve this CTL only
  -o OUTPUT_DIR         The output directory to store certificates in
  -v                    Print out verbose/debug info
  -c CONCURRENCY_COUNT  The number of concurrent downloads to run at a time

Demo

This is Axeman dumping information on each CTL known by certificate-transparency.org

$ axeman -l

This is axeman running in verbose mode and pulling down the SkyDiver CTL

$ axeman -v -u 'ct.googleapis.com/skydiver'