La navaja suiza del pentester.

Características • Comandos soportados • Instalación • Uso • Documentación • ¡Únete a nosotros en Discord!

secator es un ejecutor de tareas y flujos de trabajo utilizado para evaluaciones de seguridad. Soporta docenas de herramientas de seguridad conocidas y está diseñado para mejorar la productividad de los pentesters e investigadores de seguridad.

Características

• Lista curada de comandos

• Opciones de entrada unificadas

• Esquema de salida unificado

• Uso desde CLI y como librería

• Opciones distribuidas con Celery

• Complejidad desde tareas simples hasta flujos de trabajo complejos

• Personalizable

Herramientas soportadas

secator integra las siguientes herramientas:

No dudes en solicitar nuevas herramientas para que sean añadidas abriendo un issue, pero por favor verifica que la herramienta cumpla con nuestros criterios de selección antes de hacerlo. Si no los cumple pero aún así quieres integrarla en secator, puedes integrarla (consulta la guía para desarrolladores).

Instalando secator

bash -c "$(curl -fsSL https://raw.githubusercontent.com/freelabz/secator/main/scripts/install_universal.sh)"

pipx install secator

pip install secator

docker run -it --rm --net=host -v ~/.secator:/root/.secator freelabz/secator --help

alias secator="docker run -it --rm --net=host -v ~/.secator:/root/.secator freelabz/secator"

secator --help

git clone https://github.com/freelabz/secator
cd secator
docker-compose up -d
docker-compose exec secator-client secator --help

Nota: Si elegiste los métodos de instalación Docker o Docker Compose, puedes saltarte las siguientes secciones e ir directamente a Uso.

Uso

secator --help

Ejemplos de uso

Para obtener un cheatsheet completo de lo que puedes hacer con secator, por favor lee la salida de:

secator cheatsheet

Ejecuta una tarea de fuzzing (ffuf):

secator x ffuf http://testphp.vulnweb.com/FUZZ

Ejecuta un flujo de trabajo de rastreo de URL:

secator w url_crawl http://testphp.vulnweb.com

Ejecuta un escaneo de host:

secator s host mydomain.com

Para listar todas las tareas / flujos de trabajo / escaneos que puedes usar:

secator x --help
secator w --help
secator s --help

Para saber qué lenguajes o herramientas están instalados en tu sistema (junto con su versión):

secator health

Consultas

secator te permite consultar todos los reportes anteriores con el comando secator query (o secator q), y reutilizar consultas.

secator q <arg> resuelve su argumento en tres pasos:

1. Nombre de consulta guardada — si <arg> coincide con una consulta guardada, se usa su expresión.
2. Expresión de filtro — si <arg> parece un filtro (contiene ==, <, ~=, &&, …), se pasa directamente.
3. Lenguaje natural — de lo contrario, se envía al chat de IA (secator x ai --mode chat).

# Ejecuta expresiones directamente
secator q "vulnerability.tags ~= 'kev' && vulnerability.confidence == 'high'"                                                     # vulns KEV (Vulnerabilidades Explotadas Conocidas) + alta confianza
secator q "vulnerability.severity == 'critical' && vulnerability.tags ~= 'exploitable' && vulnerability.confidence == 'high'"     # vulns críticas + explotables + alta confianza
secator q "vulnerability.severity_nb < 2 && vulnerability.confidence == 'high'"                                                   # vulns gravedad > alta + alta confianza
secator q "exploit.cves  ~= 'CVE-2021-44521'"                                                                                       # exploits encontrados para la vuln CVE-2021-44521
secator q "port" -f "{host} {port} {service_name}" | cut -d " " -f2 | sort | uniq -c | sort -nr | head -n 15                      # top 15 puertos
secator q "port" -f "{host} {port} {service_name}" | cut -d " " -f3,4,5,6 | awk 'NF > 0' | sort | uniq -c | sort -nr | head -n 15 # top 15 servicios
secator q "technology" -f "{product}/{version}" | sort | uniq -c | sort -nr | head -n 15                                          # top 15 tecnologías
secator q "port.state == 'open'" -rf scans/23,tasks/10                                                                            # solo resultados del escaneo 23 y tarea 10

# Guarda una consulta y ejecútala
secator c set queries.critical_vulns "vulnerability.severity_nb < 2"          # guarda una consulta
secator c get queries                                                         # lista consultas guardadas
secator q critical_vulns -f "{vulnerability.matched_at}" -ws secator.cloud    # ejecuta una consulta guardada en el espacio de trabajo + extrae objetivos

# Haz una pregunta en lenguaje natural (ejecuta la tarea de chat de IA)
secator q "Analiza los datos de mi espacio de trabajo"

secator q acepta las mismas opciones que secator r show (-o/--output, -d/--time-delta, -f/--format, -w/-ws/--workspace, --driver, --dedupe), además de -rf/--report-filter para limitar la consulta a rutas específicas de runners (el equivalente del argumento REPORT_QUERY de r show). En la ruta de chat de IA solo se usan el espacio de trabajo y el prompt.

Finalización de shell

secator soporta finalización de shell para bash, zsh y fish. Esto proporciona auto-completado para:

• Nombres de tareas (ej., nmap, httpx, nuclei)
• Nombres de flujos de trabajo (ej., url_crawl, subdomain_recon)
• Nombres de escaneos (ej., host, domain, network)
• Opciones de CLI como --profiles, --workspace, --driver, --output

Para instalar la finalización de shell:

Bash:

secator util completion --shell bash --install
source ~/.bashrc

Zsh:

secator util completion --shell zsh --install
source ~/.zshrc

Fish:

secator util completion --shell fish --install

Después de la instalación, puedes usar la finalización con tabulador:

secator x n<TAB>     # completa a nmap, naabu, nuclei, etc.
secator w url_<TAB>     # completa a url_crawl, url_fuzz, url_dirsearch, etc.
secator x nmap --profiles ag<TAB>  # completa a aggressive

Instalando herramientas

secator instala automáticamente las herramientas cuando las usas por primera vez. Puedes evitar este comportamiento estableciendo security.autoinstall_commands a false usando secator config set security.autoinstall_commands false o SECATOR_SECURITY_AUTOINSTALL_COMMANDS=0.

Para instalar todas las herramientas, aún puedes ejecutar:

secator install tools

Instalando complementos

Hay complementos disponibles para secator, consulta nuestra documentación para más detalles.

Por ejemplo, usar el complemento mongodb te permite enviar los resultados del runner a MongoDB.

Aprende más

Para profundizar con secator, echa un vistazo a:

• Nuestra completa documentación
• Nuestro video tutorial para empezar
• Nuestro artículo en Medium
• Síguenos en redes sociales: @freelabz en Twitter y @FreeLabz en YouTube

Estadísticas