SNARE

Super Next generation Advanced Reactive honEypot

Описание

SNARE — это хонейпот-сенсор для веб-приложений, привлекающий всевозможные вредоносные действия из Интернета.

Документация

Документацию можно найти здесь.

Основные концепции

• Поверхность прежде всего. Основное внимание уделяется генерации поверхности атаки.
• Сенсоры и мастера. Легковесные сборщики (SNARE) и центральный принимающий решения (tanner).

Начало работы

• Для запуска SNARE требуется Python3.6
• Тестировалось на свежей версии Ubuntu-based Linux.

Шаги по установке

1. Получить SNARE: git clone https://github.com/mushorg/snare.git и cd snare
2. [Опционально] Создать виртуальное окружение: python3 -m venv venv
3. [Опционально] Активировать виртуальное окружение: . venv/bin/activate

Примечание: Не используйте sudo с командами ниже, если вы запускаете snare в виртуальном окружении.

4. Установить зависимости: sudo pip3 install -r requirements.txt
5. Настроить snare: sudo python3 setup.py install
6. Клонировать страницу: sudo clone --target http://example.com --path <путь к базовой директории>
7. Запустить SNARE: sudo snare --port 8080 --page-dir example.com --path <путь к базовой директории>
8. Тест: Перейдите по адресу http://localhost:8080/index.html
9. (Опционально) Запустите свой собственный tanner.

[Примечание: Клонер клонирует весь сайт. Чтобы ограничить глубину клонирования, добавьте параметр --max-depth]

Инструкции по сборке Docker

1. Перейти в каталог проекта snare
2. docker-compose build
3. docker-compose up
4. Snare запустится на 0.0.0.0 с портом 80. Больше информации о запуске docker-compose можно найти здесь.

В случае ошибки при запуске docker-compose up проверьте доступность порта 80. Если он занят, обратитесь к документации Docker, чтобы изменить порт по умолчанию.

Очевидно, вы хотите привязаться к 0.0.0.0 и порту 80 при работе в продакшене.

Тестирование

Для запуска тестов и получения отчета о покрытии кода мы рекомендуем запустить pytest:

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

Пример вывода

    # 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