
Keycloak JWT grant HMAC 알고리즘 혼동(CVE-2026-11800)의 오프라인 차분 모델, 교육용
CVE-2026-11800(GHSA-j97h-3f8r-mrjr)의 오프라인 차분 모델:
IdP 공개 키를 기반으로 하는 Keycloak JWT 검증기가 대칭(HMAC) alg 값을
허용하여 RS256→HS256 알고리즘 혼동이 가능했던 문제입니다. 26.6.4에서
수정되었습니다. 교육용, 오프라인, 결정론적입니다.
스페인어: README.es.md. 연습: PRACTICE.md.
수정 전에는 Keycloak이 IdP에 구성된 공개 키를 비밀 값으로 사용하는
HMAC 서명을 허용했습니다. 공개 키가 하드코딩된 경우,
HardcodedPublicKeyLoader는 HS* 알고리즘을
KeyUtils.loadSecretKey(Base64Url.decode(encodedKey))를 로드하여
처리했습니다(삭제된 diff 206행). 구성 값은 일반적으로
PemUtils.encodeKey(publicKey), 즉 PEM 헤더가 없는 DER
SubjectPublicKeyInfo의 base64이므로, HMAC 비밀 값은 설계상 공개된 키의
DER 바이트 그 자체였습니다. 공개 키를 아는 사람은 누구나 검증을 통과하는
HS256 어설션에 서명할 수 있었습니다. 검증기는 이를 막지 못했습니다.
수정 전에는 alg가 null인 경우나 명시적으로 기대한 알고리즘과 불일치하는
경우만 확인했습니다.
수정(diff 64-96행)은 validateSignatureAlgorithm이 none(대소문자
구분 없이)을 거부하도록 하고, isSymmetricAlgorithmAllowed()가 아닌 한
헤더 alg에 대해 비대칭 ClientSignatureVerifierProvider를 요구하도록
합니다. 또한 로더에서 HMAC 분기를 제거합니다. 대칭 알고리즘은
JWTClientSecretValidator(공유 클라이언트 비밀)만 유지합니다.
| 사례 | 수정 전 (32cdceb8) | 수정 후 (6d61885f / 8970032a) |
|---|---|---|
p01 HS256, DER에 대한 HMAC | ACCEPT | REJECT |
p02 HS512, DER에 대한 HMAC | ACCEPT | REJECT |
n06 PEM 텍스트를 키로 사용한 HS256 | BAD_SIGNATURE | REJECT |
n01 RS256 | PROCEEDS_TO_SIGNATURE_CHECK | 동일 |
d01 alg=none (심층 방어) | VALIDATOR_PASS_DOWNSTREAM_UNMODELED | REJECT |
양성 사례는 HS256/HS512뿐입니다. HS256은 수정 diff의 업스트림 테스트
testHS256AlgorithmConfusion*(253, 263-277, 279, 321, 351, 399,
408-421, 424행)로 뒷받침됩니다. 이 테스트들은
getPublicKey().getEncoded()(DER)로 서명하고 "Invalid signature
algorithm"을 기대합니다. HS512는 검증기 변경(85-89행)에서 비롯되며,
이를 특정하여 대상으로 하는 업스트림 테스트는 없습니다.
alg=none은 양성 사례가 아닙니다. 수정 전에는 검증기가 이를 통과시키지만,
grant 경로의 나머지 부분이 이를 거부하는지는 모델링되지 않았습니다.
이는 심층 방어 사례로 남습니다. 총 22개 사례: 양성 2개, 음성 7개,
심층 방어 1개, 적대적 12개.
PYTHONPATH=src python -m unittest discover -s tests -v
python scripts/derive_expected.py | diff - fixtures/expected.tsv
python scripts/gen_results.py /tmp/r && diff -r results /tmp/r
LIMITATIONS.md 및 SOURCES.md를 참조하세요. 라이선스: Apache-2.0.