Skip to content

Latest commit

 

History

History
125 lines (86 loc) · 8.44 KB

HaE.md

File metadata and controls

125 lines (86 loc) · 8.44 KB

Language Author GitHub stars Version Time

项目介绍

HaE是一款网络安全(数据安全)领域下的框架式项目,采用了乐高积木式模块化设计理念,实现对HTTP消息(包含WebSocket)精细化的标记和提取。

通过运用多引擎的自定义正则表达式,HaE能够准确匹配并处理HTTP请求与响应报文(包含WebSocket),对匹配成功的内容进行有效的标记和信息抽取,从而提升网络安全(数据安全)领域下的漏洞和数据分析效率

随着现代化Web应用采用前后端分离的开发模式,日常漏洞挖掘的过程中,捕获的HTTP请求流量也相应增加。若想全面评估一个Web应用,会花费大量时间在无用的报文上。HaE的出现旨在解决这类情况,借助HaE,您能够有效减少测试时间,将更多精力集中在有价值且有意义的报文上,从而提高漏洞挖掘效率

GitHub项目地址:https://github.com/gh0stkey/HaE

GitCode项目地址:https://gitcode.com/gh0stkey/HaE

所获荣誉:

  1. 入选2022年KCon兵器谱
  2. 入选GitCode G-Star项目

注意事项:

  1. HaE 3.0版本开始采用Montoya API进行开发,使用新版HaE需要升级你的BurpSuite版本(>=2023.12.1)。
  2. HaE 2.6版本后对规则字段进行了更新,因此无法适配<=2.6版本的规则,请用户自行前往规则转换页面进行转换。
  3. 自定义HaE规则必须用左右括号()将所需提取的表达式内容包含,例如你要匹配一个Shiro应用的响应报文,正常匹配规则为rememberMe=delete,在HaE的规则中就需要变成(rememberMe=delete)

使用方法

插件装载: Extender - Extensions - Add - Select File - Next

初次装载HaE会从Jar包中加载离线的规则库,如果更新可以点击Reinit进行重新初始化。内置规则库地址可以在Github上找到:https://github.com/gh0stkey/HaE/blob/master/src/main/resources/rules/Rules.yml

配置文件(Config.yml)和规则文件(Rules.yml)会放在固定目录下:

  1. Linux/Mac用户的配置文件目录:~/.config/HaE/
  2. Windows用户的配置文件目录:%USERPROFILE%/.config/HaE/

除此之外,您也可以选择将配置文件存放在HaE Jar包的同级目录下的/.config/HaE/中,以便于离线携带

规则释义

HaE目前的规则一共有8个字段,详细的含义如下所示:

字段 含义
Name 规则名称,主要用于简短概括当前规则的作用。
F-Regex 规则正则,主要用于填写正则表达式。在HaE中所需提取匹配的内容需要用()将正则表达式进行包裹。
S-Regex 规则正则,作用及使用同F-Regex。S-Regex为二次正则,可以用于对F-Regex匹配的数据结果进行二次的匹配提取,如不需要的情况下可以留空。
Format 格式化输出,在NFA引擎的正则表达式中,我们可以通过{0}{1}{2}…的方式进行取分组格式化输出。默认情况下使用{0}即可。
Scope 规则作用域,主要用于表示当前规则作用于HTTP报文的哪个部分。支持请求、响应的行、头、体,以及完整的报文。
Engine 正则引擎,主要用于表示当前规则的正则表达式所使用的引擎。DFA引擎:对于文本串里的每一个字符只需扫描一次,速度快、特性少;NFA引擎:要翻来覆去标注字符、取消标注字符,速度慢,但是特性(如:分组、替换、分割)丰富。
Color 规则匹配颜色,主要用于表示当前规则匹配到对应HTTP报文时所需标记的高亮颜色。在HaE中具备颜色升级算法,当出现相同颜色时会自动向上升级一个颜色进行标记。
Sensitive 规则敏感性,主要用于表示当前规则对于大小写字母是否敏感,敏感(True)则严格按照大小写要求匹配,不敏感(False)则反之。

优势特点

  1. 功能:通过对HTTP报文的颜色高亮、注释和提取,帮助使用者获取有意义的信息,聚焦高价值报文
  2. 界面:清晰可视的界面设计,以及简洁的界面交互,帮助使用者更轻松的了解和配置项目,避免多按钮式的复杂体验
  3. 查询:将HTTP报文的高亮、注释和提取到的相关信息集中在一个数据面板,可以一键查询、提取信息,从而提高测试和梳理效率。
  4. 算法:内置高亮颜色的升级算法,当出现相同颜色时会自动向上升级一个颜色进行标记,避免屠龙者终成恶龙场景
  5. 管理融入BurpSuite的项目数据管理,当使用BurpSuite进行项目存储时HaE数据也会一并存储。
  6. 实战:官方规则库和规则字段作用功能,都是基于实战化场景总结输出的,以此提高数据的有效性、精准性发现
界面名称 界面展示
Rules(规则管理)
Config(配置管理)
Databoard(数据集合)
MarkInfo(数据展示)

项目相关

最近更新

[v4.0.3] - 2025-01-10

问题修复

  • 修复Databoard数据搜索实效问题,采用正则加字符双匹配结果
  • 修复MarkInfo数据双击编辑失焦问题

[v4.0.2] - 2025-01-08

功能更新

  • 优化HTTP消息存储逻辑
  • 优化HaE数据存储逻辑

问题修复

  • 修复BurpSuite社区版下无法使用HaE的问题

[v4.0.1] - 2024-12-31

功能更新

  • 优化Linkfinder规则,支持非/开头的路径匹配

问题修复

  • 修复项目管理功能中多线程数据冲突问题

[v4.0] - 2024-12-21

功能更新

  • 删除AI+实验性功能
  • 删除在线规则库功能,未来以内置规则库的方式持续运营
  • 优化数据管理功能,可与BurpSuite项目一并存储管理
  • 新增、优化若干规则,如手机号、用户名、密码等字段规
  • 新增Reinit功能,用于重新初始化内置规则库

[v3.4] - 2024-11-16

功能更新

  • 优化HaE官方规则库规则
  • 优化UI显示界面和布局,对用户可视化操作更友好
  • 新增Mode开关,开启则支持高亮和备注,关闭则提高性能

问题修复

  • 修复汉化补丁下搜索功能失效问题