SNARE

Super Nächste Generation Fortschrittlich Reaktiver HonEypot

Über

SNARE ist ein Webanwendungs-Honeypot-Sensor, der alle Arten von Bösartigkeit aus dem Internet anzieht.

Dokumentation

Die Dokumentation befindet sich hier.

Grundlegende Konzepte

• Oberfläche zuerst. Fokus auf die Erzeugung der Angriffsfläche.
• Sensoren und Master. Leichte Kollektoren (SNARE) und zentraler Entscheider (tanner).

Erste Schritte

• Sie benötigen Python 3.6, um SNARE auszuführen.
• Dies wurde mit einem aktuellen Ubuntu-basierten Linux getestet.

Schritte zur Einrichtung

1. SNARE herunterladen: git clone https://github.com/mushorg/snare.git und cd snare
2. [Optional] Virtuelle Umgebung erstellen: python3 -m venv venv
3. [Optional] Virtuelle Umgebung aktivieren: . venv/bin/activate

Hinweis: Verwenden Sie kein sudo mit den folgenden Befehlen, wenn Sie snare in einer virtuellen Umgebung ausführen.

4. Anforderungen installieren: sudo pip3 install -r requirements.txt
5. Snare einrichten: sudo python3 setup.py install
6. Eine Seite klonen: sudo clone --target http://example.com --path <Pfad zum Basisverzeichnis>
7. SNARE ausführen: sudo snare --port 8080 --page-dir example.com --path <Pfad zum Basisverzeichnis>
8. Testen: Besuchen Sie http://localhost:8080/index.html
9. (Optional) Lassen Sie Ihren eigenen tanner Dienst laufen.

[Hinweis: Der Cloner klont die gesamte Website. Um auf eine gewünschte Klon-Tiefe zu beschränken, fügen Sie --max-depth Parameter hinzu]

Docker-Build-Anweisungen

1. Wechseln Sie das aktuelle Verzeichnis zum snare Projektverzeichnis
2. docker-compose build
3. docker-compose up
4. Snare startet auf 0.0.0.0 mit Port 80. Weitere Informationen zur Ausführung von docker-compose finden Sie hier.

Falls beim Ausführen von docker-compose up ein Fehler auftritt, überprüfen Sie die Verfügbarkeit von Port 80. Wenn dieser belegt ist, lesen Sie die Docker-Dokumentation, um den Standardport zu ändern.

Sie sollten im Produktionseinsatz offensichtlich an 0.0.0.0 und Port 80 binden.

Tests

Um die Tests auszuführen und einen Testabdeckungsbericht zu erhalten, empfehlen wir die Ausführung von pytest:

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

Beispielausgabe

    # 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