Швейцарский нож пентестера.

Возможности • Поддерживаемые команды • Установка • Использование • Документация • Присоединяйтесь к нам в Discord!

secator — это исполнитель задач и рабочих процессов, используемый для оценки безопасности. Он поддерживает десятки известных инструментов безопасности и предназначен для повышения продуктивности пентестеров и исследователей безопасности.

Возможности

• Курируемый список команд

• Унифицированные параметры ввода

• Унифицированная схема вывода

• Использование через CLI и в виде библиотеки

• Распределённые возможности с Celery

• Сложность: от простых задач до комплексных рабочих процессов

• Настраиваемость

Поддерживаемые инструменты

secator интегрирует следующие инструменты:

Не стесняйтесь запрашивать добавление новых инструментов, открыв issue, но перед этим проверьте, соответствует ли инструмент нашим критериям отбора. Если нет, но вы всё равно хотите интегрировать его в secator, вы можете подключить его самостоятельно (см. руководство разработчика).

Установка 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

Примечание: Если вы выбрали установку через Docker или Docker Compose, можете пропустить следующие разделы и перейти сразу к Использованию.

Использование

secator --help

Примеры использования

Чтобы получить полную шпаргалку по возможностям secator, прочитайте вывод:

secator cheatsheet

Запуск задачи фаззинга (ffuf):

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

Запуск рабочего процесса обхода URL:

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

Запуск сканирования хоста:

secator s host mydomain.com

Чтобы вывести список всех доступных задач / рабочих процессов / сканирований:

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

Чтобы узнать, какие языки или инструменты установлены в вашей системе (вместе с их версиями):

secator health

Запросы

secator позволяет запрашивать все предыдущие отчёты с помощью команды secator query (или secator q) и повторно использовать запросы.

secator q <arg> разрешает свой аргумент в три этапа:

1. Имя сохранённого запроса — если <arg> совпадает с сохранённым запросом, используется его выражение.
2. Выражение фильтра — если <arg> выглядит как фильтр (содержит ==, <, ~=, &&, …), он передаётся напрямую.
3. Естественный язык — в противном случае он отправляется в AI-чат (secator x ai --mode chat).

# Выполнение выражений напрямую
secator q "vulnerability.tags ~= 'kev' && vulnerability.confidence == 'high'"                                                     # уязвимости KEV + высокая уверенность
secator q "vulnerability.severity == 'critical' && vulnerability.tags ~= 'exploitable' && vulnerability.confidence == 'high'"     # уязвимости critical + exploitable + высокая уверенность
secator q "vulnerability.severity_nb < 2 && vulnerability.confidence == 'high'"                                                   # уязвимости severity > high + высокая уверенность
secator q "exploit.cves  ~= 'CVE-2021-44521'"                                                                                       # найденные эксплойты для уязвимости CVE-2021-44521
secator q "port" -f "{host} {port} {service_name}" | cut -d " " -f2 | sort | uniq -c | sort -nr | head -n 15                      # топ-15 портов
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 # топ-15 сервисов
secator q "technology" -f "{product}/{version}" | sort | uniq -c | sort -nr | head -n 15                                          # топ-15 технологий
secator q "port.state == 'open'" -rf scans/23,tasks/10                                                                            # только результаты из сканирования 23 и задачи 10

# Сохранение запроса и его выполнение
secator c set queries.critical_vulns "vulnerability.severity_nb < 2"          # сохранить запрос
secator c get queries                                                         # список сохранённых запросов
secator q critical_vulns -f "{vulnerability.matched_at}" -ws secator.cloud    # выполнить сохранённый запрос в рабочем пространстве + извлечь цели

# Задать вопрос на естественном языке (запускает задачу AI-чата)
secator q "Analyze my workspace data"

secator q принимает те же опции, что и secator r show (-o/--output, -d/--time-delta, -f/--format, -w/-ws/--workspace, --driver, --dedupe), плюс -rf/--report-filter для ограничения запроса конкретными путями runner'ов (аналог аргумента REPORT_QUERY для r show). В режиме AI-чата используются только рабочее пространство и запрос.

Автодополнение в shell

secator поддерживает автодополнение в shell для bash, zsh и fish. Оно предоставляет автодополнение для:

• Имён задач (например, nmap, httpx, nuclei)
• Имён рабочих процессов (например, url_crawl, subdomain_recon)
• Имён сканирований (например, host, domain, network)
• Опций CLI, таких как --profiles, --workspace, --driver, --output

Для установки автодополнения:

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

После установки вы можете использовать автодополнение по Tab:

secator x n<TAB>     # дополняет до nmap, naabu, nuclei и т.д.
secator w url_<TAB>     # дополняет до url_crawl, url_fuzz, url_dirsearch и т.д.
secator x nmap --profiles ag<TAB>  # дополняет до aggressive

Установка инструментов

secator автоматически устанавливает инструменты при первом использовании. Вы можете отключить это поведение, установив security.autoinstall_commands в false с помощью secator config set security.autoinstall_commands false или SECATOR_SECURITY_AUTOINSTALL_COMMANDS=0.

Чтобы установить все инструменты, выполните:

secator install tools

Установка дополнений (addons)

Для secator доступны дополнения. Подробности смотрите в нашей документации.

Например, дополнение mongodb позволяет отправлять результаты runner'ов в MongoDB.

Узнать больше

Чтобы глубже изучить secator, посмотрите:

• Нашу полную документацию
• Наше вводное видеоурок
• Нашу статью на Medium
• Следите за нами в социальных сетях: @freelabz в Twitter и @FreeLabz на YouTube

Статистика