deeps-blip/FTI

GitHub: deeps-blip/FTI

基于 radare2 和 Python 的模块化静态恶意软件分析框架,可在容器化环境中提取二进制文件的结构化情报特征。

Stars: 0 | Forks: 0

# 联邦威胁情报 (FTI) 联邦威胁情报 (FTI) 是一个使用 **Python** 和 **radare2** 构建的 **模块化静态恶意软件分析框架**。 它专注于在可复现的本地或容器化环境中进行 **可靠的函数发现、元数据提取和结构化报告生成**。 FTI 被设计为 **协作与联邦威胁情报研究的基础**,优先考虑稳定性、确定性和清晰的架构,而非激进或推测性的分析。 ## 核心目标 - 为恶意软件样本提供 **稳定的静态分析流水线** - 提取适用于下游情报任务的 **可验证特征** - 确保本地和 Docker 执行之间的 **确定性表现** - 作为未来联邦学习集成的 **基线平台** ## 功能特性 - 使用 **radare2** 进行静态恶意软件分析 - 可靠的函数枚举 (`aflj`) - 密码学文件元数据提取: - MD5 - SHA1 - SHA256 - 文件大小和熵计算 - 结构化 JSON 报告 - 每个样本的时间戳特征目录 - Docker 化执行以确保可复现性 - 模块间关注点清晰分离 ## 分析流水线 1. **样本摄取** - 从 `data/samples/` 读取二进制文件 2. **静态分析** - 使用 radare2 加载二进制文件 - 执行基础分析 (`aa`) 3. **函数提取** - 枚举已发现的函数 4. **元数据提取** - 哈希、大小、熵 5. **报告生成** - 将结构化 JSON 输出写入 `data/features/` 每个样本都会生成一个 **专用的、带时间戳的报告目录**。 ## 输出格式 data 文件夹下 features 文件夹中的 _{timestamp}/ ### 示例 `analysis.json` ``` { "file_metadata": { "binary_name": "sample.exe", "md5": "…", "sha1": "…", "sha256": "…", "size_bytes": 55296, "entropy": 6.03 }, "functions": [ { "name": "entry0", "offset": 4198400 } ], "risk": { "verdict": "baseline_analysis", "score": 0 } } ``` ### 本地快速上手 Requirements Python 3.11 或 3.12 (推荐) radare2 ## r2pipe # 安装说明 ``` pip install -r requirements.txt ``` # 运行分析 ``` python ingest_file.py ``` # 报告将被写入: ``` data/features/ ``` # Docker 使用方法 -构建并运行 ``` docker compose up --build ``` ## 注意事项 - `data/samples` 和 `data/features` 作为 Docker 卷挂载 - 生成的报告保存在主机文件系统中 - Docker 确保了可复现和隔离的执行环境 ## 已知限制 - 仅限静态分析(无动态执行) - 加壳或高度混淆的二进制文件可能产生有限的结果 - 尚未推断函数语义 - 联邦学习已规划但尚未实现 ## 路线图 - 函数行为分类 - 调用图生成 - 联邦学习的特征归一化 - 命令行界面 (CLI) - 回归和稳定性测试 - 报告模式版本控制 ## 设计原则 - 稳定性优于激进性 - 确定性分析 - 最小化假设 - 清晰的模块边界 - 报告总是生成,否则明确报错 该项目有意避免实验性分析,直到建立起强大且可靠的基线。 ## 许可证 本项目仅用于 **研究和教育目的**。 用户需自行确保在处理恶意软件样本时遵守适用法律。 ## 贡献 欢迎贡献,特别是在以下领域: - 静态分析改进 - 报告模式增强 - 测试和验证 - 文档 请开启一个 issue 或提交 pull request。
标签:DAST, Docker, Homebrew安装, JSON报告, Python, Radare2, TLS指纹, 二进制分析, 二进制情报, 云安全监控, 云安全运维, 云资产清单, 元数据提取, 函数发现, 哈希计算, 威胁情报, 安全防御评估, 容器化安全, 开发者工具, 开源安全工具, 恶意软件分析, 无后门, 特征提取, 确定性分析, 网络安全, 联邦学习, 请求拦截, 进程保护, 逆向工具, 逆向工程, 逆向工程平台, 隐私保护, 静态分析