community.general.nmap – Использует nmap для поиска узлов для атаки
Примечание
Этот плагин входит в состав коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general
Для использования в книге задач укажите: community.general.nmap
Краткое описание
- Использует файл конфигурации YAML с соответствующим расширением.
Требования
Ниже перечислены требования к локальному контроллеру, на котором выполняется инвентаризация.
- Установлен nmap CLI
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| address строка / обязательный | IP-адрес сети или диапазон IP-адресов для сканирования, можно использовать простой диапазон (10.2.2.15-25) или нотацию CIDR. | ||
| cache логический тип |
| записи ini: [inventory] env:ANSIBLE_INVENTORY_CACHE | Включить/выключить кэширование исходных данных инвентаризации, для работы требуется плагин кэширования. |
| cache_connection строка | записи ini: [defaults] [inventory] env:ANSIBLE_CACHE_PLUGIN_CONNECTION env:ANSIBLE_INVENTORY_CACHE_CONNECTION | Данные или путь к подключению к кэшу, для подробностей смотрите документацию по плагину кэширования. | |
| cache_plugin строка | По умолчанию: "memory" | записи ini: [defaults] [inventory] env:ANSIBLE_CACHE_PLUGIN env:ANSIBLE_INVENTORY_CACHE_PLUGIN | Плагин кэширования для использования исходных данных инвентаризации. |
| cache_prefix строка | По умолчанию: "ansible_inventory_" | записи ini: [default] [inventory] env:ANSIBLE_CACHE_PLUGIN_PREFIX env:ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX | Префикс для использования в файлах/таблицах плагина кэширования |
| cache_timeout целое число | По умолчанию: 3600 | записи ini: [defaults] [inventory] env:ANSIBLE_CACHE_PLUGIN_TIMEOUT env:ANSIBLE_INVENTORY_CACHE_TIMEOUT | Срок действия кэша в секундах |
| compose словарь | По умолчанию: {} | Создание переменных из выражений jinja2. | |
| exclude список / элементы=строка | список адресов для исключения | ||
| groups словарь | По умолчанию: {} | Добавление хостов в группу на основе условных выражений Jinja2. | |
| ipv4 логический тип |
| использовать адреса типа IPv4 | |
| ipv6 логический тип |
| использовать адреса типа IPv6 | |
| keyed_groups список / элементы=строка | По умолчанию: [] | Добавление хостов в группу на основе значений переменной. | |
| plugin строка / обязательный |
| токен, гарантирующий, что это исходный файл для плагина 'nmap'. | |
| ports логический тип |
| Включить/выключить сканирование открытых портов | |
| strict логический тип |
| Если yes считать некорректные записи ошибкой, иначе пропустить и продолжить.Так как в выражениях можно использовать факты, они могут быть не всегда доступны, поэтому по умолчанию эти ошибки игнорируются. |
Примечания
Примечание
- Требуется хотя бы одно из значений ipv4 или ipv6, оба могут быть True, но не оба False.
- TODO: добавить определение ОС
Примеры
# inventory.config file in YAML format plugin: community.general.nmap strict: False address: 192.168.0.0/24
Авторы
- Неизвестно (!UNKNOWN)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/nmap_inventory.html