Il coltellino svizzero del pentester.

Funzionalità • Comandi supportati • Installazione • Utilizzo • Documentazione • Unisciti a noi su Discord!

secator è un esecutore di attività e flussi di lavoro utilizzato per valutazioni di sicurezza. Supporta decine di strumenti di sicurezza noti ed è progettato per migliorare la produttività di pentester e ricercatori di sicurezza.

Funzionalità

• Elenco curato di comandi

• Opzioni di input unificate

• Schema di output unificato

• Utilizzo da CLI e come libreria

• Opzioni distribuite con Celery

• Complessità da semplici attività a flussi di lavoro complessi

• Personalizzabile

Strumenti supportati

secator integra i seguenti strumenti:

Sentiti libero di richiedere nuovi strumenti da aggiungere aprendo un issue, ma controlla prima che lo strumento sia conforme ai nostri criteri di selezione. Se non lo è ma desideri comunque integrarlo in secator, puoi collegarlo (vedi la guida per sviluppatori).

Installazione di 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 hai scelto i metodi di installazione Docker o Docker Compose, puoi saltare le prossime sezioni e andare direttamente a Utilizzo.

Utilizzo

secator --help

Esempi di utilizzo

Per ottenere un cheat sheet completo di cosa puoi fare con secator, leggi l'output di:

secator cheatsheet

Esegui un'attività di fuzzing (ffuf):

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

Esegui un flusso di lavoro di crawling URL:

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

Esegui una scansione host:

secator s host mydomain.com

Per elencare tutte le attività / flussi di lavoro / scansioni che puoi utilizzare:

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

Per scoprire quali linguaggi o strumenti sono installati sul tuo sistema (insieme alla loro versione):

secator health

Query

secator ti consente di interrogare tutti i report precedenti con il comando secator query (o secator q) e di riutilizzare le query.

secator q <arg> risolve il suo argomento in tre passaggi:

1. Nome della query salvata — se <arg> corrisponde a una query salvata, viene utilizzata la sua espressione.
2. Espressione di filtro — se <arg> assomiglia a un filtro (contiene ==, <, ~=, &&, …), viene passato direttamente.
3. Linguaggio naturale — altrimenti viene inviato alla chat AI (secator x ai --mode chat).

# Esegui espressioni direttamente
secator q "vulnerability.tags ~= 'kev' && vulnerability.confidence == 'high'"                                                     # vuln KEV (Vulnerabilità note e sfruttate) + alta confidenza
secator q "vulnerability.severity == 'critical' && vulnerability.tags ~= 'exploitable' && vulnerability.confidence == 'high'"     # vuln critiche + sfruttabili + alta confidenza
secator q "vulnerability.severity_nb < 2 && vulnerability.confidence == 'high'"                                                   # vuln con gravità > alta + alta confidenza
secator q "exploit.cves  ~= 'CVE-2021-44521'"                                                                                       # exploit trovati per la vuln CVE-2021-44521
secator q "port" -f "{host} {port} {service_name}" | cut -d " " -f2 | sort | uniq -c | sort -nr | head -n 15                      # prime 15 porte
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 # primi 15 servizi
secator q "technology" -f "{product}/{version}" | sort | uniq -c | sort -nr | head -n 15                                          # prime 15 tecnologie
secator q "port.state == 'open'" -rf scans/23,tasks/10                                                                            # solo risultati dalla scansione 23 e attività 10

# Salva una query ed eseguila
secator c set queries.critical_vulns "vulnerability.severity_nb < 2"          # salva una query
secator c get queries                                                         # elenca query salvate
secator q critical_vulns -f "{vulnerability.matched_at}" -ws secator.cloud    # esegui una query salvata su workspace + estrai target

# Fai una domanda in linguaggio naturale (esegue l'attività di chat AI)
secator q "Analizza i dati del mio workspace"

secator q accetta le stesse opzioni di secator r show (-o/--output, -d/--time-delta, -f/--format, -w/-ws/--workspace, --driver, --dedupe), più -rf/--report-filter per limitare la query a percorsi specifici del runner (l'equivalente dell'argomento REPORT_QUERY di r show). Nel percorso della chat AI vengono utilizzati solo il workspace e il prompt.

Completamento shell

secator supporta il completamento shell per bash, zsh e fish. Fornisce il completamento automatico per:

• Nomi di attività (es. nmap, httpx, nuclei)
• Nomi di flussi di lavoro (es. url_crawl, subdomain_recon)
• Nomi di scansioni (es. host, domain, network)
• Opzioni CLI come --profiles, --workspace, --driver, --output

Per installare il completamento 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

Dopo l'installazione, puoi usare il completamento con tab:

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

Installazione degli strumenti

secator installa automaticamente gli strumenti quando li usi per la prima volta. Puoi impedire questo comportamento impostando security.autoinstall_commands su false usando secator config set security.autoinstall_commands false o SECATOR_SECURITY_AUTOINSTALL_COMMANDS=0.

Per installare tutti gli strumenti, puoi comunque eseguire:

secator install tools

Installazione degli addon

Sono disponibili addon per secator, consulta la nostra documentazione per i dettagli.

Ad esempio, usando l'addon mongodb puoi inviare i risultati del runner a MongoDB.

Per saperne di più

Per approfondire secator, dai un'occhiata a:

• La nostra documentazione completa documentation
• Il nostro video tutorial introduttivo tutorial video
• Il nostro articolo su Medium
• Seguici sui social media: @freelabz su Twitter e @FreeLabz su YouTube

Statistiche