Go to file
hankdamonlee b88ed7ced2
update docs/使用文档.md.
Signed-off-by: hankdamonlee <zy2039109@buaa.edu.cn>
2023-03-08 15:57:13 +00:00
data 添加一个poc;解决错误输出获取问题 2023-03-08 17:09:06 +08:00
docs update docs/使用文档.md. 2023-03-08 15:57:13 +00:00
exp_dir 编写genmai使用文档 2023-03-06 17:27:36 +08:00
image 增加漏洞报告展示图片 2022-12-21 06:03:53 +08:00
src 添加一个poc;解决错误输出获取问题 2023-03-08 17:09:06 +08:00
z-container 修改fastscan版本匹配算法 2023-03-08 10:38:41 +08:00
.gitignore 完成简单的漏洞报告功能 2022-12-07 15:17:34 +08:00
LICENSE 完成简单的漏洞报告功能 2022-12-07 15:17:34 +08:00
Makefile 完成简单的漏洞报告功能 2022-12-07 15:17:34 +08:00
README.md 增加漏洞报告展示图片 2022-12-21 05:51:18 +08:00

README.md

genmai

介绍

genmai是一款开源主机漏洞扫描网络漏洞扫描以及基线扫描功能的安全扫描框架。

genmai框架原理是通过先创建sandbox将要检测的漏洞POC/EXP在sandbox上通过Yaml解析器以及Json解析器将对应文件解析接着在存入缓存中在通过远程评估和本地评估的形式进行检测并生成分析报告。 大致内如可参考下图:

名字

genmai这个名字来源于中国医术中的术语——“诊脉”音标为“[dʒen'maɪ]”。脉诊是以手指按切病人动脉以了解病情的内在变化也称切脉。

软件架构

amd64

目录说明

* data : 一些数据文件的目录
* docs : 文档目录,包括设计文档,说明文档
* examples : 使用示例目录
* image : 存放图片
* misc : 其他
* utils : 实用程序/脚本目录
* tools: 辅助工具
* z-container : 临时存放目录
* z-testsuit : 存放测试小程序的目录
* z-trash : 垃圾桶目录

框架优势

  1. 拥有UI界面便于操作使用。
  2. 使用sandbox在sandbox上进行系统/内核漏洞检测避免了一些具有破坏性的系统或内核的POC/EXP对实体主机进行破坏。
  3. 创建协程池与请求池通过协程调度同步进行POC/EXP请求、检测和认证加快了漏洞认证的效率。
  4. 对与内核与系统模块使用了PWN模块进行检测使得检测更加准确。
  5. 拥有远程评估功能,多台主机同时进行检测。
  6. 能够生成方便的安全报告,便于人工进行审核。

功能模块

功能模块主要分为6个大部分

  1. 漏洞检测: 漏洞检测主要是通过检测系统以及内核方面的漏洞大致以一些公开的CVE/CNVD以及公开的内部挖局的KVE作为工具检测poc/expweb漏洞方面主要是检测无需登录的RCE、弱密码(SSH,MYSQL,FTP等)、未授权等漏洞。
  2. FUZZ测试 FUZZ测试主要对内核以及服务接口等进行FUZZ测试。
  3. 安全基线检测: 基线的安全检测通过检测可疑进程、可疑文件、可疑日志、OS配置、网络配置以及应用配置等。
  4. 评估: 分为本地检测与远程检测本地检测主要是通过SSH以及SCP进行对主机的远程检测
  5. 补丁信息: 为使用者提供修复建议,以及补丁的信息。
  6. 工具更新 用户可以直接使用update获取最新版本的工具。

开发规划

  1. 完成主体框架的开发主要包括sandboxrequestpoolcoprogrampoolcachejsonparseryamlparserinterpreterremotecheck
  2. 第一阶段先完成kernel模块的开发使工具内够检测内核的漏洞。
  3. 第二阶段完成安全基线检测的开发,能够使用基线扫描。
  4. 第三阶段完成system模块开发能够检测系统漏洞。
  5. 第四阶段完成web漏洞模块开发能检测web方面漏洞
  6. 第五阶段自动更新功能开发
  7. 第六阶段UI界面开发
  8. 第七阶段补丁信息功能导入
  9. 第八阶段FUZZ功能开发完成FUZZ检测

编译说明

# make
or
# make build

清理工程

# make clean
or
# make realclean

参与贡献

  1. Fork 本仓库
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request