aur0ra-m / apikiller Goto Github PK

简介 • 架构 • Feature • 食用宝典 • 二次开发文档 • 更新 • 项目社区 • 致谢

一款高度可定制化的DAST&API Security平台

详细参考： 快看~项目精髓

• 支持HTTP/HTTPS流量检测
• 多来源检测
  • 支持流量监听
  • 支持历史流量回扫[目前只支持burpsuite存储流量]
• 支持测试流量区分、流量清洗
  • 允许通过hook，对所有测试请求进行添加标识header等方式，区分测试流量或者将测试流量导入到pre、boe等非生产环境中
• 多功能扫描模块
  • 越权检测模块，高效精准，支持多情景检测
  • 40x bypass 模块
  • CSRF检测模块
  • open-redirect 检测模块
  • DoS检测模块【谨慎配置，避免出现大量脏数据】
  • 【欢迎大家积极提PR】
• 多功能Filter处理，默认自带多个filter
  • 针对性扫描，例如只对 baidu.com域名进行扫描
  • 去重扫描，提高效率
  • 自动过滤静态文件(js,gif,jpg,png,css,jpeg,xml,img,svg...)
• API 运维
  • 提供简易的API Security运维平台
• 多方式漏洞发现提醒
  • Lark飞书
  • 钉钉
  • ...
• 对抗常见风控手段
  • 频控
• 【重磅】以上都可以快速进行二次开发

详细请查看：https://github.com/Aur0ra-m/APIKiller/wiki

1. 安装好数据库环境（我个人采用的是docker）

   1. 一键部署

      1. 将项目clone到服务器后，直接运行 sudo bash dbDeploy.sh

         

      2. 根据返回的数据，在config.yaml中完成相关配置

   2. 手动部署
      1. docker pull 数据库镜像

       sudo docker run --name mysql-server -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306  mysql

      2. 导入apikiller.sql文件

       sudo docker cp /tmp/apikiller.sql mysql-server:/tmp/apikiller.sql

      3. 登入mysql

       docker exec -it mysql-server mysql -uroot -p123456
       source /tmp/apikiller.sql

      4. 【重点】在 config.yaml 中进行相关配置

         

2. 安装根目录下的https证书[windows环境]

   1. 找到根目录下的ca.crt证书

      

   2. 点击安装即可，将其添加到系统根信任证书颁发位置

   3. 配置漏洞发现通知Webhook

      1. 根据飞书指导，开启一个bot，并复制相关的webhook【支持secret鉴权操作】

      2. 在根路径下的config.json中进行配置(如果有secret，就进行配置)

         

   4. 配置成功后，当发现漏洞时，会立即推送漏洞信息

      

3. 一键启动【配置文件位于./config/目录下(默认是config.release.yaml)，或自己指定】

   

4. ding~，发现新漏洞，快去看鸭

5. 漏洞运营，及时对漏洞进行研判和修复

   

基本配置：数据库模块、过滤器模块、通知模块

除基本配置外，还必须进行如下的模块配置。（其中的option必须配置为1，才代表启动该模块）

这里基于VAPI越权靶场 进行实战模拟 配好环境后，先根据项目鉴权机制，提供另一个不同权限的账号，配置好config.yaml

1. 根据企业开发规范，配置好越权模块的相关配置

   

2. 启动项目，访问接口
   
   

3. 成功检测出越权和csrf

   

当前可以进行大小写、path fuzz、api版本降级等方式，来进行探测

基于pikachu靶场，进行漏洞检测

处理csrf模块的配置

为避免扫描时造成过无效流量，可以通过提供的HTTP HOOK机制，对请求流量自定义修改，例如添加header，来区分测试流量和实际流量

【注意】当前由于golang plugin机制特性，暂不支持windows下的流量修改

1. HTTP HOOK 样例

   package main
   
   import (
       "fmt"
       "net/http"
   )
   
   type RequestHook interface {
       HookBefore(*http.Request) // hook before initiating http newReq
       HookAfter(*http.Request)  // hook after finishing http newReq
   }
   
   type AddHeaderHook struct {
   }
   
   func (a AddHeaderHook) HookBefore(newReq *http.Request) {
       fmt.Println("HOOK Before: hhhhhhh")
       // ....
   }
   
   func (a AddHeaderHook) HookAfter(newReq *http.Request) {
   
   }
   
   // Hook this is exported, and this name must be set Hook
   var Hook AddHeaderHook

【严格按照上面的代码规范，其中最后一行代码，命名必须设置为Hook】

2. 生成对应的so链接库

   go build -buildmode=plugin APIKillerHookSample.go

   $ ls
   APIKillerHookSample.go  APIKillerHookSample.so  go.mod

3. 将生成的so放置到项目的hooks目录下

   $ ls ./hooks
   APIKillerHookSample.so

4. 启动项目即可完成流量更改

https://github.com/Aur0ra-m/APIKiller/wiki

• 【功能】修正对https请求的处理
• 【功能】优化csrf检测模块
• 【功能】添加对钉钉通知的支持
• 【优化】对整体架构进行优化，提高效率（通知模块优化、数据库存储模块优化）
• 【优化】重改数据库设计，同时数据库存储时进行base64转码操作

• 【功能】新增40xbypass模块，支持常见架构层绕过和接口层绕过
• 【优化】优化权限检测模块，向甲方实际情况靠齐
• 【优化】调整配置解析，从json迁移至yaml，同时优化全局解析过程，提高检测效率
• 【优化】调整filter顺序，同时对duplicationFilter查询过程由数据库查询到成员变量查询
• 【bugFix】修复线程安全导致的数据重复等问题
• 【bugFix】调整全局的chance-recovery 机制为clone机制

• 【功能】添加HTTP HOOK功能，可满足区分测试产生的http脏数据、流量清洗功能。HOOK食用方式
• 【功能】新增开放重定向检测模块，支持对常见的GET Query方式进行测试
• 【功能】新增DoS安全测试模块，目前可以对查询资源大小未控制导致的DoS进行检测，例如size设置为超大数
• 【优化】针对之前试用时产生的各种不适进行了一个优化

• 【发布】项目wiki以及二次开发文档第一版发布
• 【发布】发布项目Release 1.0.0
• 【优化】多处增添多线程操作，再次优化整体性能
• 【功能】增添可指定配置文件操作
• 【优化】提供数据库一键部署方案
• 【优化】调整部分结构，修复部分bug

• 【优化】web运营平台启动优化，当本地启动时，会自动打开浏览器访问运营平台
• 【优化】删去origin中不需要的参数，优化meta结构

• 【重构】调整项目目录和框架，向标准化靠齐
• 【功能】配置加载进行多套方案，允许在开发和正式部署阶段采用不同的配置文件，或加载时指定配置文件
• 【优化】对日志打印及保存进行优化，将日志按日期记录在./log目录下
• 【优化】对项目早期的代码进行标准化处理，删除无效代码或测试代码，确保高质量程序代码

• 【功能】越权检测模块新增对不同站点进行不同的替换能力，且支持query、header、post body多点替换

• 【优化】调整了开发环境和部署环境的判定逻辑
• 【bugFix】修复前端中文乱码
• 【bugfix】修复mysql的版本问题，直接拉取最新版，避免拉取不到指定版本的docker镜像

如想对项目进行深入了解，或加入研发团队欢迎加入APIKiller项目社区。
群二维码失效可加我微信，备注：私聊回复APIKiller 实时进群

【最后感谢项目中所使用到的各种开源组件的作者】