原创 Groot 2026-08-27 10:24 中国香港
CVE-2026-18963 是 keycloak-services组件 reset-credentials身份验证流中的严重认证绕过漏洞(CVSS 9.1,CWE-640)。
未经认证的远程攻击者只要知道目标用户名或邮箱地址,就可以强制密码重置并获得目标账户的完全控制权,而无需点击邮箱验证链接。
CVE-2026-18963 是 keycloak-services组件 reset-credentials身份验证流中的严重认证绕过漏洞(CVSS 9.1,CWE-640)。
未经认证的远程攻击者只要知道目标用户名或邮箱地址,就可以强制密码重置并获得目标账户的完全控制权,而无需点击邮箱验证链接。
受影响范围:
- Red Hat Build of Keycloak (RHBK) 26.4、26.6 — 修复版本:26.4.15 / 26.6.6(通过 RHSA-2026:56519/56520/56523/56524)
- 社区 Keycloak 26.0.0 – 26.7.1 — 修复版本:26.7.2(注意:26.4.x 和 26.6.x 社区版本没有对应的 public Quay 后置版本;26.4.15 / 26.6.6 标签是 RHBK 特有的)
报告者:James Parémain(2026-07-31 报告给 Red Hat)。
公开问题:keycloak/keycloak#51833
修复 PR:[^51844](https://github.com/keycloak/keycloak/pull/51844)(已合并)
该绕过是两个缺陷的组合:一个是状态追踪备注的语义缺陷(使跨执行的状态复用成为可能),另一个是 ResetCredentialEmail.action()中缺失操作令牌验证。
在 reset-credentials流中,Keycloak 使用认证备注 AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED来追踪“身份验证选择器屏幕”(即“try another way”步骤)是否已渲染。
常量定义(AuthenticationProcessor.java第 94 行,26.0.0 源码):
publicstaticfinalStringAUTHENTICATION_SELECTOR_SCREEN_DISPLAYED="auth.selector.screen.rendered";
从名称看是“屏幕已显示”的标记。关键问题在于它被写入和读取的方式。
tryAnotherWay分支中的无条件 "true"
在 DefaultAuthenticationFlow.processAction()中,当检测到 tryAnotherWay输入时(26.0.0 源码,第 96 行附近):
if (inputData.containsKey("tryAnotherWay")) {
logger.trace("User clicked on link 'Try Another Way'");
processor.getAuthenticationSession().setAuthNote(
AuthenticationProcessor.AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED,
"true"// ← 布尔值字符串,无执行模型绑定
);
return createSelectAuthenticatorsScreen(model);
}
技术意义:这里写入的只是一个字面量 "true",不包含任何执行模型的标识。这意味着,只要攻击者提交了 tryAnotherWay,就会在认证会话中留下这个标记,而该标记不与当前的 AuthenticationExecutionModel绑定。
processFlow()中的布尔解析
在 DefaultAuthenticationFlow.processFlow()中(26.0.0 源码,第 241 行附近):
if (Boolean.parseBoolean(
processor.getAuthenticationSession()
.getAuthNote(AuthenticationProcessor.AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED)
)) {
logger.tracef("Refreshed page on authentication selector screen");
String lastExecutionId = processor.getAuthenticationSession()
.getAuthNote(AuthenticationProcessor.CURRENT_AUTHENTICATION_EXECUTION);
if (lastExecutionId !=null) {
AuthenticationExecutionModel executionModel =
processor.getRealm().getAuthenticationExecutionById(lastExecutionId);
if (executionModel !=null) {
return createSelectAuthenticatorsScreen(executionModel);
}
}
}
技术意义:这里用 Boolean.parseBoolean(...)读取该备注。只要备注存在且能解析为 true,就进入该分支。这种读取不检查该标记是不是属于当前执行模型。
综合来看,存在以下链条:
- 攻击者提交
tryAnotherWay,认证会话中写入"true"(不绑定执行模型)。 - 在后续的流处理中,
processFlow()读取该备注,Boolean.parseBoolean("true")为true,于是进入“刷新选择器屏幕”的逻辑分支。 - 此逻辑分支依赖
CURRENT_AUTHENTICATION_EXECUTION备注来决定要重入哪个执行模型。如果攻击者能使该备注也指向他们想要的执行上下文,或者如果流处理恰好在一个允许绕过邮箱验证的执行模型上运行,漏洞就会出现。
重要细节:
- 写入是无条件
"true",不绑定模型。 - 读取是单纯的布尔解析,不验证模型归属。
- 单独提交
tryAnotherWay不会直接导致账户接管,但会为绕过建立必要的状态:攻击者可让认证会话保留“选择器页面已显示”的标记,且该标记不会因执行模型变化而失效。
PR [#51844] 修改了上述两处:
写入侧(DefaultAuthenticationFlow.java):将 "true"改为 model.getId():
processor.getAuthenticationSession().setAuthNote(
AuthenticationProcessor.AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED,
model.getId() // ← 绑定到当前执行模型
);
读取侧(同文件):改为对模型 ID 的比对,并在不匹配时移除该备注:
String selector = processor.getAuthenticationSession()
.getAuthNote(AuthenticationProcessor.AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED);
if (selector !=null) {
String lastExecutionId = processor.getAuthenticationSession()
.getAuthNote(AuthenticationProcessor.CURRENT_AUTHENTICATION_EXECUTION);
if (selector.equalsIgnoreCase(lastExecutionId)) {
logger.tracef("Refreshed page on authentication selector screen");
AuthenticationExecutionModel executionModel =
processor.getRealm().getAuthenticationExecutionById(lastExecutionId);
if (executionModel !=null) {
return createSelectAuthenticatorsScreen(executionModel);
}
} else {// 当模型不匹配时,干净地移除过期备注
processor.getAuthenticationSession()
.removeAuthNote(AuthenticationProcessor.AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED);
}
}
这样,该标记只有在与当前执行模型 ID 匹配时才会被识别,否则被移除。这切断了攻击者通过提交 tryAnotherWay在一个上下文中“种下”标记、然后在另一个上下文中使其被识别的能力。
ResetCredentialEmail.action()中缺失的操作令牌验证
第二个缺陷是凭据重置操作本身的处理器。
文件:services/src/main/java/org/keycloak/authentication/authenticators/resetcred/ResetCredentialEmail.java
类:ResetCredentialEmail(实现 Authenticator和 AuthenticatorFactory)
authenticate()方法:有部分保护
在 26.0.0 源码中,authenticate()方法确实包含对操作令牌的检查(节选):
@Override
publicvoid authenticate(AuthenticationFlowContext context) {
UserModel user = context.getUser();
AuthenticationSessionModel authenticationSession = context.getAuthenticationSession();
String username = authenticationSession.getAuthNote(
AbstractUsernameFormAuthenticator.ATTEMPTED_USERNAME
);
if (user ==null) {
context.forkWithSuccessMessage(newFormMessage(Messages.EMAIL_SENT));
return;
}
String actionTokenUserId = authenticationSession.getAuthNote(
DefaultActionTokenKey.ACTION_TOKEN_USER_ID
);
if (actionTokenUserId !=null&&
Objects.equals(user.getId(), actionTokenUserId)) {// 已通过操作令牌重新认证:跳过此屏幕,直接成功
logger.debugf("Forget-password triggered when reauthenticating user "+
"after authentication via action token. Skipping "+PROVIDER_ID+" screen "+
"and using user '%s'", user.getUsername());
context.success();
return;
}// ... 向用户邮箱发送重置链接 ...
}
技术意义:
- 如果认证会话中已经有
ACTION_TOKEN_USER_ID且与当前用户匹配,authenticate()会提前成功,不再发送邮箱。 - 这种检查是针对“用户已点击邮箱链接、正在重新认证”的场景。
action()方法:完全无保护
而 action()方法在 26.0.0 源码中仅有:
@Override
publicvoid action(AuthenticationFlowContext context) {
context.getUser().setEmailVerified(true);
context.success();
}
action()是在认证流中处理“重置凭据”操作提交时的回调。- 它不检查
ACTION_TOKEN_USER_ID,也不验证请求是否来自有效的操作令牌。 - 它直接将用户标记为邮箱已验证,并调用
context.success()。 -
这就是漏洞的第二个缺口:即使没有经过邮箱令牌步骤,只要能进入
action(),流程就会成功。 -
authenticate()是认证流程中的“挑战/响应”阶段,用于决定下一步(发送邮件 or 成功)。 action()是处理具体操作提交的阶段。在reset-credentials流中,攻击者可以构造请求直接命中action(),而不经过正常的邮箱令牌点击路径。
因此,仅靠 authenticate()中的令牌检查不足以防止在 action()阶段的绕过。
PR [#51844] 修改了 action():
@Override
publicvoid action(AuthenticationFlowContext context) {
UserModel user = context.getUser();
String actionTokenUserId = context.getAuthenticationSession()
.getAuthNote(DefaultActionTokenKey.ACTION_TOKEN_USER_ID);
if (user !=null&& user.getId().equals(actionTokenUserId)) {
context.success();
} else {// not called via action token or any other weird situation
context.failure(AuthenticationFlowError.INVALID_USER);
}
}
这样,只有当认证会话中携带了与当前用户匹配的操作令牌用户 ID 时,action()才成功;否则返回 INVALID_USER失败。这要求请求必须是通过合法的操作令牌触发的。
攻击者要利用此漏洞,需要满足以下条件:
- 目标 Keycloak 实例运行易受攻击版本 (26.0.0 – 26.7.1,或对应的 RHBK 版本),并且
- “Forgot password”功能在目标 realm 上启用 (默认启用),这样
reset-credentials流才可触发,且其中包含reset-credential-email执行器。 - 攻击者知道目标用户名 (或邮箱),以便发起重置。
- 攻击者能够提交
tryAnotherWay以设置AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED = "true"。 - 攻击者能够提交
action()调用 ,直接命中ResetCredentialEmail.action(),此时: - 认证会话中存在未绑定模型的
"true"标记(由步骤 4 产生); action()不检查操作令牌,无条件成功;-
攻击者绕过邮箱验证,直接进入密码设置阶段。
-
发起重置请求 :攻击者向
reset-credentials流发起密码重置请求,指定目标用户名。此时 Keycloak 调用ResetCredentialEmail.authenticate()(若未检测到操作令牌,则发送重置邮件给目标用户邮箱)。攻击者无需接收此邮件。 - 预置状态标记 :攻击者提交带有
tryAnotherWay=on的请求到重置流。processAction()检测到该输入,将认证会话备注AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED设置为"true"(不绑定模型)。 - 提交操作 :攻击者提交直接命中
ResetCredentialEmail.action()的请求。因为: action()不检查ACTION_TOKEN_USER_ID;- 它直接调用
context.getUser().setEmailVerified(true)并context.success(); - 认证会话中存在未绑定模型的
"true"标记,可能被后续流逻辑识别为合法状态;
攻击者绕过了邮箱验证步骤,直接进入密码设置阶段。
- 设置新密码 :攻击者在
UPDATE_PASSWORD步骤设置新密码。成功后获得目标账户的完全控制权,包括移除现有 MFA(因为重置流按设计跳过 2FA)。
利用此漏洞不需要任何有效的 Keycloak 身份验证凭据。攻击者从外部即可发起重置请求。
受害者不会接收到攻击者利用所需的任何交互;攻击者也不需要访问受害者邮箱。重置邮件确实会发送给受害者(这是 authenticate()中的行为),但攻击者绕过了点击该邮件链接的步骤。
一旦攻击者知道目标用户名(或邮箱),利用就变得可行。用户名枚举可能通过多种途径获得(目录枚举、泄露邮箱列表、AD/LDAP 用户枚举等)。
攻击者可以通过网络远程提交请求,无需本地访问或特殊网络位置。
- “Forgot password”功能启用 :只有在目标 realm 上启用了“Forgot password”时,
reset-credentials流才可触发。默认情况下是启用的。 - 包含
reset-credential-email执行器的流 :默认的reset-credentials流包含此执行器。若使用自定义流且不包含此执行器,可能不受影响(但内置流仍可能存在于 realm 中,若未绑定到登录流则不可触发)。
密码重置流按设计跳过 2FA 步骤。攻击者在接管账户后可以移除 2FA。在 reset-credentials流本身上配置的额外认证器(例如在邮箱步骤之后的 OTP/WebAuthn,而非标准登录流上的)可能阻止已配置此类因素的账户被完全接管——但默认 Keycloak reset-credentials流不包含此类额外认证器。
| 产品 | 包 | 状态 | 修复版本 |
|---|---|---|---|
| RHBK 26.4 | rhbk/keycloak-operator-bundle (el9) |
受影响 | 26.4.15-1 |
| RHBK 26.4 | rhbk/keycloak-rhel9 (el9) |
受影响 | 26.4-23 |
| RHBK 26.4 | rhbk/keycloak-rhel9-operator (el9) |
受影响 | 26.4-23 |
| RHBK 26.4.15 | keycloak-services |
不受影响 | — |
| RHBK 26.4.15 | rhbk-openshift-rhel9 |
不受影响 | — |
| RHBK 26.6 | rhbk/keycloak-operator-bundle (el9) |
受影响 | 26.6.6-1 |
| RHBK 26.6 | rhbk/keycloak-rhel9 (el9) |
受影响 | 26.6-12 |
| RHBK 26.6 | rhbk/keycloak-rhel9-operator (el9) |
受影响 | 26.6-12 |
| RHBK 26.6.6 | keycloak-services |
不受影响 | — |
| RHBK 26.6.6 | rhbk-keycloak-rhel9 |
不受影响 | — |
| RHBK 26.6.6 | rhbk-openshift-rhel9 |
不受影响 | — |
RHBK errata:RHSA-2026:56519, RHSA-2026:56520, RHSA-2026:56523, RHSA-2026:56524。
| 发布分支 | 易受攻击版本 | 修复版本 |
|---|---|---|
| 26.0.x | 26.0.0 – 26.0.17 | 无(该分支无修复) |
| 26.1.x | 26.1.0 – 26.1.5 | 无 |
| 26.2.x | 26.2.0 – 26.2.16 | 无 |
| 26.3.x | 26.3.0 – 26.3.5 | 无 |
| 26.4.x | 26.4.0 – 26.4.14 | 26.4.15 (RHBK 后置标签;不在 public Quay 上) |
| 26.5.x | 26.5.0 – 26.5.7 | 无 |
| 26.6.x | 26.6.0 – 26.6.5 | 26.6.6 (RHBK 后置标签;不在 public Quay 上) |
| 26.7.x | 26.7.0 – 26.7.1 | 26.7.2 |
main (PR 合并前) |
在 [#51844] 合并前 | 由 PR [#51844] 修复 |
重要:Public Quay 容器镜像仅携带社区分支。标签 26.7.2已发布;26.4.15和 26.6.6是RHBK 特有的后置标签,不在 public Quay 上可用。26.4.x 或 26.6.x 社区用户必须自己从相应的 RHBK git 标签构建,或者升级到 26.7.2。
不受影响:
- Red Hat JBoss Enterprise Application Platform Expansion Pack(
keycloak-services) - Red Hat Single Sign-On 7(
keycloak-services) - 所有 realm 上都禁用了“Forgot password”的实例 (包括
master)。
Keycloak 中没有专门的“邮箱令牌被跳过”事件,并且 EXECUTE_ACTION_TOKEN不是正常邮箱点击的可靠成功标记。检测依赖于启发式分析。
可用的指纹是相同的 code_id:
SEND_RESET_PASSWORD后快速跟随UPDATE_PASSWORD
在实验室测试中,该绕过可以在两个事件之间不到 1 秒的时间内产生此序列。
仅启发式:
- 已经打开了重置邮件的用户可以足够快地行动,从而产生类似的模式。
- 如果日志记录/保留已关闭,缺失的事件日志条目无法证明任何事情。
- 这是一个基于时间的信号,而不是确定的证据。
社区检测脚本(用于 Admin Events):
thomasdelorge/cve-2026-18963-hunt.pykyos-public/keycloak-cve-2026-18963-hunt
来自 gist 的使用示例:
python3 cve-2026-18963-hunt.py --base https://keycloak.example --since 30d
需要 Direct Access Grants+ view-events。如果任何配对低于 --threshold-ms(默认 5000),则退出码为 1。
为了更高的置信度,在相同时间窗口检查入站/反向代理访问日志:
合法重置流(预期):
- 向
.../login-actions/reset-credentials发送POST(发起重置) GET /login-actions/action-token?...(受害者点击邮箱验证链接——这是邮箱令牌消费)- 完成密码表单的
POST
绕过流(要查找的模式):
- 向
.../login-actions/reset-credentials发送带有tryAnotherWay=on的POST(预置选择器屏幕已显示标志) - 在相同重置会话上用
username=...发送第二个POST(提交密码重置操作) - 中间没有
GET /login-actions/action-token(邮箱链接从未被点击) - 完成密码表单的最终
POST
更强的检测信号是两个 POST请求之间的 GET /login-actions/action-token缺失。在合法重置中,此 GET 总是存在(邮箱链接点击)。绕过不会产生它。
关于 tryAnotherWay的注意:利用中使用了 tryAnotherWay=on参数,但它也出现在正常的浏览器登录流中(MFA、passkeys 等),因此全局搜索它会产生噪声。中间缺少 GET 的模式是更可靠的信号。
- 涉及特权或高价值账户的意外密码更改。
- 在意外密码重置后,立即从新设备或新地理位置进行身份验证。
- 在密码重置后,意外的MFA 重新注册或账户安全设置的更改。
- 从单个 IP 地址或客户端标识符对多个账户进行的大量重置尝试。
在所有 realm 上禁用“Forgot password”。
在 Keycloak 管理控制台中:
- 导航到 Realm settings→ Login→ Forgot password→ Off
- 将此设置应用到所有 realm,包括
master
对于使用 kcadm.sh的环境:
# 临时禁用内置的重置凭据流# 将 REALM 替换为目标 realm 名称
kcadm.sh update realms/REALM -s resetPasswordAllowed=false
这被多个社区参与者确认对防止利用有效。
升级到已修复的版本:
| 如果您正在使用 | 升级到 |
|---|---|
| 社区 Keycloak 26.0 – 26.3 | 26.7.2 或更高(这些分支无后置版本可用) |
| 社区 Keycloak 26.4.x | 26.4.15(RHBK 后置)或 26.7.2+ |
| 社区 Keycloak 26.5.x | 26.7.2 或更高 |
| 社区 Keycloak 26.6.x | 26.6.6(RHBK 后置)或 26.7.2+ |
| 社区 Keycloak 26.7.0 / 26.7.1 | 26.7.2 |
| RHBK 26.4 | 26.4.15-1 / 26.4-23(通过 Red Hat errata) |
| RHBK 26.6 | 26.6.6-1 / 26.6-12(通过 Red Hat errata) |
RHBK 订阅者通过标准 Red Hat errata 通道接收修复:
- RHSA-2026:56519
- RHSA-2026:56520
- RHSA-2026:56523
-
RHSA-2026:56524
-
在
reset-credentials流本身上添加额外认证器(例如在邮箱步骤之后的 OTP/WebAuthn,而不是在标准登录流上)可以阻止已配置此类因素的账户被完全接管——但这不会关闭邮箱绕过本身,且默认情况下不存在。 - 确保 Admin Events 日志记录已启用并保留以用于取证目的。
- 修补后,如果无法排除泄露的可能性,为高价值账户强制密码重置并撤销活跃会话。
| 日期 | 事件 |
|---|---|
| 2026-07-31 | James Parémain 报告给 Red Hat |
| 2026-08-05 | CVE-2026-18963 保留 |
| 2026-08-17 | 公开 |
| 2026-08-18 | NVD 发布;GitHub 安全通告 GHSA-4gv3-mc9p-5wqc 创建(未审核) |
| 2026-08-19 | GitHub 问题 [#51833];社区讨论开始;PR [#51844] 在 main上打开 |
| 2026-08-19 | Red Hat Bugzilla RHBZ[#2511595] |
| 2026-08-20 | Red Hat 最后修改;CISA ADP Vulnrichment 记录 |
| 2026-08-24 | Kudelski Security 通告发布 |
| 2026-08-26 | 关于访问日志取证的最新社区讨论 |
- CVE(NVD): CVE-2026-18963
- Red Hat CVE 页面: CVE-2026-18963
- Red Hat Bugzilla: RHBZ#2511595
- Red Hat errata: RHSA-2026:56519, RHSA-2026:56520, RHSA-2026:56523, RHSA-2026:56524
- GitHub 问题: keycloak/keycloak#51833
- GitHub PR(修复): [^51844](https://github.com/keycloak/keycloak/pull/51844)
- GitHub 安全通告(未审核): GHSA-4gv3-mc9p-5wqc
- Keycloak 26.7.2 发布说明: https://www.keycloak.org/2026/08/keycloak-2672-released
- 社区检测脚本:
- thomasdelorge/cve-2026-18963-hunt.py
- kyos-public/keycloak-cve-2026-18963-hunt
- CISA SSVC Vulnrichment: 利用情况:无 · 可自动化:是 · 技术影响:完全
免责声明:此分析基于公开可用来源(CVE 记录、Red Hat CVE 页面、Bugzilla、GitHub 问题 [#51833]、PR [#51844]、Kudelski Security 通告、社区检测脚本)以及 Keycloak 26.0.0 源码的静态分析。