一个 PHP 文件,零依赖:判断 laravel/framework 是否仍处于 TokenGuard 修复之前(CVE-2026-114509)。无漏洞利用,无网络访问。
一个 PHP 文件。无需 Composer。无需网络。无需漏洞利用。
Laravel 的 token guard 在凭据不是字符串时用于对请求进行身份验证。在 MySQL 和 MariaDB 上,该查询可能匹配到另一个用户。拒绝非字符串令牌的检查于 2026 年 8 月落地。该安全公告 GHSA-f9x3-7vq9-cph6(CVE-2026-114509,CVSS 4.0 9.2)于 10 月 19 日发布。一份来自 9 月的 composer.lock 仍可能处于其错误的一侧。
一个 PHP 文件。零 Composer。无网络调用。无漏洞利用。
Laravel 的 token guard 接受了一个令牌不是字符串的请求。在 MySQL 和 MariaDB 上,查询可能因此命中另一个用户。拒绝非字符串令牌的检查是 2026 年 8 月的。该公告于 10 月 19 日发布,为 GHSA-f9x3-7vq9-cph6(CVE-2026-114509,CVSS 4.0 9.2)。9 月的一个 composer.lock 可能仍低于该版本。
curl -fsSL -o tokengate.php \
https://raw.githubusercontent.com/Nguemoue/project2026_20261030_tokengate/main/tokengate.php
php tokengate.php --self-test
php tokengate.php /path/to/your/laravel
TokenGuard 使用给定的凭据加载用户。在修复之前,唯一的校验是 empty()。非字符串值可以通过该校验并到达查询。安全公告指出,在 MySQL 或 MariaDB 下,该查询可能匹配到一个并非请求所指定的现有用户,且影响任何受该守卫保护的路由。Sanctum 和 Passport 不使用此类。
修复是提交 9b21ce0。user() 仅在 is_string($token) && ! empty($token) 时继续。validate() 除非凭据是非空字符串,否则返回 false。本工具不展示如何构造恶意凭据。
TokenGuard.php 是在框架标签上进行比较的,而不仅仅是依据安全公告中的那句话:
| 分支 | 字符串检查出现自 | 安全公告中的已修复版本 |
|---|---|---|
| 13.x | 13.27.0(该文件在 13.27.0、13.28.0 和 13.29.0 中完全相同) | 13.29.0 |
| 12.x | 12.68.0 | 12.68.0 |
| 11.x | 11.56.1 | 未提及;安全公告列出的是 12.68.0 和 13.29.0 |
| 10.x 及更早版本 | 从未 | 无(安全支持已终止) |
13.27 和 13.28 未被报告为严重:守卫文件已与 13.29.0 一致。但它们仍低于安全公告要求安装的版本号,因此 tokengate 会打印该信息并保持中等严重级别。12.67 和 11.56.0 没有该检查。10.x 从未收到该检查。
安全公告中没有提供变通方案。更新框架即是修复。部署后请重启 PHP-FPM、Octane 和队列工作进程,否则它们会在内存中保留旧文件。
tokengate 1.0.0 CVE-2026-114509
CRITICAL exposed
laravel/framework v12.40.2 is below the TokenGuard fix 12.68.0. Guard [api]
uses driver "token". DB_CONNECTION is mysql (.env.example), which is the
database named in the advisory.
framework v12.40.2 (composer.lock)
token guard api config/auth.php, hash false
Update laravel/framework to 12.68.0 or later. The advisory lists no
workaround. Restart PHP-FPM, Octane and queue workers afterwards so no
process keeps the old file.
Exit 1: findings at or above high.
examples/exposed-12 是故意触发失败的。examples/patched-12 是同一项检查在 12.68.0 上的表现,并以 0 退出。examples/sanctum-old 是一个旧的 13.10 锁定文件,其 api guard 是 Sanctum:token-guard 漏洞并不在该代码路径上,因此默认运行不会失败。它仍然会告诉你框架版本低于修复版本。
报告会指出 guard、文件和数据库驱动。它不会从 .env 中读取 token,也不会打印请求。
| 严重级别 | 判定结果 | 含义 |
|---|---|---|
| critical | exposed | 已安装的标签没有字符串检查,某个 guard 使用了 driver => token,并且 DB_CONNECTION 为 mysql、mariadb 或缺失。 |
| high | exposed | 情况相同,但配置的数据库不是 MySQL 或 MariaDB。已公布的触发条件是这两种数据库。旧 guard 仍然是不应发布的错误代码。 |
| high | no-lock / unknown-version / version-and-unclear-guard | 需要 Laravel,且 tokengate 无法证明已安装修复。^12.0 约束不是版本号。dev-master 不是版本号。env('API_DRIVER') 没有默认值且没有 .env 值时,会隐藏驱动。 |
| medium | unpatched-without-token-guard | 框架版本旧,但找到的每个 guard 驱动都是字面量,且不是 token(通常是 sanctum 或 session)。 |
| medium | guard-fixed | 字符串检查已包含在此标签中,但该标签仍低于公告中的版本号(13.27 和 13.28)。 |
| ok | patched | 11.56.1+、12.68.0+ 或 13.29.0+。 |
| ok | not-laravel | 不需要 laravel/framework。 |
默认 CI 在 high 级别失败。medium 级别会打印,但除非你要求,否则不会失败。
当 tokengate 能读取缓存的 bootstrap/cache/config.php 时,它会优先于 config/auth.php,因为那才是生产环境实际启动时使用的配置。
php tokengate.php # the current directory
php tokengate.php /var/www/app
php tokengate.php --json # stdout is JSON only
php tokengate.php --fail-on=medium # also fail when the guard is absent but unused
php tokengate.php --fail-on=never # always exit 0, still print the report
php tokengate.php --no-color
php tokengate.php --self-test # built-in fixtures, no network
当没有任何内容达到失败级别时,退出码为 0(默认值:high)。当有内容达到失败级别时,退出码为 1。当路径或标志有误时,退出码为 2。
需要 PHP 8.1+ 以及 tokenizer 扩展,PHP 默认自带该扩展。脚本会对你的配置进行词法分析。它不会 include 它,因此 config/auth.php 中的 dd() 不会被执行。
- uses: shivammathur/setup-php@v2
with:
php-version: '8.3'
coverage: none
- name: tokengate
run: php tokengate.php --fail-on=high
或者,不将文件添加到应用中:
- name: tokengate
run: |
curl -fsSL -o /tmp/tokengate.php \
https://raw.githubusercontent.com/Nguemoue/project2026_20261030_tokengate/main/tokengate.php
php /tmp/tokengate.php .
php tokengate.php --self-test 是此仓库的检查项,其退出码为 0。若想查看失败情况,请将扫描器指向 examples/exposed-12。
复制文件。 这是受支持的安装方式。
curl -fsSL -o tokengate.php \
https://raw.githubusercontent.com/Nguemoue/project2026_20261030_tokengate/main/tokengate.php
包含 composer.json 是为了让你可以将路径仓库指向此 git URL。该包不要求发布在 Packagist 上。
composer audit,也不是对整个 lockfile 的扫描。一个 CVE,一个类。config/auth.php 和 bootstrap/cache/config.php。'hash' => true)仍然会经过 TokenGuard,因此仍在范围内。该修复自 2026 年 8 月 25 日起已存在于代码中(Laravel 12.68.0 和 13.29.0)。公开公告发布于 10 月 19 日。在这两者之间,许多应用并未变动:composer.lock 中的标签没有变化,而 token 驱动自 Sanctum 之前的时代起仍沉睡在 config/auth.php 中。
如果以下三点都成立,你就受影响:
laravel/framework 低于 12.68.0、低于 11.56.1,或低于 13.27.0(而公告说的是 13.29.0)。'driver' => 'token'。composer update laravel/framework
php artisan optimize:clear
然后重启 PHP-FPM、Octane 和 worker。tokengate 在本地重新读取锁和配置,然后停止。它不发送任何内容。
php tokengate.php --self-test 重放边界情况:12.67 对 12.68,13.26 对 13.27 对 13.29,11.56.0 对 11.56.1,分支 10,dev-master,一个缺失的锁,一个 Sanctum 驱动,一个只是注释的 'token',一个默认值为 token 的 env(),Postgres 对 MySQL。项目代码从不被执行。
MIT。参见 LICENSE。