ShoMon は GoLang で書かれた TheHive 用の Shodan アラートフィーダーです。バージョン 2.0 により、これまで以上に強力になりました！

機能

• Webhook リスナーまたはストリームリスナーとして使用可能

  • Webhook リスナーは Shodan がアラートを送信するための RESTful API エンドポイントを開きます。つまり、このエンドポイントをパブリックネットに公開する必要があります。
  • ストリームリスナーは Shodan に接続し、アラートストリームを取得・解析します。

• Shodan とのやり取りには shadowscatcher/shodan（素晴らしい成果）を利用しています。

• コンソールログは JSON 形式で、他のログ管理ツールで取り込むことができます。

• Github Actions による CI/CD により、ghcr および dockerhub 上の changelogs、アーティファクト、イメージを含む適切なリリースが提供されます。

• TheHive と依存関係のための動作する docker-compose ファイル を提供します。

• 非常に高速で、サイズも超ミニマムです。

• v2.0 での完全なコードリファクタリングにより、よりモジュール化され、保守しやすいコードになりました。

• conf ファイルまたは環境変数を使用して、タグ、タイプ、アラートテンプレートなどのアラート詳細を動的に調整できます。設定ファイル を参照してください。

• Shodan の検索結果への直接リンクを含むフルバナーをアラートに含めることができます。

  

• IP は observable に追加されます。

  

使用方法

• パラメータは conf.yaml または環境変数で指定します。設定ファイル および docker-compose ファイル を参照してください。

• conf または環境変数を設定した後は、以下のコマンドを実行するだけです:

  ./shomon

注意事項

• アラート参照は md5("ip:port") の最初の 6 文字です。
• 同時にアクティブにできるモードは 1 つだけです。Webhook リスナーとストリームリスナーを同時に有効にすることはできません。

セットアップとコンパイル手順

リリースから最新のコンパイル済みバイナリを取得

1. リリース セクションを確認してください。

ソースコードからコンパイル

1. 動作する Golang ワークスペースがあることを確認してください。
2. go build .
   • go build -ldflags="-s -w" . を使用すると、コンパイルをカスタマイズしてより小さなバイナリを生成できます。

パブリックコンテナレジストリの利用

1. 新しい CI/CD 統合のおかげで、ビルドされたイメージの最新版が ghcr と DockerHub にプッシュされ、以下の方法で利用できます:
   • docker pull ghcr.io/kaansk/shomon
   • docker pull kaansk/shomon

Dockerfile の使用

1. 設定ファイル を編集するか、以下のコマンドに環境変数を指定してください。
2. docker build -t shomon .
3. docker run -it shomon

docker-compose ファイル の使用

1. docker-compose ファイル 内の環境変数と設定を編集します。
2. docker-compose run -d

クレジット

• ロゴは LogoMakr.com で作成されました。
• shadowscatcher/shodan
• Dockerfile Reference
• Release management with GoReleaser