O canivete suíço do pentester.

Funcionalidades • Comandos suportados • Instalação • Uso • Documentação • Junte-se a nós no Discord!

secator é um executor de tarefas e workflows usado para avaliações de segurança. Suporta dezenas de ferramentas de segurança conhecidas e é projetado para aumentar a produtividade de pentesters e pesquisadores de segurança.

Funcionalidades

• Lista curada de comandos

• Opções de entrada unificadas

• Esquema de saída unificado

• Uso via CLI e como biblioteca

• Opções distribuídas com Celery

• Complexidade desde tarefas simples até workflows complexos

• Personalizável

Ferramentas suportadas

secator integra as seguintes ferramentas:

Sinta-se à vontade para solicitar novas ferramentas abrindo uma issue, mas por favor verifique se a ferramenta atende aos nossos critérios de seleção antes de fazê-lo. Se não atender, mas você ainda quiser integrá-la ao secator, pode conectá-la (veja o guia de desenvolvimento).

Instalando o 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: Se você escolheu os métodos de instalação Docker ou Docker Compose, pode pular as próximas seções e ir diretamente para Uso.

Uso

secator --help

Exemplos de uso

Para obter uma cheatsheet completa do que você pode fazer com secator, por favor leia a saída de:

secator cheatsheet

Execute uma tarefa de fuzzing (ffuf):

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

Execute um workflow de crawl de URL:

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

Execute um scan de host:

secator s host mydomain.com

Para listar todas as tarefas / workflows / scans que você pode usar:

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

Para descobrir quais linguagens ou ferramentas estão instaladas em seu sistema (junto com suas versões):

secator health

Consultas

secator permite consultar todos os relatórios anteriores com o comando secator query (ou secator q) e reutilizar consultas.

secator q <arg> resolve seu argumento em três etapas:

1. Nome de consulta salva — se <arg> corresponder a uma consulta salva, sua expressão é usada.
2. Expressão de filtro — se <arg> parecer um filtro (contém ==, <, ~=, &&, …), ele é passado diretamente.
3. Linguagem natural — caso contrário, é enviado para o chat de IA (secator x ai --mode chat).

# Execute expressões brutas diretamente
secator q "vulnerability.tags ~= 'kev' && vulnerability.confidence == 'high'"                                                     # vulns KEV (Vulnerabilidades Conhecidas e Exploradas) + alta confiança
secator q "vulnerability.severity == 'critical' && vulnerability.tags ~= 'exploitable' && vulnerability.confidence == 'high'"     # vulns críticas + exploráveis + alta confiança
secator q "vulnerability.severity_nb < 2 && vulnerability.confidence == 'high'"                                                   # vulns severidade > alta + alta confiança
secator q "exploit.cves  ~= 'CVE-2021-44521'"                                                                                       # exploits encontrados para 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 portas
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 serviços
secator q "technology" -f "{product}/{version}" | sort | uniq -c | sort -nr | head -n 15                                          # top 15 tecnologias
secator q "port.state == 'open'" -rf scans/23,tasks/10                                                                            # apenas resultados do scan 23 e tarefa 10

# Salve uma consulta e execute-a
secator c set queries.critical_vulns "vulnerability.severity_nb < 2"          # salvar uma consulta
secator c get queries                                                         # listar consultas salvas
secator q critical_vulns -f "{vulnerability.matched_at}" -ws secator.cloud    # executar consulta salva no workspace + extrair alvos

# Faça uma pergunta em linguagem natural (executa a tarefa de chat de IA)
secator q "Analyze my workspace data"

secator q aceita as mesmas opções que secator r show (-o/--output, -d/--time-delta, -f/--format, -w/-ws/--workspace, --driver, --dedupe), além de -rf/--report-filter para limitar a consulta a caminhos específicos de runners (equivalente ao argumento REPORT_QUERY do r show). No caminho do chat de IA, apenas o workspace e o prompt são usados.

Completamento de shell

secator suporta completamento de shell para bash, zsh e fish. Isso fornece autocompletar para:

• Nomes de tarefas (ex.: nmap, httpx, nuclei)
• Nomes de workflows (ex.: url_crawl, subdomain_recon)
• Nomes de scans (ex.: host, domain, network)
• Opções de CLI como --profiles, --workspace, --driver, --output

Para instalar o completamento 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

Após a instalação, você pode usar o completamento com tab:

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

Instalando ferramentas

secator instala automaticamente as ferramentas quando você as usa pela primeira vez. Você pode evitar esse comportamento definindo security.autoinstall_commands como false usando secator config set security.autoinstall_commands false ou SECATOR_SECURITY_AUTOINSTALL_COMMANDS=0.

Para instalar todas as ferramentas, você ainda pode executar:

secator install tools

Instalando addons

Addons estão disponíveis para secator, por favor verifique nossa documentação para detalhes.

Por exemplo, usando o addon mongodb permite enviar resultados de runners para o MongoDB.

Saiba mais

Para se aprofundar no secator, confira:

• Nossa documentação completa
• Nosso vídeo tutorial de introdução
• Nosso artigo no Medium
• Siga-nos nas redes sociais: @freelabz no Twitter e @FreeLabz no YouTube

Estatísticas