Docker Hub 账户转换 PAT 重新分配(CVE-2026-105445)
一个离线厂商证据记录工具,而非扫描器
docker-hub-pat-check 是 CVE-2026-105445 的专用仓库,该漏洞是一起历史性的、服务端的 Docker Hub 暴露事件。Docker 报告称,账户到组织的转换会将个人访问令牌(PAT)重新分配给指定的新所有者,而不会轮换令牌密钥。该暴露事件从 2024-08-26 20:33 UTC 持续到 Docker 大约在 2026-09-30 19:10 UTC 完成修复为止。
不存在客户端或 Docker 版本规则。只有 Docker 才能说明哪些账户被暴露。本工具记录管理员已经掌握的证据(Docker 的通知是否到达、何时到达,以及执行了何种修复),并将其转化为一致、可报告的状态。它从不联系 Docker Hub,从不测试令牌,也从不读取令牌。
[!IMPORTANT] “未收到通知”是 Docker 的说法,而非证据。 Docker 表示未收到电子邮件的账户未被暴露。本工具记录这一归因,但仍报告为
unknown。Docker 还报告没有发现任何利用证据;这是厂商的结论,而非本工具验证的内容。正如厂商自身所指出的,注册表日志显示的是令牌的使用情况,而非令牌是否存在。
python docker_hub_pat_check.py --notification received --notification-date 2026-10-02 \
--remediation operator_revoked_or_rotated --remediation-date 2026-10-05 \
--retained-listed-tokens no --label example-account --format json
python docker_hub_pat_check.py --inventory examples/evidence.example.json --format html --output report.html
python docker_hub_pat_check.py --evidence-csv examples/evidence.example.csv --format csv
python docker_hub_pat_check.py --help
使用 python -m unittest -v 运行测试。
每条记录描述一个账户的证据。记录可以来自命令行、JSON 文件、CSV 文件或任意组合;一次运行最多处理 10,000 条记录。
| 输入 | 选项 | 说明 |
|---|---|---|
| 单条记录 | --label、--notification、--notification-date、--remediation、--remediation-date、--retained-listed-tokens、--evidence-source | 提供其中任意一项即从命令行创建一条记录。 |
| JSON | --inventory FILE(可重复) | 一个对象或一个数组;每个都需要 "schema_version": 1。参见 examples/evidence.example.json。 |
| CSV | --evidence-csv FILE(可重复) | UTF-8 编码,带表头行。参见 examples/evidence.example.csv。 |
记录字段:
| 字段 | 取值 |
|---|---|
label | 化名文本,最多 512 个字符(默认 unlabeled) |
notification | received、not_received、unknown |
notification_date | YYYY-MM-DD |
remediation | operator_revoked_or_rotated、vendor_deactivated、not_done、unknown |
remediation_date | YYYY-MM-DD |
retained_listed_tokens | yes、no、unknown(是否在知情情况下保留了通知中列出的令牌) |
evidence_source | vendor_email、vendor_support、vendor_statement、operator_attestation |
其他选项:
| 选项 | 用途 |
|---|---|
--format csv|json|html | 报告格式(默认 csv)。 |
--output FILE | 将报告写入新文件;不提供时报告输出到 stdout。 |
--force | 替换已存在的输出文件。 |
--brand NAME | HTML 报告中显示的组织名称(默认 CompleteTech LLC)。 |
--fail-on-finding | 当任一结果为 potentially_affected 时以退出码 1 退出。 |
--version、--help | 显示工具版本或完整的选项帮助。 |
空值或缺失值视为未提供;取值会去除首尾空白且不区分大小写。docs/REFERENCE.md 记录了每个字段、限制、输出列和规则。
| 退出码 | 含义 |
|---|---|
0 | 已完成。除非设置了 --fail-on-finding,否则发现结果不会改变此退出码。 |
1 | 已设置 --fail-on-finding,且至少存在一个 potentially_affected 结果。 |
2 | 参数、输入或输出错误。优先于 1。 |
130 | 被中断。已完成的观测结果会尽可能保留;参见中断与恢复。 |
结构上无效的输入属于操作错误(退出码 2),而非评估结果:不支持的字段、重复的 JSON 键、类型错误、控制字符、格式错误的 CSV 或 JSON、超过 4 MiB 的文件、过长的字符串、无法读取的文件,以及任何看起来像 Docker 令牌的值。错误消息绝不会回显所提供的文本。在一条原本有效的记录中,无法识别的枚举值或无效日期属于评估结果:unknown 并附带 malformed_evidence。
| 状态 | 此处含义 |
|---|---|
potentially_affected | 操作者报告已收到 Docker 的通知,因此厂商认为被转移的 PAT 在范围内,且未完整报告修复情况。并非确认已被利用。 |
fixed_version_reported | 已收到通知,且操作者报告了修复情况并附有日期,且未在知情情况下保留通知中列出的令牌。此处没有版本比较;这仅表示"已报告修复",绝非保证。 |
unknown | 证据缺失、格式错误、相互矛盾、超出厂商时间线,或仅说明未收到通知。绝不会是干净的结果。 |
unsupported_runtime 不适用:不存在运行时生命周期,也不存在 version_status。docker_hub_pat_evidence_status 给出原因(例如 vendor_unnotified_claim、conflicting_evidence、remediation_reported;完整列表见 docs/REFERENCE.md),而 docker_hub_pat_exploitability 始终为 not_tested。fixed_version_reported 反映的是操作员报告的修复情况,而非经过验证的已部署补丁。
日期使用机器的 UTC 日期对照供应商时间线进行检查。通知日期不得早于 Docker 的 2026-10-02 邮件;操作员自身的修复日期可以落在从暴露开始(2024-08-26)到今天的任意一天,因为 2026-09-30 是 Docker 的服务修复日期,而非操作员撤销令牌的时间限制;日期早于 Docker 2026-10-08 停用日期的 vendor_deactivated 声明属于 conflicting_evidence。未来日期会被拒绝。规则在你所运行的构建版本中固定,因此旧副本不会获取后续更改。
由合成的示例证据(保留的 example-* 标签)渲染而成。来源:docs/example-report.html。它不描述任何真实账户。
complete 列、record_type 列(result,或零结果报告中的 summary)以及与 JSON 相同的字段。tool、tool_version、schema_version、rules_as_of、generated_at、complete、rules(每项含声明、来源 URL 和审查日期)以及 results。每种格式都会标识 docker-hub-pat-check 及其工具版本。报告将每条记录的 UTC 评估时间(checked_at,在 HTML 中标记为 Assessment time (UTC))与 UTC 报告生成时间分开。CSV 在现有列之后追加 tool、tool_version 和 generated_at,包括零结果摘要。一次 CLI 运行在中断渲染恢复过程中保持同一个生成时间。这两个时间都不是证据获取时间,也不证明供应商修复。结果字段(docker_hub_pat_status、docker_hub_pat_evidence_status、docker_hub_pat_exploitability、docker_hub_pat_cves、docker_hub_pat_rules_as_of、docker_hub_pat_sources、docker_hub_pat_notes、docker_hub_pat_recommendation 以及回显的输入)列于 docs/REFERENCE.md。
--force 时拒绝覆盖现有输出文件,且即使使用 --force,输出也必须与每个输入文件不同。其目录必须已存在。--force 时使用硬链接,因此目标文件系统必须支持硬链接。--output 写入的文件具有仅所有者权限(模式 0600)。Stdout 和 Windows 文件遵循常规平台默认值。reports/、private/ 和 inventories/ 已被忽略),并应用你自己的保留策略。