SuperAPI AI 工具集

secret-scan-trufflehog

通用与其它

查看项目

更新于 10-16 09:54

技能介绍

用途:作为安全工程师使用 TruffleHog 进行密钥检测,查找并验证硬编码密钥,适用于需要对密钥做有效性验证(确认是否仍活跃/有效)的扫描场景。支持扫描 Git 仓库、文件系统、S3 等来源。

主要能力:

  • 对 Git 仓库、文件系统、远程 GitHub 组织/仓库等进行扫描
  • 使用验证机制确认检测到的密钥是否为活跃密钥
  • 支持仅输出已验证密钥、排除指定路径
  • 以 JSON 格式输出结果

必要条件: 需安装 TruffleHog,安装命令为 brew install trufflehog 或 pip install trufflehog,可用 trufflehog --version 验证。

使用方式:

  1. 确定要扫描的目标来源。
  2. 运行扫描,常用命令: Git 仓库:trufflehog git file://<repo-path> --json > trufflehog-results.json 文件系统:trufflehog filesystem <path> --json > trufflehog-results.json GitHub 组织/仓库(远程):trufflehog github --org=<org-name> --json > trufflehog-results.json 仅已验证密钥:trufflehog git file://. --only-verified --json 排除路径:--exclude-paths=<exclude-file>
  3. 解析 JSON 输出并按表格呈现发现项,包含编号、检测器、是否已验证、文件、提交、脱敏后的原始值、严重程度。注意始终对密钥值脱敏,绝不显示完整密钥。
  4. 汇总结果:统计已验证(活跃)与未验证的发现项数量;已验证密钥需立即轮换;修复优先级以已验证的活跃密钥优先。修复步骤包括轮换、撤销、从历史记录中移除(可使用 git filter-branch 或 BFG)。

限制:官方资料未提供关于扫描性能、速率限制、支持的完整来源列表或付费方案等信息;本技能依赖 TruffleHog 自身能力,验证结果取决于目标服务可达性。