Skip to content
KitploitKITPLOIT
工具漏洞利用博客
Log in
提交
工具漏洞利用博客
提交

黑客、渗透测试和网络安全工具,武装您的安全武器库!

Kitploit 是一个黑客、网络安全和渗透测试工具的目录。发现最新的项目更新,查找漏洞、分析系统、自动化测试并加强你的安全。

订阅源联系隐私© 2026 Kitploit

工具目录

分类

查看所有分类
Loading categories
Secrets Scanner — 用于源代码和 git 历史的无依赖密钥扫描器,可检测泄露的 API 密钥、令牌和私钥,输出经过脱敏,并提供可直接使用的 GitLab CI 作业。 | Kitploit
工具/GitLabGitLab/daveyd347/secrets-scanner
防御工具静态分析漏洞扫描器代码分析脚本与自动化DevSecOps秘密检测供应链安全
GitLabdaveyd347/secrets-scanner

Secrets Scanner

用于源代码和 git 历史的无依赖密钥扫描器,可检测泄露的 API 密钥、令牌和私钥,输出经过脱敏,并提供可直接使用的 GitLab CI 作业。

查看仓库
20小时34分前尚未审核
分享
网站

secretscan

一个小巧、无依赖的密钥扫描器,适用于源代码和 git 历史,并附带可直接使用的 GitLab CI 任务。

它能在泄露的 API 密钥、令牌、私钥和密码进入生产环境之前将其发现,包括那些曾被提交过一次、后来被“删除”但仍留在历史记录中的密钥。

$ secretscan scan . --history
[HIGH    ] url-credentials              deploy.sh:1 (commit 79831acaf3, Dev <[email protected]>)
           Credentials embedded in a URL: Fake********
[HIGH    ] aws-access-key-id            settings.py:1 (commit 79831acaf3, Dev <[email protected]>)
           AWS access key ID: AKIA************

2 potential secret(s) found.

在该演示中,AWS 密钥在后续提交中从 settings.py 里被删除。普通文件扫描会显示仓库是干净的,但该密钥仍可通过 git log -p 恢复,因此它仍然处于泄露状态。

功能特性

  • 16 条内置规则:AWS、GitHub、GitLab(PAT 和 runner token)、Slack、Stripe、Google、OpenAI、 Anthropic、PEM 私钥、JWT、URL 中的凭据,以及一条通用的 password = "..." 规则。
  • 熵过滤(Shannon 熵)应用于噪声较大的通用规则,并附带占位符过滤器,用于过滤 changeme、${API_KEY}、{{ vault_token }} 和 <your-password> 等值。
  • Git 历史扫描:从最旧到最新遍历每个提交,仅检查新增行,并将 每个密钥归属到引入它的提交和作者,且行号准确。
  • 合并请求模式:--rev-range base..HEAD 仅扫描新提交。
  • 默认输出已脱敏,因此扫描器自身的日志永远不会成为二次泄露源。
  • 三种输出格式:人类可读文本、JSON,以及 GitLab Secret Detection 报告模式。
  • 抑制机制:.secretscanignore(gitignore 风格的通配符)和内联 # secretscan:ignore。
  • 适合 CI 的退出码,配合 --fail-on 严重性阈值。
  • 纯标准库;Python 3.10+。

安装

pip install git+https://gitlab.com/DaveyD347/secrets-scanner.git
# or, from a clone
pip install -e ".[dev]"

用法

secretscan scan                       # scan the current directory's files
secretscan scan path/to/repo --history        # files + entire git history
secretscan scan . --history-only              # history only
secretscan scan . --rev-range origin/main..HEAD   # only commits not yet on main
secretscan scan . --format json -o findings.json
secretscan scan . --fail-on high              # only fail on high/critical
secretscan rules                              # list rules
退出码含义
0没有达到或超过 --fail-on 阈值的发现项
1存在达到或超过 --fail-on 阈值的发现项
2用法错误(路径错误、不是 git 仓库等)

抑制误报

添加一个内联标记:

EXAMPLE_KEY = "..."  # secretscan:ignore

或在仓库根目录创建 .secretscanignore:

# test fixtures
tests/fixtures/
*.lock

GitLab CI

将可复用作业添加到任意项目:

include:
  - remote: "https://gitlab.com/DaveyD347/secrets-scanner/-/raw/main/templates/secretscan.gitlab-ci.yml"

该任务会克隆完整历史(GIT_DEPTH: 0),在合并请求流水线上仅扫描新增提交,在其他情况下扫描整个历史,发现结果时使流水线失败,并将 gl-secret-detection-report.json 作为 secret_detection 报告上传。在 GitLab Ultimate 上,这些发现会显示在合并请求安全小组件和漏洞报告中;在其他版本中,该报告仍会作为可下载的产物保留。设置 SECRETSCAN_FAIL_ON 以调整阈值。

本仓库自身的 .gitlab-ci.yml 会进行代码检查、在 Python 3.10 至 3.13 上运行带覆盖率的测试,并针对自身历史运行扫描器。

工作原理

  1. 规则(src/secretscan/rules.py)是正则表达式。第一个捕获组即为密钥。 通用规则还设置了最小熵值,因此 password = "aaaaaaaaaaaa" 不会触发。
  2. 文件扫描遍历目录树,跳过 .git、node_modules、虚拟环境、二进制文件(NUL 字节嗅探)、 超过 2 MB 的文件以及 .secretscanignore 中的任何内容。
  3. 历史扫描运行 git log --all --reverse -p --unified=0 并解析差异流,从每个 @@ 块头中跟踪 当前提交、文件和新侧行号。仅检查 + 行,因此密钥只会在引入它的提交处报告一次, 而不是在之后的每个提交中都报告一次。
  4. 报告会对值进行脱敏,并对同时出现在工作树和历史中的密钥进行去重。

开发

pip install -e ".[dev]"
pytest
ruff check . && ruff format --check .

测试夹具从不包含真实凭据。tests/fakes.py 中的假令牌在运行时由片段拼接而成,因此仓库本身不包含任何完整的令牌形状字符串。这使 CI 自扫描保持干净,并避免触发 GitLab 推送保护。

局限性与设想

  • 正则表达式加熵值总会存在一些误报和漏报。它不会针对提供商 API 验证密钥。
  • 不会扫描归档文件或二进制文件内部。
  • 可能的后续步骤:从 TOML 文件加载自定义规则、用于接受现有发现结果的基线文件、pre-commit 钩子,以及 SARIF 输出。

许可证

MIT

下载工具

最受欢迎

查看全部 →

发现我们社区最常用的工具。

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 终极 OSINT 工具包:调查图谱、置信度评分、别名家族、地图、时间线和报告。49 个模块、400+ 个站点,无需 API 密钥。

    755
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock 一键执行应用(CVE-2026-43499)

    510
  • 3

    ARTEX

    baarai/artex

    基于LLM的多智能体自主渗透测试平台,具备规划器/执行器智能体、资产与探索图谱、MITM流量记录以及漏洞复测功能。

    415
  • 4

    redforge

    cybersecurity91/redforge

    浏览器端红队工具包,包含 102 个离线工具,用于侦察、载荷生成、凭据攻击、加密、编码和交战报告。

    343
  • 5

    antifox

    antifox-ai/antifox

    AI multi-agent autonomous penetration testing platform that runs recon, attack-surface discovery, exploitation validation and evidence-backed report delivery.

    259
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI原生网络安全的行动系统——在这里,意图转化为受治理的执行,证据沉淀为运营记忆,每一次操作都让下一次更出色。

    258

探索所有工具

浏览我们的工具集合

查看所有工具 →