llamaCVEVulnerability Intelligence
/
Advisory · GitHub · PyPI · frigate

GHSA-F4G2-5496-9233

Path traversal en endpoints de gestión de reconocimiento facial (escritura arbitraria de archivos mediante register, eliminación arbitraria de archivos mediante delete)

Sin parche publicado
Descargar PNG JSON
CVSS 3.1
3.8
Baja
CVSS:3.1/AV:N/AC:L/PR:H/UI:N/S:U/C:N/I:L/A:L Fuente: GitHub
ExplotaciónSin evidenciaNo figura en CISA KEV
Exploits públicos0Ninguno conocido
ParcheSin parcheEl fabricante no ha publicado corrección
Exposición69 dDesde la divulgación, 12 sept 2026, 8:45 a. m.
Detección67 dDesde la divulgación hasta su ingreso al índice
Decisión estimadaSeguir
Remediar en la ventana regular de mantenimiento
Estimación de Llama con el árbol SSVC de CISA a partir de vector CVSS 3.1 y la evidencia de explotación (sin evaluación oficial): sin explotación conocida, no automatizable e impacto técnico parcial. No hay versión corregida: aplique mitigaciones.
Esta no le quita el sueño ni a un SOC novato.Riesgo bajo, café alto.
Timeline

Ciclo de vida de la vulnerabilidad

Hoy
Divulgación
Publicada
Explotación
Remediación
Monitoreo
Detectada +1
12 sept 26
18 nov 26
21 nov 26
12 sept 26
30 sept 26
17 oct 26
4 nov 26
21 nov 26
FechaFaseEventoDetalle
Divulgación Publicada GHSA-F4G2-5496-9233 divulgada · CVSS 3.8 (GitHub)
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

Detalles de la vulnerabilidad

Archivos: `frigate/data_processing/real_time/face.py` (sumidero de register), `frigate/embeddings/__init__.py` (sumidero de delete)
CWE: CWE-22 — Limitación inadecuada de un nombre de ruta a un directorio restringido ("Path Traversal")

Causa raíz

Dos de las cuatro rutas de gestión facial de Frigate en `frigate/api/classification.py` pasan el parámetro de ruta `name` directamente a operaciones del sistema de archivos relativas a `FACE_DIR`, sin llamada a `sanitize_filename()` y sin verificación de contención posterior a la unión de rutas. En cambio, sus funciones hermanas, en el mismo archivo y clase, protegen correctamente el mismo parámetro:

| Ruta | ¿Sanitiza `name`? |
|---|---|
| `POST /faces/{name}/create` | ✅ `sanitize_filename(name.replace(" ", "_"))` |
| `PUT /faces/{old_name}/rename` | ✅ allowlist mediante expresión regular + igualdad con `sanitize_filename` + `os.path.normpath(...).startswith(FACE_DIR)` |
| `POST /faces/{name}/register` | ❌ ninguna |
| `POST /faces/{name}/delete` | ❌ ninguna |

1. Escritura arbitraria de archivos mediante `register_face`:

# frigate/api/classification.py:283-291
async def register_face(request: Request, name: str, file: UploadFile):
    ...
    context.register_face(name, await file.read())  # `name` sin sanitizar

# frigate/embeddings/__init__.py:190-197 — paso directo, todavía sin sanitizar
def register_face(self, face_name: str, image_data: bytes) -> dict[str, Any]:
    return self.requestor.send_data(
        EmbeddingsRequestEnum.register_face.value,
        {"face_name": face_name, "image": base64.b64encode(image_data).decode("ASCII")},
    )

# frigate/data_processing/real_time/face.py:392-401 — el sumidero
folder = os.path.join(FACE_DIR, label)          # label = request_data["face_name"], sin procesar
file = os.path.join(folder, f"{label}_{datetime.datetime.now().timestamp()}.webp")
os.makedirs(folder, exist_ok=True)               # crea CUALQUIER directorio, sin verificación de contención
with open(file, "wb") as output:
    output.write(thumbnail.tobytes())

2. Eliminación arbitraria de archivos mediante `delete_face_ids`:

# frigate/api/classification.py:350-362
def deregister_faces(request: Request, name: str, body: DeleteFaceImagesBody):
    ...
    context.delete_face_ids(name, map(lambda file: sanitize_filename(file), body.ids))
    # `name` se pasa SIN PROCESAR; solo los elementos de body.ids se sanitizan

# frigate/embeddings/__init__.py:227-236 -- el sumidero
def delete_face_ids(self, face: str, ids: list[str]) -> None:
    folder = os.path.join(FACE_DIR, face)        # `face` = `name` sin procesar, sin sanitizar
    for id in ids:
        file_path = os.path.join(folder, id)
        if os.path.isfile(file_path):
            os.unlink(file_path)                  # elimina el archivo
    if face != "train" and len(os.listdir(folder)) == 0:
        os.rmdir(folder)
Escenario de ataque

Ambas rutas requieren el rol admin (`Depends(require_role(["admin"]))`).

Un detalle de enrutamiento importante y no evidente: un segmento de ruta `..` literal (por ejemplo, `POST /faces/../delete`) es normalizado por cualquier cliente HTTP conforme a RFC 3986 (navegadores, httpx, la mayoría de bibliotecas HTTP) *antes de que la solicitud se envíe*. La forma codificada en porcentaje no lo es: `POST /faces/%2e%2e/delete` sobrevive a la normalización del lado del cliente y Starlette la decodifica en el servidor *después* de la coincidencia de rutas, resolviendo `name == ".."`. (Una barra diagonal codificada en porcentaje dentro del mismo segmento `{name}`, por ejemplo `%2e%2e%2falgun_dir`, no sobrevive: el enrutador de Starlette compara contra la ruta todavía codificada y devuelve 404. Por lo tanto, la carga útil alcanzable es exactamente el escape `..` de un solo nivel y sin barras, no un path traversal más profundo de varios segmentos). Una solicitud sin procesar o construida manualmente (curl `--path-as-is`, Burp Repeater) puede enviar cualquiera de las dos formas.

  1. `POST /faces/%2e%2e/register` con una imagen multipart adjunta → el servidor crea `os.makedirs(FACE_DIR/.., exist_ok=True)` y, como `label` (`".."`) se reutiliza tanto para la carpeta como para el componente del nombre de archivo, el `os.path.join` sin normalizar deja el archivo `.webp` escrito directamente en el directorio padre de `FACE_DIR`, es decir `CLIPS_DIR` (la raíz principal de almacenamiento de clips e instantáneas de Frigate en producción), con el nombre `.._<timestamp>.webp`.
  2. `POST /faces/%2e%2e/delete` con el cuerpo `{"ids": ["<nombre-de-archivo-objetivo>"]}` → `folder = os.path.join(FACE_DIR, "..")` resuelve a `CLIPS_DIR`; cualquier archivo con un nombre coincidente directamente bajo `CLIPS_DIR` se elimina mediante `os.unlink`. Si `CLIPS_DIR` queda vacío después, además se ejecuta `os.rmdir(CLIPS_DIR)` (la guarda `face != "train"` no bloquea `".."`).
Impacto

Una cuenta de administrador (propia, o comprometida mediante otro vector) puede escribir un archivo de imagen controlado por el atacante directamente en `CLIPS_DIR`, o eliminar archivos arbitrarios por nombre directamente bajo `CLIPS_DIR` (y potencialmente eliminar el propio `CLIPS_DIR` si está vacío de forma transitoria). Esto omite por completo la contención prevista de esta funcionalidad ("solo rostros"). El valor `PR:H` reduce la puntuación CVSS respecto de un caso hipotético sin autenticación, pero sigue siendo un fallo de contención significativo y corresponde a la misma clase de error que GHSA-hh3j-7g2f-43j2 ("el código que debería limitar una operación a un directorio no lo hace").

Verificación dinámica

Ambos sumideros se confirmaron dinámicamente mediante pytest que importa el código real (no una reimplementación copiada a mano): `EmbeddingsContext.delete_face_ids()` y la rama register_face de `FaceRealTimeProcessor.handle_request()` se invocaron directamente, sin modificaciones, sobre un entorno aislado en un directorio temporal con `FACE_DIR` reemplazado mediante monkeypatch, lo que demuestra que los archivos se escriben o eliminan fuera de `FACE_DIR`. La accesibilidad en la capa de enrutamiento de la carga útil `%2e%2e` se confirmó por separado y de forma empírica contra una instancia en vivo de FastAPI/Starlette TestClient. Un control diferencial en la misma suite de pruebas confirma que la función hermana `rename_face()` rechaza correctamente la misma carga útil mediante su verificación de contención existente, lo que demuestra que se trata de un fallo específico de `register_face`/`delete_face_ids` y no de una funcionalidad ausente en toda la clase.

Corrección recomendada

Aplicar el mismo patrón de contención ya implementado (y verificado como correcto) en `EmbeddingsContext.rename_face()`, en el mismo archivo, tanto en el sumidero de `register_face` como en `delete_face_ids`:

from pathvalidate import sanitize_filename

label = sanitize_filename(request_data["face_name"], replacement_text="_")
folder = os.path.normpath(os.path.join(FACE_DIR, label))
if not folder.startswith(os.path.normpath(FACE_DIR) + os.sep):
    raise ValueError(f"Invalid face name: {request_data['face_name']}")

Se recomienda extraer la verificación de contención de `rename_face()` a un helper compartido, de modo que las cuatro rutas de gestión facial (`create`, `register`, `delete`, `rename`) usen una única implementación auditada en lugar de copias independientes (y, en este caso, ausentes).

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:L
BajaAlta
PrivilegiosPR:H
NingunoBajosAltos
InteracciónUI:N
NingunaRequerida
AlcanceS:U
CambiadoSin cambio
ConfidencialidadC:N
AltoBajoNinguno
IntegridadI:L
AltoBajoNinguno
DisponibilidadA:L
AltoBajoNinguno
Score de explotaciónQué tan fácil y probable es que la exploten
5.0/ 10Medio
Vector 5.0 (moderada) · sin evidencia de explotación.
Versiones

Rangos afectados

Afectada Corregida Última
frigate≤ 0.17.2
0.7.0
0.17.2
Remediación

Estado del parche por paquete

Paquete / productoEstadoCorregida enDesde divulgaciónÚltima versión
pypifrigate
Sin parche — — 0.7.0 afectada
Explotación

Arsenal público

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

Referencias
Advisoryhttps://github.com/blakeblackshear/frigate/security/advisories/GHSA-f4g2-5496-9233

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