Skip to content

Latest commit

 

History

History
111 lines (78 loc) · 7.82 KB

HaE.md

File metadata and controls

111 lines (78 loc) · 7.82 KB

Language Author GitHub stars Version Time

项目介绍

HaE是一个基于BurpSuite Java插件API开发的辅助型框架式插件,旨在实现对HTTP消息的高亮标记和信息提取。该插件通过自定义正则表达式匹配响应报文或请求报文,并对匹配成功的报文进行标记和提取。

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

: 要想灵活的使用HaE,你需要掌握正则表达式阅读、编写、修改能力;由于Java正则表达式的库并没有Python的优雅或方便,所以HaE要求使用者必须用()将所需提取的表达式内容包含;例如你要匹配一个Shiro应用的响应报文,正常匹配规则为rememberMe=delete,如果你要提取这段内容的话就需要变成(rememberMe=delete)

使用方法

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

初次装载HaE会自动获取官方规则库https://raw.githubusercontent.com/gh0stkey/HaE/gh-pages/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. 精细配置:高度自由的配置选项,以满足各类精细化场景需求。
  2. 分类标签:使用标签对规则进行分类,便于管理和组织规则。
  3. 高亮标记:在HTTP History页面,通过颜色高亮和注释判断请求的价值。
  4. 易读配置:使用易读的YAML格式存储配置文件,方便阅读和修改。
  5. 数据集合:将匹配到的数据、请求和响应集中在数据面板中,提高测试和梳理效率。
  6. 简洁可视:清晰可视的界面设计,更轻松地了解和配置HaE,操作简单、使用便捷。
  7. 颜色升级:内置颜色升级算法,避免“屠龙者终成恶龙”场景,突出最具价值的请求。
  8. 实战规则:官方规则库是基于实战化场景总结输出,提升数据发现的有效性、精准性。
界面名称 界面展示
Rules(规则信息管理)
Config(配置信息管理)
Databoard(数据集合面板)

项目相关

最近更新

[v2.6.0] - 2024-02-02

更新

  • 支持双正则匹配,第一次正则(F-Regex)匹配结果可以通过第二次正则(S-Regex)进行二次匹配
  • 支持格式化输出,在NFA引擎的正则表达式中,我们可以通过{0}、{1}、{2}…的方式进行取分组格式化输出
  • DFA引擎支持大小写敏感配置项(即Sensitive可为Flase/True),有效减少正则长度

修复

  • 修复Databoard面板展示UI的布局大小失效BUG

[v2.5.11] - 2024-01-18

更新

  • 调整Databoard的UI占比布局,使其自适应大小
  • 修复MarkInfo及Databoard中数据表单的搜索输入框卡顿BUG

[v2.5.10] - 2023-12-12

更新

  • 去除MarkInfo及Databoard数据展示表单分页展示数据功能,功能冗余不再需要
  • 优化MarkInfo及Databoard数据展示表单正向与反向搜索功能,支持正则模式

[v2.5.9] - 2023-11-28

BUG修复

  • 修复Databoard下拉框长时间使用消失问题
  • 修复消息报文数据高亮、标注信息不完整问题
  • 修复Databoard双击数据对应展示消息报文缺失问题
  • 修复Config保存排除后缀名,文件错误保存问题
  • 修复正则规则错误导致规则失效问题,并在插件输出中提供报错信息
  • 修复空报文数据匹配错误问题,避免与其他插件(如:APIKit)冲突

UI更新

  • 修改HaE展示Logo逻辑,使界面不再突兀

[v2.5.8] - 2023-11-16

更新

  • 修复Databoard输入框卡顿问题
  • 修复Databoard消息内容表单数据展示不完全问题