GEMINI.md

Инструкция для Агента: Инструмент "nmap_scanner"

Описание

Этот инструмент предоставляет прямой доступ к сетевому сканеру Nmap для проведения разведки и обнаружения хостов в сети. Он относится к типу UTILITY. Используй его для анализа сетевой безопасности, инвентаризации устройств и проверки открытых портов.

Функции

nmap_scanner:run_scan

Запускает детальное сканирование Nmap на указанные цели. Позволяет гибко настраивать тип сканирования, определять службы и версии ПО.

Параметры:

• targets (str): Цели для сканирования (IP-адрес, домен, CIDR-диапазон). Например: '192.168.1.1', 'scanme.nmap.org', '10.0.0.0/24'. (обязательный)
• ports (str): Порты для сканирования. Например: '21-25,80,443', '1-1024'. (обязательный)
• arguments (str): Дополнительные аргументы командной строки Nmap. Например: '-sV -sC' для определения версий и запуска скриптов, или '-A' для агрессивного сканирования. (обязательный)

Возвращает: dict - Результат сканирования в формате JSON, содержащий информацию о хостах, их состоянии, открытых портах, службах и версиях.

---

nmap_scanner:host_discovery

Быстро обнаруживает активные (включенные) хосты в указанной сети с помощью 'ping scan' (-sn), не проводя полного сканирования портов.

Параметры:

• network_cidr (str): Сетевой диапазон в формате CIDR для обнаружения хостов. Например: '192.168.1.0/24'. (обязательный)

Возвращает: list - Список IP-адресов активных хостов, обнаруженных в сети.

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

ВАЖНО: Всегда используй формат nmap_scanner:имя_функции().

Пример 1: Обнаружение всех активных устройств в локальной сети

nmap_scanner:host_discovery(network_cidr="192.168.0.0/24")

Пример 2: Быстрое сканирование популярных портов на конкретном хосте

nmap_scanner:run_scan(targets="192.168.1.1", ports="1-1024", arguments="-T4")

Пример 3: Агрессивное сканирование веб-сервера для определения ОС, служб и уязвимостей

nmap_scanner:run_scan(targets="scanme.nmap.org", ports="80,443", arguments="-A -v")