Operation

Docker

While this tool can be run by installing the dependent Python3 modules to your local machine, it is design so you can install Docker and run the tool inside a container. The goal is to prevent issues with differing Python 2 & 3 versions, as well as possible dependency issues.

You can install Docker to your local machine by clicking this link.

Make

For ease of operation, this is a Makefile driven project. Once you’ve installed Docker, type the command make to show the options available.

user@host: ~ 🐦  make
clean                Cleanup all the things
docker               build docker container for testing
docs                 Generate documentation
python               setup python3
test                 run tests in container

Use the command `make docker` to set up the container.

Running Scans

To run the detail and summary reports for a domain, change to the /app/assassin directory and run the tool.

user@host: ~ 🐦  make docker
Successfully built f591a2044610
Successfully tagged docker_assassin:latest
root@assassin:/app# cd assassin
root@assassin:/app/assassin# python assassin.py --domain paloaltonetworks.com

If you do not pass the –domain flag you will be prompted to manually enter a domain.

root@assassin:/app/assassin# python assassin.py
Signatures loaded
What domain would you like to search ? paloaltonetworks.com

Logging

The tool is configured to write a log file to /var/log/secops/assassin.log. See the troubleshooting section for more details.