HeySerial 开源项目使用教程

1. 项目目录结构及介绍

HeySerial 项目目录结构如下：

.
├── payloads
├── pcaps
├── rules
├── utils
├── .gitignore
├── DEVELOPERS.md
├── LICENSE.txt
├── README.md
├── REQUIREMENTS
├── Shmoocon2022_CleanUpOnTheSerialAisle_AlyssaRahman.pdf
├── heyserial.py
└── ysoserial.net_LICENSE.txt

• payloads: 存储用于测试的有效载荷（payloads）。
• pcaps: 存储网络捕获文件（pcaps），用于分析网络通信。
• rules: 存储生成的狩猎规则，包括Snort和Yara规则。
• utils: 包含辅助工具脚本，例如用于测试规则的checkyoself.py和用于生成有效载荷的generate_payloads.ps1（Windows）和generate_payloads.sh（Linux）。
• .gitignore: 指定Git应忽略的文件和目录。
• DEVELOPERS.md: 开发者指南，包含有关如何扩展HeySerial的信息。
• LICENSE.txt: 项目的Apache-2.0和MIT许可证文件。
• README.md: 项目的自述文件，包含项目描述、用法和贡献指南。
• REQUIREMENTS: 项目的依赖和安装要求。
• Shmoocon2022_CleanUpOnTheSerialAisle_AlyssaRahman.pdf: 与项目相关的会议演讲稿。
• heyserial.py: 项目的主要Python脚本文件，用于生成狩猎规则。
• ysoserial.net_LICENSE.txt: YSoSerial.NET项目的许可证文件。

2. 项目的启动文件介绍

项目的启动文件是heyserial.py。这是执行项目功能的主要Python脚本。使用以下方式运行：

python3 heyserial.py [选项]

运行python3 heyserial.py -h可以查看所有可用的选项和参数。

3. 项目的配置文件介绍

HeySerial 项目中的配置主要通过命令行参数进行，而不是通过独立的配置文件。以下是一些常用的命令行参数示例：

• -c 'ExampleChain::condition1+condition2': 指定要生成的规则的条件链。
• -t JavaObj: 指定对象类型，这里是Java对象。
• -k cmd.exe whoami 'This file cannot be run in DOS mode': 指定关键词，用于搜索特定的命令或字符串。
• -e base64 "base64+utf16le": 指定编码类型，这里是Base64编码。

具体的配置选项和参数在使用时可以参考命令行帮助文档或README.md中的详细说明。