针对 Keycloak 重置凭据绕过漏洞(CVE-2026-18963)的 Python PoC 与安全检测探针,该漏洞可导致未认证账户接管,并附带一个包含易受攻击/已修补版本的 Docker 实验环境。
仅凭一个用户名或电子邮件地址,未认证攻击者即可为任意 Keycloak 账户设置任意密码。密码重置邮件会发送给真正的受害者,且攻击者从不需要它——攻击者从不读取邮箱、从不点击链接,也不持有任何先前的凭据或会话。
受影响版本:Keycloak 26.0.0 – 26.7.1。已在 26.7.2 中修复。
一条命令。无需有效用户名,且无副作用——它不发送邮件、不写入任何账户,并在进入可利用步骤之前停止。
git clone https://github.com/hardeep-sudo/Keycloak-CVE-2026-18963-Exploit.git
cd CVE-2026-18963-Exploit
python3 cve_2026_18963_poc.py \
--base https://sso.example.com --realm YOUR_REALM \
--client-id account \
--redirect-uri https://sso.example.com/realms/YOUR_REALM/account/ \
--safe-check
Python 3.9+,仅使用标准库。无需安装任何内容。
| 退出码 | 判定 | 含义 |
|---|---|---|
0 | 🔴 存在漏洞 | 被搁置的电子邮件门控被触发——即漏洞本身 |
2 | 🟢 已修补 | 流程分叉到登录并停留在那里(修复 #51844 已存在) |
2 | 🟡 已缓解 | 重置凭据不可达——忘记密码 已关闭。并非补丁。 |
3 | ⚪ 无法确定 | 无法识别的响应——不要将其视为通过 |
按 realm 分别运行——忘记密码 是按 realm 设置的,且 master 也算一个。
详细信息,以及为什么该检查不需要用户且不触碰任何内容,见
§4a。
已经知道自己暴露了? 跳转到 修复 和 检测 / 威胁狩猎。
该仓库附带一个实验环境,可针对相同的 realm 并排启动一个存在漏洞的 26.7.1 和一个已修补的 26.7.2,外加一个邮箱,用于观察重置电子邮件到达并在账户被接管期间保持未读:
cd lab && docker compose up -d
python3 ../cve_2026_18963_poc.py --base http://localhost:8080 \
--realm poc --client-id poc-app --safe-check # VULNERABLE
python3 ../cve_2026_18963_poc.py --base http://localhost:8100 \
--realm poc --client-id poc-app --safe-check # PATCHED
⚠️ 仅限授权测试
本仓库面向防御人员、事件响应人员及获得授权的 渗透测试人员。请仅在您拥有或持有书面 测试许可的系统上运行它。此处所有内容均附带一个自包含的漏洞实验环境 (
lab/),因此无需触碰任何外部系统即可了解该漏洞的运作方式。 未经授权将其指向第三方基础设施在 大多数司法管辖区均属违法,本项目不支持此类行为。
参考: keycloak#51833 · GHSA-4gv3-mc9p-5wqc · 修复 keycloak#51844
两个缺陷串联所致。单独任何一个都无法被利用。
services/src/main/java/org/keycloak/authentication/DefaultAuthenticationFlow.java
processAction()——任何携带表单键 tryAnotherWay 的 POST 请求:
processor.getAuthenticationSession().setAuthNote(
AuthenticationProcessor.AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED, "true");
return createSelectAuthenticatorsScreen(model);
该标记是一个裸布尔值,不记录它属于哪个执行集。它仅在处理已提交的 authenticationExecution 参数的分支中被清除。省略该参数——正如本 PoC 全程所做的那样——该标志在认证会话的整个生命周期内都会保持置位。
processFlow()——当该标志为真值时,正常的流程评估会被跳过:
if (Boolean.parseBoolean(authSession.getAuthNote(AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED))) {
String lastExecutionId = authSession.getAuthNote(CURRENT_AUTHENTICATION_EXECUTION);
if (lastExecutionId != null) {
AuthenticationExecutionModel executionModel =
realm.getAuthenticationExecutionById(lastExecutionId);
if (executionModel != null)
return createSelectAuthenticatorsScreen(executionModel); // <-- attacker-usable form
}
}
它渲染一个可提交的表单,目标是当前被挂起的任何执行, 而不是让会话一直停留在*“等待电子邮件”*状态。
粘合逻辑是 processResult() 的 case FORK: —— 当发送重置邮件触发时,它会标记
CURRENT_AUTHENTICATION_EXECUTION = <reset-credential-email execution id>,并将
浏览器分叉到登录页面。被挂起的执行正是电子邮件关卡。
services/src/main/java/org/keycloak/authentication/authenticators/resetcred/ResetCredentialEmail.java
@Override
public void action(AuthenticationFlowContext context) {
context.getUser().setEmailVerified(true);
context.success();
}
无条件。没有任何机制验证流程是由有效的 action token 恢复的,因此到达 action() 就被视为等同于证明了对邮箱的控制。
tryAnotherWay POST → sticky AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED="true"
submit victim identifier → mail sent to victim, e-mail execution parked (FORK)
re-enter reset-credentials → sticky flag serves a form targeting the parked e-mail execution
POST that form → ResetCredentialEmail.action() → success() → gate bypassed
→ flow advances to UPDATE_PASSWORD → attacker sets the password
六个 HTTP 请求,无需认证,全程不涉及 authenticationExecution 参数。
model.getId(),而 processFlow() 仅在其等于 CURRENT_AUTHENTICATION_EXECUTION 时才认可它,否则将其移除。在攻击中两者并不相同(choose-user id 与 e-mail-gate id)——这正是补丁所检测的内容,也正是 --safe-check 所依据的信号。ResetCredentialEmail.action() 现在要求
context.getUser().getId().equals(authNote(ACTION_TOKEN_USER_ID)),
否则以 INVALID_USER 失败。| 分支 | 是否受影响 | 社区修复版本 |
|---|---|---|
| 旧版(基于 WildFly 的 Keycloak,≤ 17) | 不受影响 | — |
| Quarkus 17 – 25.x | 不受影响 | — |
| 26.0 | 26.0.0 – 26.0.17 | 无 |
| 26.1 | 26.1.0 – 26.1.5 | 无 |
| 26.2 | 26.2.0 – 26.2.16 | 无 |
| 26.3 | 26.3.0 – 26.3.5 | 无 |
| 26.4 | 26.4.0 – 26.4.14 | 26.4.15(厂商回移标签) |
| 26.5 | 26.5.0 – 26.5.7 | 无 |
| 26.6 | 26.6.0 – 26.6.5 | 26.6.6(厂商回移标签) |
| 26.7 | 26.7.0 – 26.7.1 | 26.7.2 |
6a9e60bb 引入的,该提交向重置流程添加了 “Try another way” 认证器选择界面。更早的版本根本没有这条代码路径。这包括旧的基于 WildFly 的发行版和 RH-SSO 7.x,它们不受此漏洞影响,但仍处于生命周期终止状态,且易受许多其他漏洞影响。停留在旧版构建上并不是一种修复措施。26.7.2 是社区版本线中唯一发布的修复版本。如果部署停留在 26.0 – 26.6,则该分支上没有补丁发布——修复需要次版本升级,而非补丁版本升级。26.4.15 / 26.6.6 标签是厂商回移版本,不能与社区镜像互换使用。前提条件: realm 启用了忘记密码功能,并且其绑定的重置凭据流程使用内置的 reset-credential-email 认证器。
该仓库同时提供存在漏洞和已打补丁的 Keycloak,导入完全相同的 realm,并附带 Mailpit 用于捕获重置邮件——因此你可以观察邮件到达并在账户被接管期间保持未读状态。
cd lab
docker compose up -d
| 服务 | URL | 版本 |
|---|---|---|
kc-vuln | http://localhost:8080 | 26.7.1 — 存在漏洞 |
kc-patched | http://localhost:8100 | 26.7.2 — 已修补对照 |
kc-mailpit | http://localhost:8025 | 受害者的邮箱 |
Realm poc,公共客户端 poc-app,用户 victim / OriginalPassw0rd!,Keycloak
管理员 admin / admin。
使用 KC_VULN_VERSION / KC_PATCHED_VERSION 固定不同的构建版本:
KC_VULN_VERSION=26.5.7 docker compose up -d keycloak-vuln
在多次运行之间,lab/reset-victim.sh 会恢复受害者的密码
(KC=http://localhost:8100 lab/reset-victim.sh 针对已修补的实例)。
lab/legit_reset.py 通过从 Mailpit 中提取 action-token 链接并点击它,执行一次真正的重置。
它是 §9 中检测工作的对照样本——对同一个 realm 分别运行它和漏洞利用,然后对比两者的追踪记录。
清理:docker compose down -v。
Python 3.9+,仅使用标准库——无依赖,可直接放到任意跳板机上。
--base Keycloak base URL (e.g. https://sso.example.com)
--realm realm name
--client-id any enabled public client with the standard flow
--redirect-uri a URI permitted by that client (default http://localhost:9999/callback)
--insecure skip TLS verification
--verbose log every HTTP request
--dump FILE write the response body of a failing step to FILE
--client-id 可以是任何启用了标准流程的公共客户端。内置的
account 客户端存在于每个 realm 中,是可靠的选择,但它会限制
重定向 URI,因此此时 --redirect-uri 必须为
<base>/realms/<realm>/account/ —— 默认值会被拒绝,步骤 1 会失败。
--safe-check)—— 从这里开始不需要有效用户名,且没有副作用。当你不能干扰目标时, 应使用此探测。