用途:在源代码中深度检测硬编码凭据和敏感数据,如 API 密钥、密码、令牌、私钥等。
主要能力:内置高置信度模式(AWS、GitHub、GitLab、Slack、Stripe、Twilio、SendGrid、Google、私钥等)和中等置信度模式(通用 API Key、Secret、Password、连接字符串、Bearer Token)。支持 --entropy 高熵检测,发现 Base64、十六进制或自定义格式的潜在机密;支持 --git-history 扫描提交历史中已提交后删除的机密;支持 --scope 指定路径或文件、--exclude 排除模式。输出按严重级别和类型统计,并给出修复建议。
使用方式:/secrets-scan 扫描当前目录;/secrets-scan --scope src/ 指定路径;/secrets-scan --entropy 启用熵检测;/secrets-scan --git-history 检查 Git 历史;/secrets-scan --git-history --since "2024-01-01" 限定时间;/secrets-scan --exclude "*.test.ts" 排除文件。可通过 .secrets-scan-ignore 文件或行内注释 secrets-scan-ignore 忽略误报。退出码:0 无发现,1 有发现,2 扫描错误。可集成 CI/CD 与 pre-commit 钩子。
适用场景:代码审计、提交前检查、CI 流水线、清理历史泄露。
限制:中等置信度模式需上下文验证,可能产生误报;熵检测会增加发现数量与误报;示例值、测试夹具、文档可能被误报,需配合忽略规则。具体安装与集成细节以实际环境为准。