← 返回列表

CVE-2026-18963 技术分析:Keycloak-services 重置凭据流绕过漏洞

单站 securitainment 发布 Thu, 27 Aug 2026 10:24:00 +0800 入库 2026-11-18T16:54:04

原创 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)。

未经认证的远程攻击者只要知道目标用户名或邮箱地址,就可以强制密码重置并获得目标账户的完全控制权,而无需点击邮箱验证链接。

受影响范围:

报告者: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,就进入该分支。这种读取不检查该标记是不是属于当前执行模型。

综合来看,存在以下链条:

  1. 攻击者提交 tryAnotherWay,认证会话中写入 "true"(不绑定执行模型)。
  2. 在后续的流处理中,processFlow()读取该备注,Boolean.parseBoolean("true")为 true,于是进入“刷新选择器屏幕”的逻辑分支。
  3. 此逻辑分支依赖 CURRENT_AUTHENTICATION_EXECUTION备注来决定要重入哪个执行模型。如果攻击者能使该备注也指向他们想要的执行上下文,或者如果流处理恰好在一个允许绕过邮箱验证的执行模型上运行,漏洞就会出现。

重要细节:

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()方法:完全无保护
而 action()方法在 26.0.0 源码中仅有:

@Override
publicvoid action(AuthenticationFlowContext context) {
    context.getUser().setEmailVerified(true);
    context.success();
}

因此,仅靠 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失败。这要求请求必须是通过合法的操作令牌触发的。

攻击者要利用此漏洞,需要满足以下条件:

  1. 目标 Keycloak 实例运行易受攻击版本 (26.0.0 – 26.7.1,或对应的 RHBK 版本),并且
  2. “Forgot password”功能在目标 realm 上启用 (默认启用),这样 reset-credentials流才可触发,且其中包含 reset-credential-email执行器。
  3. 攻击者知道目标用户名 (或邮箱),以便发起重置。
  4. 攻击者能够提交 tryAnotherWay 以设置 AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED = "true"。
  5. 攻击者能够提交 action()调用 ,直接命中 ResetCredentialEmail.action(),此时:
  6. 认证会话中存在未绑定模型的 "true"标记(由步骤 4 产生);
  7. action() 不检查操作令牌,无条件成功;
  8. 攻击者绕过邮箱验证,直接进入密码设置阶段。

  9. 发起重置请求 :攻击者向 reset-credentials流发起密码重置请求,指定目标用户名。此时 Keycloak 调用 ResetCredentialEmail.authenticate()(若未检测到操作令牌,则发送重置邮件给目标用户邮箱)。攻击者无需接收此邮件。

  10. 预置状态标记 :攻击者提交带有 tryAnotherWay=on的请求到重置流。processAction()检测到该输入,将认证会话备注 AUTHENTICATION_SELECTOR_SCREEN_DISPLAYED设置为 "true"(不绑定模型)。
  11. 提交操作 :攻击者提交直接命中 ResetCredentialEmail.action()的请求。因为:
  12. action() 不检查 ACTION_TOKEN_USER_ID;
  13. 它直接调用 context.getUser().setEmailVerified(true)并 context.success();
  14. 认证会话中存在未绑定模型的 "true"标记,可能被后续流逻辑识别为合法状态;

攻击者绕过了邮箱验证步骤,直接进入密码设置阶段。

  1. 设置新密码 :攻击者在 UPDATE_PASSWORD步骤设置新密码。成功后获得目标账户的完全控制权,包括移除现有 MFA(因为重置流按设计跳过 2FA)。

利用此漏洞不需要任何有效的 Keycloak 身份验证凭据。攻击者从外部即可发起重置请求。

受害者不会接收到攻击者利用所需的任何交互;攻击者也不需要访问受害者邮箱。重置邮件确实会发送给受害者(这是 authenticate()中的行为),但攻击者绕过了点击该邮件链接的步骤。

一旦攻击者知道目标用户名(或邮箱),利用就变得可行。用户名枚举可能通过多种途径获得(目录枚举、泄露邮箱列表、AD/LDAP 用户枚举等)。

攻击者可以通过网络远程提交请求,无需本地访问或特殊网络位置。

密码重置流按设计跳过 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。

不受影响:

Keycloak 中没有专门的“邮箱令牌被跳过”事件,并且 EXECUTE_ACTION_TOKEN不是正常邮箱点击的可靠成功标记。检测依赖于启发式分析。

可用的指纹是相同的 code_id:

在实验室测试中,该绕过可以在两个事件之间不到 1 秒的时间内产生此序列。

仅启发式:

社区检测脚本(用于 Admin Events):

来自 gist 的使用示例:

python3 cve-2026-18963-hunt.py --base https://keycloak.example --since 30d
需要 Direct Access Grants+ view-events。如果任何配对低于 --threshold-ms(默认 5000),则退出码为 1。

为了更高的置信度,在相同时间窗口检查入站/反向代理访问日志:

合法重置流(预期):

  1. 向 .../login-actions/reset-credentials发送 POST(发起重置)
  2. GET /login-actions/action-token?... (受害者点击邮箱验证链接——这是邮箱令牌消费)
  3. 完成密码表单的 POST

绕过流(要查找的模式):

  1. 向 .../login-actions/reset-credentials发送带有 tryAnotherWay=on的 POST(预置选择器屏幕已显示标志)
  2. 在相同重置会话上用 username=...发送第二个 POST(提交密码重置操作)
  3. 中间没有 GET /login-actions/action-token (邮箱链接从未被点击)
  4. 完成密码表单的最终 POST

更强的检测信号是两个 POST请求之间的 GET /login-actions/action-token缺失。在合法重置中,此 GET 总是存在(邮箱链接点击)。绕过不会产生它。

关于 tryAnotherWay的注意:利用中使用了 tryAnotherWay=on参数,但它也出现在正常的浏览器登录流中(MFA、passkeys 等),因此全局搜索它会产生噪声。中间缺少 GET 的模式是更可靠的信号。

在所有 realm 上禁用“Forgot password”。

在 Keycloak 管理控制台中:

对于使用 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 通道接收修复:

日期 事件
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 记录、Red Hat CVE 页面、Bugzilla、GitHub 问题 [#51833]、PR [#51844]、Kudelski Security 通告、社区检测脚本)以及 Keycloak 26.0.0 源码的静态分析。

原文链接:https://mp.weixin.qq.com/s?__biz=MzAxODM5ODQzNQ==&mid=2247497056&idx=1&sn=a3701ab74afc51efa148feb2c6b6717f