Hayabusa项目新增expand-list命令解析

背景介绍

Hayabusa是一款功能强大的Windows事件日志分析工具，近期开发团队计划为其添加一个新功能——expand-list命令。这个命令的设计初衷是为了帮助用户更好地理解需要创建的expand配置文件。

功能设计

expand-list命令的核心功能是扫描规则目录中的YAML文件，提取所有使用expand占位符的字段，并以清晰的方式展示给用户。基本命令格式如下：

hayabusa.exe expand-list <INPUT> [OPTIONS]

主要参数说明

• -r, --rules <DIR>：指定规则目录路径（默认为./rules）
• -h, --help：显示帮助菜单
• -K, --no-color：禁用彩色输出
• -q, --quiet：静默模式，不显示启动横幅

技术实现讨论

在实现过程中，开发团队对输出格式进行了深入讨论，提出了两种方案：

1. 简单列表方案：仅输出去重后的占位符列表

   5 unique expand placeholders found:
   
   Admins_Workstations
   DC-MACHINE-NAME
   Workstations
   internal_domains
   domain_controller_hostnames
   

2. 详细表格方案：提供更全面的信息展示

   +--------------------------------------+-------------------------------------------------------+-----------------------------+------------------------------------------+
   | ID                                   | Title                                                 | Expand                      | Filepath                                 |
   +--------------------------------------+-------------------------------------------------------+-----------------------------+------------------------------------------+
   | 550e8400-e29b-41d4-a716-446655440001 | User with Privileges Logon                            | Admins_Workstations         | ./config/Admins_Workstations.txt         |
   | 550e8400-e29b-41d4-a716-446655440002 | Potential Zerologon (CVE-2020-1472) Exploitation      | DC-MACHINE-NAME             | ./config/DC-MACHINE-NAME.txt             |
   | 550e8400-e29b-41d4-a716-446655440003 | Potential Pass the Hash Activity                      | Workstations                | ./config/Workstations.txt                |
   | 550e8400-e29b-41d4-a716-446655440004 | DNS Request From Windows Script Host                  | internal_domains            | ./config/internal_domains.txt            |
   | 550e8400-e29b-41d4-a716-446655440005 | New RDP Connection Initiated From Domain Controller   | domain_controller_hostnames | ./config/domain_controller_hostnames.txt |
   +--------------------------------------+-------------------------------------------------------+-----------------------------+------------------------------------------+
   

详细表格方案的优势在于：

• 显示规则ID和标题，方便用户理解每个占位符的用途
• 提供建议的文件路径，指导用户创建配置文件
• 表格形式更易于阅读和理解

扩展功能建议

开发团队还讨论了是否应该添加自动生成模板文件的功能。通过-o, --output <FILE>选项，命令可以自动创建占位符对应的空模板文件，这将进一步简化用户配置过程。

技术价值

expand-list命令的引入将显著提升Hayabusa的易用性：

1. 降低新用户的学习曲线
2. 减少配置错误
3. 提高规则配置效率
4. 增强工具的透明度和可维护性

这一功能的实现将进一步完善Hayabusa作为专业Windows事件日志分析工具的功能体系，为用户提供更加友好和高效的使用体验。