SNARE

Super Nueva generación Avanzado Reactivo honEypot

Acerca de

SNARE es un sensor honeypot de aplicaciones web que atrae todo tipo de maliciosidad de Internet.

Documentación

La documentación se puede encontrar aquí.

Conceptos básicos

• Superficie primero. Centrarse en la generación de la superficie de ataque.
• Sensores y maestros. Colectores ligeros (SNARE) y tomador de decisiones central (tanner).

Primeros pasos

• Necesitas Python3.6 para ejecutar SNARE
• Esto fue probado con un Linux reciente basado en Ubuntu.

Pasos para la configuración

1. Obtén SNARE: git clone https://github.com/mushorg/snare.git y cd snare
2. [Opcional] Crear un entorno virtual: python3 -m venv venv
3. [Opcional] Activar el entorno virtual: . venv/bin/activate

Nota: No uses sudo con los siguientes comandos si estás ejecutando snare en un entorno virtual.

4. Instalar dependencias: sudo pip3 install -r requirements.txt
5. Configurar snare: sudo python3 setup.py install
6. Clonar una página: sudo clone --target http://example.com --path <path to base dir>
7. Ejecutar SNARE: sudo snare --port 8080 --page-dir example.com --path <path to base dir>
8. Prueba: Visita http://localhost:8080/index.html
9. (Opcionalmente) Ten tu propio servicio tanner funcionando.

[Nota: El clonador clona todo el sitio web, para restringir a una profundidad deseada de clonación añade --max-depth]

Instrucciones de compilación con Docker

1. Cambia el directorio actual al directorio del proyecto snare
2. docker-compose build
3. docker-compose up
4. Snare se iniciará en 0.0.0.0 con el puerto 80. Puedes encontrar más información sobre cómo ejecutar docker-compose aquí.

En caso de error al ejecutar docker-compose up, verifica la disponibilidad del puerto 80; si está ocupado, consulta la documentación de Docker para cambiar el puerto predeterminado.

Obviamente deseas enlazar a 0.0.0.0 y puerto 80 cuando ejecutes en producción.

Pruebas

Para ejecutar las pruebas y recibir un informe de cobertura, recomendamos ejecutar pytest:

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

Ejemplo de salida

    # 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