/webzmap

Zmap on Web

Primary LanguagePython

WebZmap

WebZmap 是一个通过web方式管理运行zmap扫描任务， 并提供 RESTful API 方便第三方程序调用控制zmap任务

目前该项目还在开发中,很多功能待完善, 由于个人时间精力有限, 开发进度有点慢, 有兴趣的朋友可以fork, 并给我PR

Goal

  1. 通过Web管理zmap任务(70%)
  2. 通过RESTful API为第三方程序提供接口(60%)
  3. 分布式扫描(0%)

Dependency

  1. zmap
  2. Python 2.7
  3. django 1.10
  4. requests 2.9.1
  5. djangorestframework 3.4.4

Install

  1. 安装 zmap, 安装方式请查看zmap官方文档

  2. 克隆项目

    git clone https://github.com/fengyouchao/webzmap

  3. 安装依赖

    cd webzmap
sudo -H pip install -r requirments.txt

  4. 初始化

    python manage.py migrate #创建数据库
python manage.py createsuperuser #创建系统用户
sudo python manage.py zmapd start #启动用于执行zmap任务的zmapd服务，必须以root权限执行

  5. 确认zmap执行路径

    where zmap

    WebZmap 默认的zmap执行路径为 /usr/local/sbin/zmap 如果 where zmap 的路径不是该值, 编辑 webzmap/settings.py, 在文件最后添加以下内容:

    ZMAP_PATH = 'your zmap bin path'

  6. 运行

    python manage.py runserver #请勿在生产环境使用此方式运行

    访问 http://localhost:8000

Deploy

如果要在生产环境中部署webzmap, 可以通过以下步骤完成:

  1. 编辑webzmap/settings.py在文件最后添加以下内容

    DEBUG = False
ALLOWED_HOSTS = ['*'] # 设置允许访问该站点的host, * 表示任意host, 如果您希望只能通过域名访问,在这里设置域名

  2. 查看Deploying Django

FAQ

  1. 提交任务后任务一直处于Pending状态

    请检查是否启动了zmapd服务

    sudo python manage.py zmapd status

    启动zmapd

    sudo python manage.py zmapd start

  2. 执行日志显示[FATAL] csv: could not open output file (xxx/webzmap/workspace/xxx/status.txt)

    目前测试发现，这应该是zmap的一个bug，测试版本号为2.1.1, 在指定-u参数时，有一定概率发生此问题，目前解决办法为重新创建任务。