
Modelo diferencial offline da confusão de algoritmo HMAC na concessão de JWT do Keycloak (CVE-2026-11800), educacional
Modelo diferencial offline do CVE-2026-11800 (GHSA-j97h-3f8r-mrjr):
validadores de JWT do Keycloak baseados na chave pública de um IdP aceitavam valores
de alg simétricos (HMAC), permitindo confusão de algoritmo RS256→HS256. Corrigido na
26.6.4. Educacional, offline, determinístico.
Espanhol: README.es.md. Exercícios: PRACTICE.md.
Antes da correção, o Keycloak aceitava assinaturas HMAC que usavam a chave pública
configurada do IdP como segredo. Com uma chave pública codificada no código,
o HardcodedPublicKeyLoader tratava algoritmos HS* carregando
KeyUtils.loadSecretKey(Base64Url.decode(encodedKey)) (linha 206 do diff removida).
O valor configurado é normalmente PemUtils.encodeKey(publicKey), ou seja,
base64 do DER SubjectPublicKeyInfo sem cabeçalhos PEM, portanto o segredo HMAC
era exatamente os bytes DER de uma chave que é pública por design. Qualquer pessoa
que conheça a chave pública pode assinar uma asserção HS256 que é verificada. O
validador não o impedia: antes da correção ele apenas verificava um alg nulo
ou uma incompatibilidade com um algoritmo explicitamente esperado.
A correção (linhas 64-96 do diff) faz validateSignatureAlgorithm rejeitar
none (sem distinção de maiúsculas/minúsculas) e, a menos que isSymmetricAlgorithmAllowed(),
exigir um ClientSignatureVerifierProvider assimétrico para o alg do cabeçalho.
Também remove o ramo HMAC do loader. Apenas
JWTClientSecretValidator (segredo de cliente compartilhado) mantém algoritmos
simétricos.
| Caso | pré (32cdceb8) | pós (6d61885f / 8970032a) |
|---|---|---|
p01 HS256, HMAC sobre o DER | ACCEPT | REJECT |
p02 HS512, HMAC sobre o DER | ACCEPT | REJECT |
n06 HS256 com chave a partir do texto PEM | BAD_SIGNATURE | REJECT |
n01 RS256 | PROCEEDS_TO_SIGNATURE_CHECK | igual |
d01 alg=none (defesa em profundidade) | VALIDATOR_PASS_DOWNSTREAM_UNMODELED | REJECT |
Os positivos são apenas HS256/HS512. O HS256 é respaldado pelos testes upstream
testHS256AlgorithmConfusion* no diff da correção (linhas 253, 263-277, 279,
321, 351, 399, 408-421, 424); eles assinam com
getPublicKey().getEncoded() (DER) e esperam "Invalid signature
algorithm". O HS512 decorre da alteração do validador (linhas 85-89); nenhum
teste upstream o aborda especificamente.
alg=none não é um positivo: antes da correção o validador o deixa passar,
mas se o restante do caminho de concessão o rejeita não é modelado. Ele permanece
como um caso de defesa em profundidade. 22 casos: 2 positivos, 7 negativos, 1 de defesa em
profundidade e 12 adversariais.
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
Veja LIMITATIONS.md e SOURCES.md. Licença: Apache-2.0.