Skip to content

Latest commit

 

History

History
106 lines (78 loc) · 3.41 KB

README.md

File metadata and controls

106 lines (78 loc) · 3.41 KB

Saucerframe

PyPI version License

saucerframe是一个基于python3的开源批量POC检测框架,默认使用协程异步请求,支持多线程并发,支持多种指定目标方式,可用于批量POC检测,也可根据需要扩展功能。欢迎star和pr

本项目用来交流学习,切勿用来做违法之事

特点

  • 支持多线程并发/协程
  • 指定目标支持多种方式
    • 指定单个目标
    • 从文本种获取目标
    • 某一网段获取目标 e.g. 192.168.1.0/24
    • 某一ip段获取目标 192.168.1.0-192.168.2.33
    • 支持多种api批量获取目标: ShodanZoomeyeFofaCensys
  • 支持全局代理(socks5|socks4|http)

更新历史

点击查看/关闭
  • 2019-11-25 重写进度条。

  • 2019-08-10 增加输出等级,增加模块加载方式,支持同时指定多个poc和多种target加载方式。

  • 2019-07-25 封装requests模块,新增全局代理选项,默认随机UA,重写censys api模块。

  • 2019-07-14 增加进度条;去除并发数的限制;去除google api;优化了一些模块。

  • 2019-05-09 增加logging模块,支持输出等级;增加censys api调用;IPY替换为内置库ipaddress、imp更新为importlib模块;规范大部分函数、变量命名;修改了程序逻辑。

  • 2019-05-08 增加plugin目录,逐步添加plugin,方便poc调用。目前已添加随机user-agent

  • 2019-04-18 更改默认并发方式为协程,自动根据扫描数量确定异步请求数量,优化了部分代码逻辑,速度提升

  • 2019-02-26 增加协程模式,利用gevent模块实现异步请求。

  • 2018-12-15 将第三方库colorama、IPy放进thirdlib中直接引用,减少依赖包的安装。

  • 2018-12-10 测试框架编写完成

使用

安装方法:

git clone https://github.com/saucer-man/saucerframe.git 
cd saucerframe
pip install -r requirement.txt 

使用方法:

python3 saucerframe.py -h
python3 saucerframe.py --show
python3 saucerframe.py -s script-name -iU target-url 

具体的参数说明:

# 1. 指定poc脚本(必需,支持同时指定多个poc)
-s redis_unauth,mongodb_unauth

# 2. 指定目标(必需)
-iU www.xxx.com  单个目标
-iF target.txt  从文本中加载
-iR 192.168.1.1-192.168.2.100  根据ip地址范围加载
-iN 192.168.1.0/24  根据网段加载
-aZ "redis"  ZoomEye api加载
-aS "redis"  Shodan api加载
-aC "redis"  Censys api加载
-aF "redis"  Fofa api加载

# 3. 其他(可选)
-h  查看帮助信息
-t 300  并发数(默认100)
--proxy socks5://127.0.0.1:1080  使用sock5代理
-o result.txt  指定输出文件
-v 4 指定终端输出详细级别(1-5, 默认为2)
--show  查看所有poc
-eT  并发采用多线程方式
-eG  并发采用协程方式(默认)

POC编写

介绍已移至wiki

感谢

框架起初设计过程中借鉴了POC-Tsqlmap等优秀开源项目的部分模式和代码,特此说明和感谢。