SNARE

Super pot de miel réactif avancé de nouvelle génération

À propos

SNARE est un capteur honeypot d'application web attirant toutes sortes de malveillances depuis Internet.

Documentation

La documentation peut être trouvée ici.

Concepts de base

• Surface d'abord. Concentrez-vous sur la génération de la surface d'attaque.
• Capteurs et maîtres. Collecteurs légers (SNARE) et centre de décision (tanner).

Pour commencer

• Vous avez besoin de Python3.6 pour exécuter SNARE
• Cela a été testé avec un Linux récent basé sur Ubuntu.

Étapes de configuration

1. Obtenez SNARE : git clone https://github.com/mushorg/snare.git et cd snare
2. [Optionnel] Créez un environnement virtuel : python3 -m venv venv
3. [Optionnel] Activez l'environnement virtuel : . venv/bin/activate

Remarque : N'utilisez pas sudo avec les commandes ci-dessous si vous exécutez snare dans un environnement virtuel.

4. Installez les dépendances : sudo pip3 install -r requirements.txt
5. Configurez snare : sudo python3 setup.py install
6. Clonez une page : sudo clone --target http://example.com --path <path to base dir>
7. Exécutez SNARE : sudo snare --port 8080 --page-dir example.com --path <path to base dir>
8. Test : Visitez http://localhost:8080/index.html
9. (Optionnellement) Ayez votre propre service tanner en cours d'exécution.

[Remarque : Le clonage clone l'ensemble du site web, pour restreindre à une profondeur de clonage souhaitée ajoutez le paramètre --max-depth]

Instructions de construction Docker

1. Changez le répertoire courant vers le répertoire du projet snare
2. docker-compose build
3. docker-compose up
4. Snare démarrera sur 0.0.0.0 avec le port 80. Plus d'informations sur l'exécution de docker-compose peuvent être trouvées ici.

En cas d'erreur lors de l'exécution de docker-compose up, vérifiez la disponibilité du port 80, s'il est occupé, référez-vous à la documentation Docker pour changer le port par défaut.

Vous voulez évidemment lier à 0.0.0.0 et au port 80 lors de l'exécution en production.

Test

Afin d'exécuter les tests et d'obtenir un rapport de couverture de test, nous recommandons d'exécuter pytest :

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

Exemple de sortie

    # 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