pwneye logo

pwneye es una herramienta de seguridad ofensiva centrada y portátil para trabajar con cámaras IP que exponen servicios ONVIF y RTSP, con el objetivo de ofrecer a investigadores de seguridad y hackers una forma sencilla de gestionar descubrimiento, pruebas de autenticación, recopilación de metadatos, validación de flujos, grabación y acciones de seguimiento desde un único flujo de trabajo CLI.

Algunas de las capacidades actualmente soportadas incluyen:

Descubrimiento ONVIF en red local mediante WS-Discovery
Autenticación ONVIF y fuerza bruta multihilo con credenciales únicas o archivos de usuario/contraseña
Enumeración ONVIF post-autenticación de información del dispositivo, usuarios configurados, configuración de red, perfiles multimedia y URIs de flujo RTSP
Reinicio de cámara, restablecimiento de fábrica y acceso a shell interactivo mediante ONVIF
Movimiento PTZ ONVIF tanto desde la CLI como desde el visor dedicado
Soporte de deface y restauración de flujo mediante ONVIF
Detección de puertos RTSP e identificación de proveedor basada en banners
Fuerza bruta RTSP consciente del proveedor con más de 450 perfiles integrados de credenciales/cadenas de conexión de proveedores, además de soporte de proveedor manual y cadena de conexión manual
Fuerza bruta RTSP multihilo con salida de progreso en vivo
Manejo multicanal RTSP con detección automática, enumeración guiada y selección interactiva de canales
Cliente dedicado de vista previa en vivo con zoom y cambio rápido de canal para objetivos tipo DVR/NVR
Validación de flujo RTSP, vista previa en vivo mediante ffplay, grabación mediante ffmpeg y captura de instantáneas
Caché por objetivo de hallazgos exitosos ONVIF y RTSP en ~/.pwneye

Demo

https://github.com/user-attachments/assets/6913632b-326d-455e-aa0d-be6bf9b3e66c

Instalación y Actualizaciones

pipx

Instala pwneye como un comando CLI a nivel de sistema desde GitHub:```bash pipx install git+https://github.com/Hackerest/pwneye.git pwneye --help

Desinstálalo:```bash
pipx uninstall pwneye

Más tarde puedes actualizarlo desde la misma fuente de GitHub:```bash pipx upgrade pwneye

### Python```bash
git clone https://github.com/Hackerest/pwneye
cd pwneye
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 pwneye.py --help

Actualízalo más tarde desde la misma fuente de GitHub:```bash cd pwneye git pull source .venv/bin/activate pip install -r requirements.txt

### Dependencias Externas

Se espera que las siguientes herramientas estén en `PATH` dependiendo del modo que uses:
- `ffplay`
- `ffprobe`
- `ffmpeg` para grabación

| Plataforma | Comando de instalación |
| --- | --- |
| macOS (Homebrew) | `brew install ffmpeg` |
| Ubuntu / Debian | `sudo apt update && sudo apt install ffmpeg` |
| Fedora | `sudo dnf install ffmpeg ffmpeg-free` |
| Arch Linux | `sudo pacman -S ffmpeg` |
| openSUSE | `sudo zypper install ffmpeg` |

## Primeros Pasos

Usa estos como los puntos de entrada más rápidos a la herramienta. El objetivo aquí no es documentar cada bandera, sino mostrar las formas más útiles de empezar a trabajar con una cámara según lo que ya sepas.

Comienza desde el flujo completo predeterminado cuando tengas un único objetivo y quieras que `pwneye` haga el trabajo de selección de protocolo por ti:```bash
pwneye -t 192.168.1.135

Empieza con el descubrimiento ONVIF cuando estés en la misma red local y quieras identificar dispositivos, fabricantes y pistas sobre los flujos antes de tocar RTSP:```bash pwneye --discover

Empieza directamente desde RTSP cuando ONVIF es irrelevante, no está disponible o ya sabes qué quieres probar:```bash
pwneye -t 192.168.1.135 --skip-onvif

Empieza con credenciales conocidas o sospechosas cuando quieras reducir el ruido y validar el acceso rápidamente:```bash pwneye -t 192.168.1.135 --username admin --password admin pwneye -t 192.168.1.135 --username admin --password ~/wordlists/passwords.txt pwneye -t 192.168.1.135 --username ~/wordlists/users.txt --password admin123

Comienza desde una ruta conocida o una plantilla de ruta cuando ya tengas una pista del flujo y quieras un control estricto sobre las solicitudes RTSP:```bash
pwneye -t 192.168.1.135 --skip-onvif -cn "/live/ch00_0"
pwneye -t 192.168.1.135 --skip-onvif -cn '/cam/realmonitor?channel={channel}&subtype=0'

Empieza la recopilación de evidencia una vez que se encuentre un flujo de trabajo funcional:```bash pwneye -t 192.168.1.135 --snapshot pwneye -t 192.168.1.135 --record

Flags útiles a tener en cuenta:
- `--vendor VENDOR`: reduce las solicitudes RTSP cuando ya se conoce la familia del dispositivo
- `-cn, --connection-string PATH`: prueba una ruta RTSP conocida o un archivo que contenga rutas candidatas
- `--multi-channel`: prefiere rutas RTSP basadas en canales cuando sospechas que el objetivo es un DVR/NVR
- `--threads N`: controla la concurrencia para el bruteforce de ONVIF y RTSP
- `--skip-onvif` / `--skip-rtsp`: céntrate en un solo protocolo
- `--no-cache`: no lee ni escribe en la caché
- `--fresh`: ignora las lecturas de caché pero sigue escribiendo nuevos hallazgos

## ONVIF

ONVIF es el lado de gestión y control del mundo de las cámaras. En la práctica, es útil para el descubrimiento, la autenticación, la extracción de metadatos, la enumeración de perfiles de medios, la obtención de URI de flujos y acciones del dispositivo como el reinicio.

En `pwneye`, ONVIF suele ser el protocolo que proporciona el contexto post-autenticación más rico, el camino más claro para entender qué expone una cámara y, cuando la cuenta autenticada tiene suficientes privilegios, acceso a acciones administrativas reales en el dispositivo.

### Qué te ofrece ONVIF

Cuando una cámara expone ONVIF, `pwneye` puede usarlo para:

Más Populares

pwneye

Demo

Tabla de Contenidos

Instalación y Actualizaciones

pipx