Keycloak reset-credentials 우회(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 | ⚪ 판정 불가 | 인식할 수 없는 응답 — 이를 통과로 해석하지 마십시오 |
렐름별로 실행하십시오 — 비밀번호 찾기는 렐름별 설정이며, master도 포함됩니다.
자세한 내용과 이 검사에 사용자가 필요 없고 아무것도 건드리지 않는 이유는
§4a에 있습니다.
이미 노출되었다는 것을 알고 있습니까? 교정 및 탐지 / 위협 헌팅으로 이동하십시오.
이 저장소에는 취약한 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/)과 함께 제공되므로, 버그가 어떻게 동작하는지 배우기 위해 외부의 어떤 것도 건드릴 필요가 없습니다. 승인 없이 제3자 인프라를 대상으로 지정하는 것은 대부분의 관할 구역에서 불법이며, 이 프로젝트가 지원하는 바가 아닙니다.
참조: 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:입니다 — Send Reset Email이 발동하면 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()에 도달하는 것 자체가 메일박스 제어를 증명하는 것과 동등하게 취급됩니다.
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
인증 없이, 어느 시점에도 authenticationExecution 파라미터 없이 수행되는 여섯 개의 HTTP 요청.
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에 의해 26.0.0에서 도입되었으며, 이 커밋은
리셋 흐름에 "Try another way" 인증자 선택 화면을 추가했다. 그보다 오래된 것은
단순히 해당 코드 경로가 없다. 여기에는 구형 WildFly 기반 배포판과 RH-SSO 7.x가
포함되며, 이들은 이 버그에는 영향을 받지 않지만 여전히 수명 종료 상태이고
다른 많은 취약점에 노출되어 있다. 레거시 빌드에 머무는 것은 해결책이 아니다.26.7.2는 커뮤니티 트레인에 공개된 유일한
수정 릴리스다. 배포가 26.0 – 26.6에 머물러 있다면 해당 라인에는 패치 릴리스가
없다 — 수정에는 포인트 릴리스가 아닌 마이너 버전 업그레이드가 필요하다.
26.4.15 / 26.6.6 태그는 벤더 백포트이며 커뮤니티 이미지와 호환되지 않는다.전제 조건: 해당 realm에서 Forgot password가 활성화되어 있고 그리고 바인딩된
reset-credentials 흐름이 내장 reset-credential-email 인증자를 사용해야 한다.
이 저장소는 동일한 realm을 임포트하는 취약한 Keycloak과 패치된 Keycloak을 모두 제공하며, 리셋 메일을 캡처하기 위한 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