SNARE

スーパー・ネクスト・ジェネレーション・アドバンスト・リアクティブはちみつポット

概要

SNARE は、インターネットからのあらゆる悪意のあるアクティビティを引き寄せる Web アプリケーションハニーポットセンサーです。

ドキュメント

ドキュメントはこちらからご覧いただけます。

基本概念

攻撃面を第一に。攻撃面の生成に重点を置く。
センサーとマスター。軽量コレクタ (SNARE) と中央意思決定者 (tanner)。

はじめ方

SNARE を実行するには Python3.6 が必要です
これは最近の Ubuntu ベースの Linux でテストされました。

セットアップ手順

SNARE を入手: git clone https://github.com/mushorg/snare.git して cd snare
[オプション] 仮想環境を作成: python3 -m venv venv
[オプション] 仮想環境をアクティベート: . venv/bin/activate

注: 仮想環境内で SNARE を実行している場合、以下のコマンドで sudo を使用しないでください。

依存関係をインストール: sudo pip3 install -r requirements.txt
SNARE をセットアップ: sudo python3 setup.py install
ページをクローン: sudo clone --target http://example.com --path <ベースディレクトリのパス>
SNARE を実行: sudo snare --port 8080 --page-dir example.com --path <ベースディレクトリのパス>
テスト: http://localhost:8080/index.html にアクセス
(オプション) 独自の tanner サービスを実行する。

[注: クローナーはウェブサイト全体をクローンします。クローンの深さを制限するには --max-depth パラメータを追加してください]

Docker ビルド手順

カレントディレクトリを snare プロジェクトディレクトリに変更
docker-compose build
docker-compose up
SNARE が 0.0.0.0 のポート 80 で起動します。 docker-compose の実行に関する詳細はこちらを参照してください。

docker-compose up 実行時にエラーが発生した場合は、ポート 80 が使用可能か確認してください。占有されている場合は、Docker のドキュメントを参照してデフォルトポートを変更してください。

_本番環境_で実行する場合は、当然 0.0.0.0 とポート 80 にバインドする必要があります。

テスト

テストを実行し、テストカバレッジレポートを受け取るには、pytest の実行をお勧めします:

    pip install pytest pytest-cov
    sudo pytest --cov-report term-missing --cov=snare snare/tests/

出力例


    # sudo snare --port 8080 --page-dir example.com

       _____ _   _____    ____  ______
      / ___// | / /   |  / __ \/ ____/
      \__ \/  |/ / /| | / /_/ / __/
     ___/ / /|  / ___ |/ _, _/ /___
    /____/_/ |_/_/  |_/_/ |_/_____/


    privileges dropped, running as "nobody:nogroup"
    serving with uuid 9c10172f-7ce2-4fb4-b1c6-abc70141db56
    Debug logs will be stored in /opt/snare/snare.log
    Error logs will be stored in /opt/snare/snare.err
    ======== Running on http://127.0.0.1:8080 ========
    (Press CTRL+C to quit)
    you are running the latest version

snare

人気