ShoMon is a Shodan alert feeder for TheHive written in GoLang. With version 2.0, it is more powerful than ever!

Usage

• Parameters should be provided via conf.yaml or environment variables. Please see config file and docker-compose file

• After conf or environment variables are set simply issue command:

  ./shomon

Notes

• Alert reference is first 6 chars of md5(“ip:port”)
• Only 1 mod can be active at a time. Webhook and Stream listener can not be activated together.

Setup & Compile Instructions

Get latest compiled binary from releases

1. Check Releases section.

Compile from source code

1. Make sure that you have a working Golang workspace.
2. go build .
   • go build -ldflags="-s -w" . could be used to customize compilation and produce smaller binary.

Using Public Container Registries

1. Thanks to new CI/CD integration, latest versions of built images are pushed to ghcr, DockerHub and can be utilized via:
   • docker pull ghcr.io/kaansk/shomon
   • docker pull kaansk/shomon

Using Dockerfile

1. Edit config file or provide environment variables to commands bellow
2. docker build -t shomon .
3. docker run -it shomon

Using docker-compose file

1. Edit environment variables and configurations in docker-compose file
2. docker-compose run -d

Credits

• Logo Made via LogoMakr.com
• shadowscatcher/shodan
• Dockerfile Reference
• Release management with GoReleaser