SNARE

Super Next generation Advanced Reactive honEypot

Informazioni

SNARE è un sensore honeypot per applicazioni web che attira ogni tipo di malintenzionato da Internet.

Documentazione

La documentazione si trova qui.

Concetti di base

• Prima la superficie. Concentrati sulla generazione della superficie di attacco.
• Sensori e master. Collettori leggeri (SNARE) e decisore centrale (tanner).

Per iniziare

• Hai bisogno di Python 3.6 per eseguire SNARE
• È stato testato con un recente Linux basato su Ubuntu.

Passaggi per la configurazione

1. Ottieni SNARE: git clone https://github.com/mushorg/snare.git e cd snare
2. [Opzionale] Crea un ambiente virtuale: python3 -m venv venv
3. [Opzionale] Attiva l'ambiente virtuale: . venv/bin/activate

Nota: Non usare sudo con i comandi seguenti se stai eseguendo snare in un ambiente virtuale.

4. Installa i requisiti: sudo pip3 install -r requirements.txt
5. Configura snare: sudo python3 setup.py install
6. Clona una pagina: sudo clone --target http://example.com --path <percorso della directory di base>
7. Esegui SNARE: sudo snare --port 8080 --page-dir example.com --path <percorso della directory di base>
8. Prova: Visita http://localhost:8080/index.html
9. (Opzionale) Fai funzionare il tuo servizio tanner.

[Nota: Cloner clona l'intero sito web, per limitare a una profondità di clonazione desiderata aggiungi il parametro --max-depth]

Istruzioni per la build Docker

1. Sposta la directory corrente nella directory del progetto snare
2. docker-compose build
3. docker-compose up
4. Snare si avvierà su 0.0.0.0 con porta 80. Maggiori informazioni sull'esecuzione di docker-compose si trovano qui.

In caso di errore durante l'esecuzione di docker-compose up, controlla la disponibilità della porta 80, se è occupata consulta la documentazione di Docker per cambiare la porta predefinita.

Ovviamente vuoi associare a 0.0.0.0 e porta 80 quando esegui in produzione.

Test

Per eseguire i test e ricevere un report di copertura dei test, consigliamo di eseguire pytest:

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

Esempio di output

    # 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