Seguridad y monitorización

Keycloak CVE-2026-117691: firma SAML eludida, qué hacer

El 5 de noviembre de 2026, Keycloak publicó la versión 26.8.2 junto con el aviso de la CVE-2026-117691: la verificación de firma de la vinculación SAML redirect se elude con un nombre de parámetro codificado en porcentaje, y se puede suplantar una cuenta federada. La puntuación es de 9.1 sobre 10. Para una agencia que opera el SSO de sus clientes, lo importante es saber si la instancia está afectada, qué versión elegir y cómo subir sin romper los inicios de sesión. Esta guía sigue las fuentes primarias y dice lo que no dicen.

Desplegar en un VPS Cloud →
11 min de lectura8 pasos

Orbi agente IAEl índice sigue al artículo; los artículos relacionados le esperan al final.

Contenido· Qué dice el aviso, y qué no dice1/13
  1. 01Qué dice el aviso, y qué no dice
  2. 02Quién está expuesto
  3. 03Qué versión instalar: lo que se dicen las fuentes
  4. 04Ramas de Keycloak frente a la CVE-2026-117691
  5. 05Leer la versión realmente desplegada
  6. 06Actualizar Keycloak con Docker Compose
  7. 07Una copia de seguridad que se restaura
  8. 08Si la actualización debe esperar unos días
  9. 09Reducir la exposición mientras tanto
  10. 10Verificar la corrección y buscar rastros
  11. 11Solución de problemas tras subir de versión
  12. 12Síntomas y remedios, según la guía de actualización
  13. 13Documentación oficial

Qué dice el aviso, y qué no dice

La CVE-2026-117691, recogida en el aviso de GitHub GHSA-c85j-3hq2-q6wj, afecta a la vinculación SAML HTTP-Redirect de Keycloak. El servidor decodifica los nombres de parámetros codificados en porcentaje, por ejemplo %53AMLResponse, mientras que la verificación de firma solo reconoce los nombres literales. El atacante envía primero un mensaje sin firmar bajo el nombre codificado y después un mensaje legítimamente firmado. La firma controla el segundo, el servidor procesa el primero.

Red Hat extrae la consecuencia más grave: la toma de control de cualquier cuenta federada. El aviso está fechado el 5 de noviembre de 2026. La puntuación CVSS 3.1 es de 9.1, con vector de red, sin privilegios ni interacción, y la debilidad se clasifica como CWE-347, verificación criptográfica de firma defectuosa.

Red Hat añade un requisito: el atacante debe tener una cuenta en el proveedor de identidad externo, para obtener un mensaje de redirección realmente firmado, por ejemplo una respuesta de cierre de sesión. El aviso de GitHub, por su parte, no lista versiones afectadas ni solución temporal. El resto de esta guía separa, por tanto, lo establecido de lo deducido.

Quién está expuesto

  • Keycloak como intermediario de identidad SAML — el ticket del proyecto (keycloak#54714) habla de «broker login as any user». El caso descrito es un realm que federa un proveedor de identidad SAML externo: cliente corporativo, socio, directorio de terceros. Es el escenario que hay que tratar primero.
  • Una cuenta en el proveedor externo — el ataque reutiliza un mensaje firmado, y por tanto una cuenta, aunque sea sin privilegios, en ese proveedor. Cuanto más abierto sea su registro, mayor la exposición.
  • Solo OIDC — las fuentes leídas describen únicamente la vinculación SAML HTTP-Redirect y no mencionan OIDC. Un realm sin proveedor SAML queda fuera del escenario descrito, pero eso no exime de actualizar: las notas de la 26.8.2 anuncian 33 correcciones de seguridad.
  • Keycloak como proveedor SAML de sus aplicaciones — ninguna fuente dice si los clientes SAML están afectados. Las notas de la 26.8.2 listan otras correcciones SAML. No concluya que no hay riesgo: actualice.
  • Red Hat build of Keycloak — la base NVD marca la rama 26.6 como afectada antes de la 26.6.9. Red Hat Single Sign-On 7 figura como no afectado según Red Hat.
  • Explotación observada — a 18 de noviembre de 2026, la CVE no figura en el catálogo de la CISA de vulnerabilidades explotadas, y su puntuación EPSS es inferior al 1 %. No es un plazo de gracia: la puntuación de gravedad sigue siendo 9.1.

Qué versión instalar: lo que se dicen las fuentes

Para el proyecto comunitario, la corrección está en la 26.8.2, publicada el 5 de noviembre de 2026. En el hilo keycloak#54714, usuarios preguntan qué versiones anteriores están afectadas. La única respuesta es una remisión a las etiquetas release/26.6.9 y release/26.4.18 del repositorio. Por qué no la 26.7: la pregunta se hizo el 9 de noviembre de 2026, sin respuesta de un mantenedor en el hilo.

Las fuentes no concuerdan del todo. Red Hat publica la 26.6.9 de Red Hat build of Keycloak el 7 de noviembre de 2026, con el aviso RHSA-2026:96040. Pero para el proyecto comunitario, las listas de releases de GitHub y de etiquetas de imágenes de quay.io no muestran, el 18 de noviembre de 2026, ni la 26.6.9 ni la 26.4.18: la última 26.6 publicada es la 26.6.4 y la última 26.7 es la 26.7.5.

Consecuencia práctica. Con la imagen comunitaria, apunte a la 26.8.2. Con Red Hat build of Keycloak, la 26.6.9 o, según el seguimiento del proyecto, la 26.4.18: confírmelo con su proveedor. En la 26.7 no se anuncia ninguna corrección: considérela afectada. Antes de la 26.4, el aviso no establece nada y no concluimos nada: no se anuncia ninguna versión corregida, una razón más para migrar.

Ramas de Keycloak frente a la CVE-2026-117691

Desplace la tabla

RamaSituación frente a la CVEVersión corregida
26.8 (comunidad)No corregida antes de la 26.8.226.8.2, publicada el 5 de noviembre de 2026
26.7 (comunidad)Última publicada: 26.7.5, sin corrección ni retroportación anunciadaPasar a la 26.8.2
26.6 (comunidad)Última publicada: 26.6.4, sin correcciónPasar a la 26.8.2
26.6 (Red Hat build of Keycloak)Afectada antes de la 26.6.9 según la base NVD26.6.9, aviso RHSA-2026:96040
26.4Retroportación anunciada por el seguimiento del proyecto, sin aviso leído26.4.18 según el seguimiento: por confirmar
Antes de 26.4No establecido por el avisoNinguna anunciada: migrar a la 26.8.2
Red Hat Single Sign-On 7No afectado, según Red HatNo aplica

Leer la versión realmente desplegada

Anote lo que está en marcha antes de cambiar nada, por dos vías que se contrastan.

Consola de administración: entre en el realm master, abra el panel y después la pestaña Server Info, que describe el servidor y sus funciones activas. Línea de comandos: la opción -V o --version de kc.sh muestra la versión. Con Docker, el comando es docker compose exec keycloak /opt/keycloak/bin/kc.sh --version, adaptando el nombre del servicio.

La etiqueta del archivo Compose dice lo que usted pidió, no necesariamente lo que está en marcha: una etiqueta flotante como 26.8 cambia con cada docker compose pull. Y si su imagen se construye con kc.sh build, cuenta la versión de la imagen construida. Por último, anote en cada realm la lista de proveedores de identidad SAML (menú Identity providers): dice si está en el escenario descrito.

Actualizar Keycloak con Docker Compose

  1. Anotar la versión y el estado actuales

    Ejecute docker compose exec keycloak /opt/keycloak/bin/kc.sh --version, y anote los realms, los proveedores de identidad SAML y los clientes que sirven a sus clientes. Esa lista será la cuadrícula de pruebas al final.

  2. Respaldar la base de datos y la configuración

    Respalde la base con la herramienta de su motor, por ejemplo docker compose exec -T postgres pg_dump -U keycloak keycloak > keycloak-avant-maj.sql, adaptando servicio, usuario y base. Copie también el archivo Compose, conf/, los temas y providers/. La guía de actualización pide respaldar la base y la instalación anterior.

  3. Leer los cambios de migración

    La guía de actualización lista los cambios versión por versión. Lea todos los que separan su versión del destino, no solo el último: la sección 26.8 modifica el control de acceso de la API de administración y el tratamiento de las aserciones SAML.

  4. Cambiar la etiqueta de la imagen

    En el archivo Compose, pase a image: quay.io/keycloak/keycloak:26.8.2: una etiqueta exacta, nunca latest. Imagen personalizada: cambie la línea FROM del Dockerfile y ejecute docker compose build --pull. Imagen oficial: docker compose pull keycloak.

  5. Detener la versión anterior

    Ejecute docker compose stop keycloak. Las actualizaciones progresivas solo están documentadas para versiones correctivas, desde la 26.6.0; para un cambio de versión menor, detenga todos los nodos antes de migrar la base.

  6. Arrancar y dejar migrar la base

    Ejecute docker compose up -d keycloak y después docker compose logs -f keycloak. La base migra sola en el primer arranque. El plazo por defecto es de 30 minutos; para una base grande, añada --transaction-setup-timeout=60m al comando de arranque. Por encima de 300000 registros, algunos índices se crean en segundo plano tras el arranque.

  7. Volver a probar temas, proveedores y accesos

    Compare sus plantillas de tema personalizadas con las de la nueva versión y repita la cuadrícula anotada en el paso 1: un inicio de sesión por proveedor SAML, un cierre de sesión, un cliente de la API de administración, una cuenta federada existente.

  8. Conectar la vigilancia y la supervisión

    Añada la URL de acceso de Keycloak a una sonda de disponibilidad, por ejemplo la plantilla Uptime Kuma del catálogo en el mismo VPS, y siga el blog de keycloak.org para la próxima versión correctiva. Un SSO se actualiza al ritmo de sus avisos, no al de sus proyectos.

Una copia de seguridad que se restaura

Tras la migración, el esquema de la base ya no es compatible con el servidor anterior, y Keycloak no sabe deshacer la migración. Para volver atrás hay que restaurar la instalación anterior y después la base desde la copia. Restáurela una vez en una base de pruebas antes de subir a producción: una copia nunca restaurada es solo una hipótesis.

Si la actualización debe esperar unos días

Seamos claros: no existe una solución temporal oficial. Red Hat indica que ninguna medida cumple sus criterios de facilidad, despliegue y estabilidad, y el aviso de GitHub no lista ninguna. Las pistas siguientes reducen la exposición, no corrigen nada. Sirven para aguantar unos días, no para aplazar la actualización.

Reducir la exposición mientras tanto

  • Restringir el registro en el proveedor externo — el ataque supone una cuenta allí. Auditar sus cuentas y limitar los nuevos registros reduce la superficie. Esta pista figura en una nota de Red Hat del 6 de noviembre de 2026 marcada como generada por IA, y precisa que no corrige el fallo.
  • Desactivar el proveedor SAML afectado — en Identity providers, el interruptor de activación corta los inicios de sesión por ese proveedor. Es una deducción nuestra, no una consigna de los avisos: pruébela en un realm de pruebas y mida el impacto para los usuarios de ese cliente.
  • No contar con «HTTP-POST Binding Response» — según la documentación, este ajuste elige la vinculación que usa Keycloak para responder a las solicitudes del proveedor externo. Nada indica que impida aceptar un mensaje por redirección.
  • No prometer un filtro nginx — se pueden buscar las solicitudes con un nombre de parámetro codificado, pero ninguna fuente valida una regla de bloqueo completa, y la codificación puede afectar a cualquier carácter del nombre. Use el proxy inverso para detectar, no para sentirse protegido.
  • Fijar la fecha de la actualización — una ventana de mantenimiento fechada, la copia hecha y probada, un responsable designado. El riesgo de un SSO sin corregir se mide en días.
  • Avisar a los clientes afectados — si opera su SSO, diga qué fallo, qué versión y qué fecha de actualización. Sin añadir detalles de explotación.

Verificar la corrección y buscar rastros

Verificar: vuelva a leer la versión en Server Info y con kc.sh --version; debe mostrar 26.8.2 para la imagen comunitaria. Después repita sus pruebas funcionales: inicio de sesión por cada proveedor SAML, cierre de sesión. No intente repetir el ataque en producción: un mensaje falsificado en un sistema real es un intento de suplantación. Si se exige una prueba, monte un realm de pruebas aislado con cuentas de prueba.

Buscar rastros: el ataque pasa por una solicitud GET con un nombre de parámetro codificado. En los registros de acceso del proxy inverso, una búsqueda como zgrep -iE '[?&][a-z]*%[0-9a-f]{2}[a-z]*=' /var/log/nginx/access.log* encuentra los nombres de parámetros que contienen un carácter codificado. Un resultado es un indicio, no una prueba, y la ausencia de resultados tampoco lo es: registros rotados, parámetros no registrados, otro proxy aguas arriba.

En Keycloak, los eventos de usuario no se conservan por defecto, solo los errores. Active Save events en Realm settings, Events, para guardar el historial desde ahora, y revise los inicios de sesión federados inusuales: hora, dirección IP, cuenta. Antes de activarlo no se registró nada: lo que no encuentre puede que nunca se haya escrito.

Solución de problemas tras subir de versión

El paso a la 26.8 cambia varios comportamientos, indicados en la guía de actualización. Estos son los que más a menudo parecen una avería. La guía no cita ningún mensaje de arranque: los síntomas siguientes son los que describe.

Síntomas y remedios, según la guía de actualización

  • Errores 401 de la API de administración — los tokens deben llevar el nuevo scope kc-admin-api. Los clientes personalizados y las cuentas de servicio deben tenerlo asignado; admin-cli y la consola se actualizan solos. Durante una subida progresiva, son posibles 401 temporales.
  • Un inicio de sesión SAML que ya no pasa — las aserciones deben llevar una confirmación de sujeto de tipo bearer, y las condiciones ProxyRestriction se rechazan por defecto. En el adaptador, entityID="idp" debe sustituirse por la URL del realm.
  • Vinculación automática de cuentas rechazada — ahora exige una dirección de correo verificada o la opción Trust Email en el proveedor. Usuarios federados que se vinculaban solos pueden recibir de pronto una pantalla de vinculación.
  • Más carga en base de datos o CPU — los fallos de inicio de sesión se guardan en la base por defecto, lo que aumenta conexiones y CPU. --features=login-failures:v1 restablece el almacenamiento en memoria.
  • Migración demasiado larga — el plazo por defecto es de 30 minutos, ajustable con --transaction-setup-timeout. Si la parada se produjo en plena migración, restaure la base respaldada antes de reiniciar.
  • Usuarios desconectados — con persistent-user-sessions desactivado, se pierden todas las sesiones salvo las sesiones sin conexión, y los flujos de inicio de sesión en curso deben reiniciarse. Avise a los usuarios antes de la ventana de mantenimiento.

Documentación oficial

Los enlaces siguientes son las fuentes de esta guía; relea antes de actuar.

Aviso de GitHub: https://github.com/advisories/GHSA-c85j-3hq2-q6wj

Notas de la versión 26.8.2: https://www.keycloak.org/2026/11/keycloak-2682-released

Seguimiento del proyecto: https://github.com/keycloak/keycloak/issues/54714

Guía de actualización: https://www.keycloak.org/docs/latest/upgrading/index.html

Ficha de Red Hat de la CVE: https://access.redhat.com/security/cve/CVE-2026-117691

Aviso de Red Hat 26.6.9: https://access.redhat.com/errata/RHSA-2026:96040

Para un SSO que opere usted mismo, la ficha de Keycloak del catálogo de ServOrbit ofrece una plantilla VPS lista para desplegar, con PostgreSQL y HTTPS, a la que el procedimiento anterior se aplica tal cual.

Compartir este artículoservorbit.com/ma-es/blog/keycloak-cve-2026-117691-firma-saml-eludida-actualizar

Mantenga Keycloak al día en su VPS

Precios sin IVA, mostrados con su precio de renovación.