SNARE

超级下一代高级响应式蜜罐

关于

SNARE 是一个 Web 应用蜜罐传感器，可吸引来自互联网的各种恶意行为。

文档

文档可在此处找到。

基本概念

• 表面优先。专注于攻击面生成。
• 传感器与主控。轻量级收集器（SNARE）与中央决策器（tanner）。

开始使用

• 你需要 Python 3.6 来运行 SNARE
• 本工具已在最新的基于 Ubuntu 的 Linux 上测试通过。

设置步骤

1. 获取 SNARE：git clone https://github.com/mushorg/snare.git 并 cd snare
2. [可选] 创建虚拟环境：python3 -m venv venv
3. [可选] 激活虚拟环境：. venv/bin/activate

注意： 如果在虚拟环境中运行 snare，请不要对以下命令使用 sudo。

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