Модуль fortinet.fortios.fortios_switch_controller_nac_device — Настройка/список устройств NAC, выявленных на управляемых портах FortiSwitch, соответствующих политике NAC в FortiOS и FortiGate Fortinet.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.3.7).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля требуются дополнительные требования. Подробности см. в разделе Требования.
Для использования в плейбуке укажите: fortinet.fortios.fortios_switch_controller_nac_device.
Добавлена в fortinet.fortios 2.0.0
Описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), позволяя пользователю устанавливать и изменять функцию switch_controller и категорию nac_device. Примеры включают все параметры и значения, которые необходимо настроить в источниках данных перед использованием. Тестировалось с FOS v6.0.0
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- ansible>=2.15
Параметры
Параметр | Комментарии |
|---|---|
access_token строка | Аутентификация на основе токена. Сгенерировано в GUI Fortigate. |
enable_log булево | Включить/выключить ведение журнала для задачи. Варианты:
|
member_path строка | Путь к атрибуту члена для работы. Разделяется с помощью символа косой черты, если атрибутов больше одного. Параметр, помеченный member_path, подходит для выполнения операций с членами. |
member_state строка | Добавить или удалить члена по указанному пути к атрибуту. Когда member_state указан, параметр state игнорируется. Варианты:
|
state строка / обязательно | Указывает, нужно ли создать или удалить объект. Варианты:
|
switch_controller_nac_device словарь | Настройка/список устройств NAC, выявленных на управляемых портах FortiSwitch, соответствующих политике NAC. |
|
description строка |
Описание выявленного устройства NAC. |
|
id целое число / обязательно |
Идентификатор устройства. См. <a href=’#notes’>Примечания</a>. |
|
last_known_port строка |
Управляемый порт FortiSwitch, на котором последнее устройство NAC было выявлено. |
|
last_known_switch строка |
Управляемый FortiSwitch, на котором последнее устройство NAC было выявлено. Источник switch-controller.managed-switch.switch-id. |
|
last_seen целое число |
Последнее обнаружение устройства. |
|
mac строка |
MAC-адрес выявленного устройства NAC. |
|
mac_policy строка |
Политика MAC, которая должна применяться к этому выявленному устройству NAC. Источник switch-controller.mac-policy.name. |
|
matched_nac_policy строка |
Сопоставленная политика NAC для выявленного устройства NAC. Источник user.nac-policy.name. |
|
port_policy строка |
Политика порта, которая должна применяться к этому выявленному устройству NAC. Источник switch-controller.port-policy.name. |
|
status строка |
Статус выявленного устройства NAC. Установите enable, чтобы разрешить устройство NAC. Варианты:
|
vdom строка | Виртуальная область, определённая ранее. VDOM — виртуальная инстанция FortiGate, которую можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Мы настоятельно рекомендуем использовать собственное значение в качестве идентификатора вместо 0. Хотя «0» — это специальный заполняющий элемент, который позволяет бэкенду назначать последний доступный номер для объекта, он имеет ограничения. Более подробную информацию см. в разделе «Вопросы и ответы».
- Устаревший fortiosapi был заменен, httpapi — предпочтительный способ запуска playbook
Примеры
- name: Configure/list NAC devices learned on the managed FortiSwitch ports which matches NAC policy.
fortinet.fortios.fortios_switch_controller_nac_device:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
switch_controller_nac_device:
description: "<your_own_value>"
id: "4"
last_known_port: "<your_own_value>"
last_known_switch: "<your_own_value> (source switch-controller.managed-switch.switch-id)"
last_seen: "2147483647"
mac: "<your_own_value>"
mac_policy: "<your_own_value> (source switch-controller.mac-policy.name)"
matched_nac_policy: "<your_own_value> (source user.nac-policy.name)"
port_policy: "<your_own_value> (source switch-controller.port-policy.name)"
status: "enable"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа fortigate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для подготовки контента в FortiGate Возвращается: всегда Пример: |
http_status string | Последний результат, полученный от FortiGate при последней выполненной операции Возвращается: всегда Пример: |
mkey string | Главный ключ (идентификатор), использованный в последнем вызове FortiGate Возвращается: успех Пример: |
name string | Имя таблицы, используемой для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, используемой для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер ревизии Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Указание результата операции Возвращается: всегда Пример: |
vdom string | Используемый виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/fortinet/fortios/fortios_switch_controller_nac_device_module.html
