This is a SSL Analyzer that can be used to check the SSL certificate of a given domain. It checks for supported protocols, and alt names specified in the certificate.

It uses an awesome testssl.sh tool to perform the analysis. The tool is packaged in a Docker container and is run in parallel using GNU Parallel.

The output is written to a Clickhouse database.

• SSL Analyzer
  • Description
  • Table of Contents
  • Usage
    • Installation
    • Environment Variables
    • Input File
    • Run
  • Contributing
    • Poetry
    • Dependencies
    • Development

Note for Windows Users:

If you are using Windows, it's important to ensure that you have Windows Subsystem for Linux (WSL) 2 installed and configured correctly before running the provided commands under a WSL terminal. WSL 2 provides a Linux-compatible environment that can be used for development tasks.

To install and set up WSL 2 on your Windows machine, please follow the official Microsoft documentation: Install Windows Subsystem for Linux (WSL).

Once WSL 2 is set up, make sure to use the WSL terminal for running the commands specified in this documentation for a seamless development experience.

If you encounter any issues related to WSL or need further assistance, please refer to the Microsoft WSL documentation or seek support from the WSL community.

1. Install Docker
2. Install Docker Compose

The following environment variables are required to run the application:

Provide the input file as a command line argument. The input file should contain a list of host:port, one per line. The output will be written to Clickhouse database.

Create a file named input.txt in the data directory and add the following content to it:

touch ./data/input.txt
echo "google.com:443" >> data/input.txt
echo "facebook.com:443" >> data/input.txt

Now you can run the following command to start the application:

make compose-up

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Install poetry using your package manager or official guide.

The easiest way to install required and dev dependencies is as follows:

make install

This will install all the dependencies and create a virtual environment for you.

Now you can format the code using:

make format

To run linters:

make lint

To run tests:

make test