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

GHSA-63QV-GH36-52QF

Las conexiones WebSocket eluden todas las comprobaciones de SecurityMiddleware, incluidos los baneos activos de IP

Parche disponible
Descargar PNG JSON
CVSS
—
high
Fuente: —
ExplotaciónSin evidenciaNo figura en CISA KEV
Exploits públicos0Ninguno conocido
Parche1 versiónPrimer parche el mismo día de la divulgación
Exposición85 dDesde la divulgación, 26 ago 2026, 2:57 p. m.
Detección85 dDesde la divulgación hasta su ingreso al índice
Timeline

Ciclo de vida de la vulnerabilidad

Hoy
Divulgación
Publicada
Explotación
Remediación
Parche 7.8.0
Monitoreo
Detectada +1
26 ago 26
20 nov 26
26 ago 26
17 sept 26
8 oct 26
30 oct 26
20 nov 26
FechaFaseEventoDetalle
Divulgación Publicada GHSA-63QV-GH36-52QF divulgada
Remediación Parche 7.8.0 fastapi-guard · 0 d desde divulgación
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
Resumen

`SecurityMiddleware` extiende `BaseHTTPMiddleware` de Starlette
(`guard/middleware.py:46`). `BaseHTTPMiddleware.__call__` comienza con
`if scope["type"] != "http": return await self.app(scope, receive, send)`, por lo que un scope
`websocket` se entrega directamente al enrutador. Nada de guard se ejecuta: ni la lista de
permitidos/denegados por IP, ni la comprobación de baneos, ni el límite de tasa, ni la detección de
penetración, ni el bloqueo de emergencia. Los decoradores de ruta en los manejadores WebSocket tampoco tienen efecto.

Una dirección baneada para HTTP puede seguir abriendo un socket y recibir respuesta.

PoC
import asyncio
from fastapi import FastAPI, WebSocket
from starlette.testclient import TestClient
from guard.middleware import SecurityMiddleware
from guard_core.handlers.ipban_handler import ip_ban_manager
from guard_core.models import SecurityConfig

BANNED = ("203.0.113.66", 1234)
app = FastAPI()
app.add_middleware(SecurityMiddleware, config=SecurityConfig(enable_redis=False))

@app.get("/")
async def root():
    return {"ok": True}

@app.websocket("/ws")
async def socket(sock: WebSocket):
    await sock.accept()
    await sock.send_text("data the ban was supposed to withhold")
    await sock.close()

async def main():
    await ip_ban_manager.ban_ip(BANNED[0], 3600)
    with TestClient(app, client=BANNED) as client:
        print("GET  /  ->", client.get("/").status_code)
        with client.websocket_connect("/ws") as sock:
            print("WS  /ws ->", sock.receive_text())

asyncio.run(main())

En 7.7.0 / 3.13.0:

GET  /  -> 403
WS  /ws -> data the ban was supposed to withhold
Impacto

Cualquier control configurado por el operador está ausente en la mitad WebSocket de la aplicación. En una aplicación que expone su superficie de streaming o tiempo real mediante WebSockets (chat, notificaciones, consultas en vivo), esa superficie no tiene límite de tasa ni aplicación de baneos, y el baneo que el operador puede ver en el estado de administración no le aplica. Tanto la fuerza bruta contra un socket autenticado como la continuación de un ataque tras haber sido baneado por HTTP funcionan.

`examples/simple_app` anuncia protección para WebSocket, por lo que un operador que lea los ejemplos tiene motivos para creer que esto está cubierto.

Solución sugerida

Implementar `__call__` a nivel ASGI y ejecutar las comprobaciones de identidad, baneo y tasa antes de aceptar el handshake, o indicar claramente en el README y en el ejemplo que el middleware solo funciona con HTTP y distribuir una dependencia (`Depends(guard_ws_check)`) que una ruta WebSocket pueda usar. La ruta de documentación es aceptable como primer paso; lo que debe cambiar en cualquier caso es el estado actual, en el que el ejemplo afirma una cobertura que no existe.

Corregido en 7.8.0

Corregido en fastapi-guard 7.8.0 https://github.com/rennf93/fastapi-guard/releases/tag/7.8.0 (PyPI https://pypi.org/project/fastapi-guard/7.8.0/), fusionado en #121 https://github.com/rennf93/fastapi-guard/pull/121 (eb5f284f). `guard_websocket` es una dependencia de FastAPI que ejecuta contra el cliente resuelto la lista de baneos, las listas de permitidos por IP y por país, y el límite de tasa antes de `accept()`, cerrando con el código 1008 ante una violación de política; un socket sin cliente se rechaza cuando `fail_secure=True`; los fallos de Redis durante el handshake siguen `redis_fail_open` / `fail_secure` igual que el pipeline HTTP (código de cierre 1013). `BaseHTTPMiddleware` nunca se ejecuta para scopes websocket, por lo que la protección es opcional por ruta: `Depends(guard_websocket)`. Documentado en el tutorial de websockets; la aplicación de ejemplo lo aplica en `/ws`.

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

Versiones

Rangos afectados

Afectada Corregida Última
fastapi-guard≤ 7.7.0
7.7.0
8.1.2
Remediación

Estado del parche por paquete

Paquete / productoEstadoCorregida enDesde divulgaciónÚltima versión
pypifastapi-guard
Corregida 7.8.0 0 d 8.1.2 no afectada
Versiones corregidas7.8.0
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-63qv-gh36-52qf

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