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)
CVSS:3.1/AV:N/AC:L/PR:H/UI:N/S:U/C:N/I:L/A:L
Fuente: GitHub
Ciclo de vida de la vulnerabilidad
| Fecha | Fase | Evento | Detalle |
|---|---|---|---|
| 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 |
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.
- `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`.
- `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).
Desglose de métricas
Rangos afectados
Estado del parche por paquete
| Paquete / producto | Estado | Corregida en | Desde divulgación | Última versión |
|---|---|---|---|---|
pypifrigate |
Sin parche | — | — | 0.7.0 afectada |
Arsenal público
Sin exploits, módulos ni PoC públicos conocidos a la fecha de verificación.
https://github.com/blakeblackshear/frigate/security/advisories/GHSA-f4g2-5496-9233Las referencias externas se muestran para copiar: cve.llama.ec no lo redirige a otros sitios.
