Spec-Zone.ru › Ansible 2.10

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]
cache = no

env:ANSIBLE_INVENTORY_CACHE
Включить/выключить кэширование исходных данных инвентаризации, для работы требуется плагин кэширования.
cache_connection
строка
записи ini:

[defaults]
fact_caching_connection = None

[inventory]
cache_connection = None

env:ANSIBLE_CACHE_PLUGIN_CONNECTION
env:ANSIBLE_INVENTORY_CACHE_CONNECTION
Данные или путь к подключению к кэшу, для подробностей смотрите документацию по плагину кэширования.
cache_plugin
строка
По умолчанию:
"memory"
записи ini:

[defaults]
fact_caching = memory

[inventory]
cache_plugin = memory

env:ANSIBLE_CACHE_PLUGIN
env:ANSIBLE_INVENTORY_CACHE_PLUGIN
Плагин кэширования для использования исходных данных инвентаризации.
cache_prefix
строка
По умолчанию:
"ansible_inventory_"
записи ini:

[default]
fact_caching_prefix = ansible_inventory_

[inventory]
cache_prefix = ansible_inventory_

env:ANSIBLE_CACHE_PLUGIN_PREFIX
env:ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX
Префикс для использования в файлах/таблицах плагина кэширования
cache_timeout
целое число
По умолчанию:
3600
записи ini:

[defaults]
fact_caching_timeout = 3600

[inventory]
cache_timeout = 3600

env:ANSIBLE_CACHE_PLUGIN_TIMEOUT
env:ANSIBLE_INVENTORY_CACHE_TIMEOUT
Срок действия кэша в секундах
compose
словарь
По умолчанию:
{}
Создание переменных из выражений jinja2.
exclude
список / элементы=строка
список адресов для исключения
groups
словарь
По умолчанию:
{}
Добавление хостов в группу на основе условных выражений Jinja2.
ipv4
логический тип
    Варианты:
  • нет
  • да ←
использовать адреса типа IPv4
ipv6
логический тип
    Варианты:
  • нет
  • да ←
использовать адреса типа IPv6
keyed_groups
список / элементы=строка
По умолчанию:
[]
Добавление хостов в группу на основе значений переменной.
plugin
строка / обязательный
    Варианты:
  • nmap
  • community.general.nmap
токен, гарантирующий, что это исходный файл для плагина '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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API