Ce que dit l'avis, et ce qu'il ne dit pas
La CVE-2026-117691, référencée par l'avis GitHub GHSA-c85j-3hq2-q6wj, touche la liaison SAML HTTP-Redirect de Keycloak. Le serveur décode les noms de paramètres encodés en pourcentage, par exemple %53AMLResponse, alors que la vérification de signature ne reconnaît que les noms littéraux. L'attaquant envoie d'abord un message non signé sous le nom encodé, puis un message légitimement signé. La signature contrôle le second, le serveur traite le premier.
Red Hat en tire la conséquence la plus grave : la prise de contrôle de n'importe quel compte fédéré. L'avis est daté du 5 novembre 2026. Le score CVSS 3.1 est de 9.1, avec un vecteur réseau, sans privilège ni interaction, et la faiblesse est classée CWE-347, vérification cryptographique de signature défaillante.
Red Hat ajoute un prérequis : l'attaquant doit posséder un compte chez le fournisseur d'identité externe, pour obtenir un message de redirection réellement signé, par exemple une réponse de déconnexion. L'avis GitHub, lui, ne liste ni versions touchées ni contournement. Le reste de ce guide sépare donc ce qui est établi de ce qui est déduit.
Qui est exposé
- Keycloak courtier d'identité SAML — le ticket du projet (keycloak#54714) parle de « broker login as any user ». Le cas décrit est un realm qui fédère un fournisseur d'identité SAML externe : client d'entreprise, partenaire, annuaire tiers. C'est le scénario à traiter en priorité.
- Un compte chez le fournisseur externe — l'attaque réutilise un message signé, donc un compte, même sans privilège, chez ce fournisseur. Plus l'inscription y est ouverte, plus l'exposition est large.
- OIDC seul — les sources lues ne décrivent que la liaison SAML HTTP-Redirect et ne parlent pas d'OIDC. Un realm sans fournisseur SAML sort du scénario décrit, mais cela ne dispense pas de monter de version : les notes de la 26.8.2 annoncent 33 correctifs de sécurité.
- Keycloak fournisseur SAML de vos applications — aucune source ne dit si les clients SAML sont concernés. Les notes de la 26.8.2 listent d'autres correctifs SAML. Ne concluez pas à l'absence de risque : mettez à jour.
- Red Hat build of Keycloak — la base NVD marque la branche 26.6 touchée avant 26.6.9. Red Hat Single Sign-On 7 est donné comme non affecté par Red Hat.
- Exploitation observée — au 18 novembre 2026, la CVE ne figure pas au catalogue CISA des vulnérabilités exploitées, et son score EPSS est inférieur à 1 %. Ce n'est pas un délai de grâce : le score de gravité reste de 9.1.
Quelle version installer : ce que les sources se disent
Pour le projet communautaire, le correctif est dans la 26.8.2, publiée le 5 novembre 2026. Dans le fil keycloak#54714, des utilisateurs demandent quelles versions plus anciennes sont touchées. La seule réponse est un renvoi aux étiquettes release/26.6.9 et release/26.4.18 du dépôt. Pourquoi pas la 26.7 : la question est posée le 9 novembre 2026, sans réponse d'un mainteneur dans le fil.
Les sources ne concordent pas tout à fait. Red Hat publie la 26.6.9 de Red Hat build of Keycloak le 7 novembre 2026, avec l'avis RHSA-2026:96040. Mais pour le projet communautaire, les listes de releases GitHub et de tags d'images quay.io ne montrent, le 18 novembre 2026, ni 26.6.9 ni 26.4.18 : la dernière 26.6 publiée est la 26.6.4, la dernière 26.7 est la 26.7.5.
Conséquence pratique. Avec l'image communautaire, visez la 26.8.2. Avec Red Hat build of Keycloak, la 26.6.9 ou, d'après le suivi du projet, la 26.4.18 : confirmez auprès de votre fournisseur. Sur la 26.7, aucun correctif n'est annoncé : considérez-la touchée. Avant la 26.4, l'avis n'établit rien, et nous n'en concluons rien : aucune version corrigée n'y est annoncée, ce qui est une raison de plus de migrer.
Branches Keycloak face à la CVE-2026-117691
Faites défiler le tableau
| Branche | Situation face à la CVE | Version corrigée |
|---|---|---|
| 26.8 (communauté) | Non corrigée avant la 26.8.2 | 26.8.2, publiée le 5 novembre 2026 |
| 26.7 (communauté) | Dernière publiée : 26.7.5, sans correctif ni rétroportage annoncé | Passer à la 26.8.2 |
| 26.6 (communauté) | Dernière publiée : 26.6.4, sans correctif | Passer à la 26.8.2 |
| 26.6 (Red Hat build of Keycloak) | Touchée avant la 26.6.9 selon la base NVD | 26.6.9, avis RHSA-2026:96040 |
| 26.4 | Rétroportage annoncé par le suivi du projet, pas d'avis lu | 26.4.18 selon le suivi : à confirmer |
| Avant 26.4 | Non établi par l'avis | Aucune annoncée : migrer vers la 26.8.2 |
| Red Hat Single Sign-On 7 | Non affecté, selon Red Hat | Sans objet |
Lire la version réellement déployée
Relevez ce qui tourne avant de changer quoi que ce soit, par deux voies qui se recoupent.
Console d'administration : connectez-vous au realm master, ouvrez le tableau de bord puis l'onglet Server Info, qui décrit le serveur et ses fonctionnalités actives. Ligne de commande : l'option -V ou --version de kc.sh affiche la version. Sous Docker, la commande est docker compose exec keycloak /opt/keycloak/bin/kc.sh --version, en adaptant le nom du service.
Le tag du fichier Compose dit ce que vous avez demandé, pas forcément ce qui tourne : un tag flottant comme 26.8 change à chaque docker compose pull. Et si votre image est construite avec kc.sh build, c'est la version de l'image construite qui compte. Relevez enfin, dans chaque realm, la liste des fournisseurs d'identité SAML (menu Identity providers) : elle dit si vous êtes dans le scénario décrit.
Mettre à jour Keycloak sous Docker Compose
Noter la version et l'état actuels
Lancez
docker compose exec keycloak /opt/keycloak/bin/kc.sh --version, puis notez les realms, les fournisseurs d'identité SAML et les clients qui servent vos clients. Cette liste sert de grille de test à la fin.Sauvegarder la base et la configuration
Sauvegardez la base avec l'outil de votre moteur, par exemple
docker compose exec -T postgres pg_dump -U keycloak keycloak > keycloak-avant-maj.sql, en adaptant service, utilisateur et base. Copiez aussi le fichier Compose,conf/, les thèmes etproviders/. Le guide de mise à jour demande de sauvegarder la base et l'ancienne installation.Lire les changements de migration
Le guide de mise à jour liste les changements version par version. Lisez tous ceux qui séparent votre version de la cible, pas seulement le dernier : la section 26.8 modifie le contrôle d'accès de l'API d'administration et le traitement des assertions SAML.
Changer le tag de l'image
Dans le fichier Compose, passez à
image: quay.io/keycloak/keycloak:26.8.2: un tag exact, jamaislatest. Image personnalisée : changez la ligneFROMdu Dockerfile puis lancezdocker compose build --pull. Image officielle :docker compose pull keycloak.Arrêter l'ancienne version
Lancez
docker compose stop keycloak. Les mises à jour progressives ne sont documentées que pour les versions correctives, depuis la 26.6.0 ; pour un changement de version mineure, arrêtez tous les nœuds avant de migrer la base.Démarrer et laisser la base migrer
Lancez
docker compose up -d keycloakpuisdocker compose logs -f keycloak. La base migre seule au premier démarrage. Le délai par défaut est de 30 minutes ; pour une grosse base, ajoutez--transaction-setup-timeout=60mà la commande de démarrage. Au-delà de 300000 enregistrements, certains index sont créés en arrière-plan après le démarrage.Retester thèmes, fournisseurs et connexions
Comparez vos gabarits de thème personnalisés à ceux de la nouvelle version, puis rejouez la grille notée à l'étape 1 : une connexion par fournisseur SAML, une déconnexion, un client d'API d'administration, un compte fédéré existant.
Brancher la veille et la supervision
Ajoutez l'URL de connexion de Keycloak à une sonde de disponibilité, par exemple le template Uptime Kuma du catalogue sur le même VPS, et suivez le blog de keycloak.org pour la prochaine version corrective. Un SSO se met à jour au rythme de ses avis, pas au rythme de vos projets.
Une sauvegarde qui se restaure
Après la migration, le schéma de base n'est plus compatible avec l'ancien serveur, et Keycloak ne sait pas défaire la migration. Pour revenir en arrière, il faut restaurer l'ancienne installation, puis la base depuis la sauvegarde. Restaurez-la une fois sur une base de test avant de monter en production : une sauvegarde jamais restaurée n'est qu'une hypothèse.
Si la mise à jour doit attendre quelques jours
Soyons nets : il n'existe pas de contournement officiel. Red Hat indique qu'aucune mesure ne répond à ses critères de facilité, de déploiement et de stabilité, et l'avis GitHub n'en liste aucune. Les pistes ci-dessous réduisent l'exposition, elles ne corrigent rien. Elles servent à tenir quelques jours, pas à repousser la montée de version.
Réduire l'exposition en attendant
- Restreindre l'inscription chez le fournisseur externe — l'attaque suppose un compte chez lui. Auditer ses comptes et limiter les nouvelles inscriptions réduit la surface. Cette piste figure dans une note de Red Hat du 6 novembre 2026 marquée comme générée par IA, et elle précise qu'elle ne corrige pas la faille.
- Désactiver le fournisseur SAML concerné — dans Identity providers, l'interrupteur d'activation coupe les connexions par ce fournisseur. C'est notre déduction, pas une consigne des avis : testez-la sur un realm de recette, et mesurez l'impact pour les utilisateurs de ce client.
- Ne pas compter sur « HTTP-POST Binding Response » — d'après la documentation, ce réglage choisit la liaison utilisée par Keycloak pour répondre aux requêtes du fournisseur externe. Rien n'indique qu'il empêche d'accepter un message en redirection.
- Ne pas promettre un filtre nginx — on peut chercher les requêtes dont un nom de paramètre est encodé, mais aucune source ne valide une règle de blocage complète, et l'encodage peut toucher n'importe quel caractère du nom. Utilisez le reverse proxy pour détecter, pas pour vous croire protégé.
- Fixer la date de la montée — une fenêtre de maintenance datée, la sauvegarde faite et testée, un responsable nommé. Le risque d'un SSO non corrigé se mesure en jours.
- Prévenir vos clients concernés — si vous opérez leur SSO, dites quelle faille, quelle version, quelle date de montée. Sans ajouter de détail d'exploitation.
Vérifier la correction, puis chercher des traces
Vérifier : relisez la version dans Server Info et avec kc.sh --version, elle doit afficher 26.8.2 pour l'image communautaire. Puis rejouez vos tests fonctionnels : connexion par chaque fournisseur SAML, déconnexion. Ne tentez pas de rejouer l'attaque sur la production : un message forgé sur un système réel est une tentative d'usurpation. Si une preuve est exigée, montez un realm de recette isolé avec des comptes de test.
Chercher des traces : l'attaque passe par une requête GET dont un nom de paramètre est encodé. Dans les journaux d'accès du reverse proxy, une recherche comme zgrep -iE '[?&][a-z]*%[0-9a-f]{2}[a-z]*=' /var/log/nginx/access.log* repère les noms de paramètres contenant un caractère encodé. Un résultat est un indice, pas une preuve, et l'absence de résultat n'en est pas une non plus : journaux tournés, paramètres non journalisés, autre proxy en amont.
Côté Keycloak, les événements utilisateur ne sont pas conservés par défaut, seules les erreurs le sont. Activez Save events dans Realm settings, Events, pour garder l'historique à partir de maintenant, et relisez les connexions fédérées inhabituelles : heure, adresse IP, compte. Avant l'activation, rien n'a été enregistré : ce que vous ne trouvez pas peut simplement n'avoir jamais été écrit.
Dépannage après la montée de version
Le passage vers la 26.8 change plusieurs comportements, indiqués dans le guide de mise à jour. Voici ceux qui font le plus souvent croire à une panne. Le guide ne cite pas de message de démarrage : les symptômes ci-dessous sont ceux qu'il décrit.
Symptômes et remèdes, d'après le guide de mise à jour
- Erreurs 401 de l'API d'administration — les jetons doivent porter le nouveau scope
kc-admin-api. Les clients personnalisés et comptes de service doivent se le voir assigner ;admin-cliet la console sont mis à jour seuls. Pendant une montée progressive, des 401 temporaires sont possibles. - Connexion SAML qui ne passe plus — les assertions doivent porter une confirmation de sujet de type bearer, et les conditions ProxyRestriction sont refusées par défaut. Côté adaptateur,
entityID="idp"doit être remplacé par l'URL du realm. - Liaison automatique de comptes refusée — elle exige maintenant une adresse e-mail vérifiée ou l'option Trust Email sur le fournisseur. Des utilisateurs fédérés qui se reliaient seuls peuvent soudain recevoir un écran de liaison.
- Base ou processeur plus sollicités — les échecs de connexion sont stockés en base par défaut, ce qui augmente les connexions et le CPU.
--features=login-failures:v1rétablit le stockage en mémoire. - Migration trop longue — le délai par défaut est de 30 minutes, réglable avec
--transaction-setup-timeout. Si l'arrêt a eu lieu en cours de migration, restaurez la base sauvegardée avant de relancer. - Utilisateurs déconnectés — avec
persistent-user-sessionsdésactivé, toutes les sessions sauf les sessions hors ligne sont perdues, et les parcours de connexion en cours sont à recommencer. Prévenez les utilisateurs avant la fenêtre de maintenance.
Documentation officielle
Les liens suivants sont les sources de ce guide, à relire avant d'agir.
Avis GitHub : https://github.com/advisories/GHSA-c85j-3hq2-q6wj
Notes de version 26.8.2 : https://www.keycloak.org/2026/11/keycloak-2682-released
Suivi du projet : https://github.com/keycloak/keycloak/issues/54714
Guide de mise à jour : https://www.keycloak.org/docs/latest/upgrading/index.html
Fiche Red Hat de la CVE : https://access.redhat.com/security/cve/CVE-2026-117691
Avis Red Hat 26.6.9 : https://access.redhat.com/errata/RHSA-2026:96040
Pour un SSO que vous opérez vous-même, la fiche Keycloak du catalogue ServOrbit propose un template VPS prêt à déployer, avec PostgreSQL et HTTPS, sur lequel la procédure ci-dessus s'applique telle quelle.
servorbit.com/ma-fr/blog/keycloak-cve-2026-117691-saml-contournement-signature-mettre-a-jour
