yarAnalyzer 项目使用教程

yarAnalyzer 项目使用教程

yarAnalyzerYara Rule Analyzer and Statistics项目地址:https://gitcode.com/gh_mirrors/ya/yarAnalyzer

1. 项目的目录结构及介绍

yarAnalyzer/
├── signatures/
│   └── (Yara规则文件，扩展名为.yar)
├── yarAnalyzer.py
├── README.md
├── LICENSE
├── requirements.txt
└── (其他辅助文件)

• signatures/: 存放Yara规则文件的目录，文件扩展名为.yar。
• yarAnalyzer.py: 项目的启动文件，负责分析Yara规则和样本文件。
• README.md: 项目的基本介绍和使用说明。
• LICENSE: 项目的开源许可证，本项目使用MIT许可证。
• requirements.txt: 项目依赖的Python库列表。

2. 项目的启动文件介绍

yarAnalyzer.py 是项目的启动文件，主要功能是分析Yara规则和样本文件，生成统计信息和CSV文件。

主要功能

• 分析指定目录下的样本文件。
• 根据signatures/目录下的Yara规则文件进行匹配。
• 生成文件和规则的统计信息，并输出为CSV文件。

使用示例

python yarAnalyzer.py -p /sample/path -s /signatures

3. 项目的配置文件介绍

项目没有明确的配置文件，但可以通过命令行参数进行配置。以下是一些常用的命令行参数：

• -p path: 指定要扫描的样本文件路径。
• -s sigpath: 指定Yara规则文件的路径。
• -e ext: 指定规则文件的扩展名（默认为.yar）。
• -i identifier: 设置标识符，用于生成CSV文件名。
• -m max-size: 设置最大文件大小（MB）。
• -l max-string: 设置文件名/规则名的最大字符长度。
• -f first-bytes: 设置输出中显示的前几个字节数。
• -o output: 设置输出文件名。
• --excel: 添加额外内容以避免在Microsoft Excel中自动转换。
• --noempty: 不显示空值。
• --inventory: 仅创建Yara规则清单。
• --printAll: 打印所有扫描的文件。
• --debug: 输出调试信息。

示例配置

python yarAnalyzer.py -p /sample/path -s /signatures -m 20 -l 50 -f 10 -o my_output --excel --noempty

以上命令将扫描/sample/path目录下的文件，使用/signatures目录中的Yara规则进行匹配，并生成名为my_output的CSV文件，同时避免在Excel中自动转换，不显示空值。

yarAnalyzerYara Rule Analyzer and Statistics项目地址:https://gitcode.com/gh_mirrors/ya/yarAnalyzer