SNARE

Super Next generation Advanced Reactive honEypot

Sobre

SNARE é um sensor honeypot de aplicações web que atrai todo o tipo de maliciosidade da Internet.

Documentação

A documentação pode ser encontrada aqui.

Conceitos Básicos

• Superfície primeiro. Foco na geração da superfície de ataque.
• Sensores e mestres. Coletores leves (SNARE) e tomador de decisão central (tanner).

Começando

• Você precisa de Python3.6 para executar o SNARE
• Isso foi testado com um Ubuntu baseado em Linux recente.

Passos para configurar

1. Obter SNARE: git clone https://github.com/mushorg/snare.git e cd snare
2. [Opcional] Criar ambiente virtual: python3 -m venv venv
3. [Opcional] Ativar ambiente virtual: . venv/bin/activate

Nota: Não use sudo com os comandos abaixo se estiver executando o snare no ambiente virtual.

4. Instalar requisitos: sudo pip3 install -r requirements.txt
5. Configurar snare: sudo python3 setup.py install
6. Clonar uma página: sudo clone --target http://example.com --path <caminho para o diretório base>
7. Executar SNARE: sudo snare --port 8080 --page-dir example.com --path <caminho para o diretório base>
8. Teste: Visite http://localhost:8080/index.html
9. (Opcionalmente) Tenha seu próprio serviço tanner em execução.

[Nota: O clonador clona o site inteiro, para restringir a uma profundidade desejada de clonagem adicione o parâmetro --max-depth]

Instruções de construção com Docker

1. Mude o diretório atual para o diretório do projeto snare
2. docker-compose build
3. docker-compose up
4. O Snare iniciará em 0.0.0.0 na porta 80. Mais informações sobre como executar o docker-compose podem ser encontradas aqui.

Em caso de erro ao executar docker-compose up, verifique a disponibilidade da porta 80, se estiver ocupada, consulte a documentação do Docker para alterar a porta padrão.

Você obviamente deseja vincular a 0.0.0.0 e porta 80 ao executar em produção.

Testes

Para executar os testes e obter um relatório de cobertura de testes, recomendamos executar o pytest:

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

Exemplo de Saída

    # 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