Модуль fortinet.fortios.fortios_user_nac_policy — настройка шаблона сопоставления политики NAC для выявления соответствующих устройств NAC в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные компоненты. Подробнее см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_user_nac_policy.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функций user и категории nac_policy. В примерах приведены все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Проверено на FOS v6.0.0
Требования
На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Токен создаётся в графическом интерфейсе FortiGate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
member_path string | Путь к атрибуту элемента, над которым выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр с пометкой member_path можно использовать для выполнения операции над элементом. |
member_state string | Добавить или удалить элемент по указанному пути атрибута. Если задан member_state, параметр state игнорируется. Варианты:
|
state string / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
user_nac_policy dictionary | Настройка шаблона сопоставления политики NAC для выявления соответствующих устройств NAC. |
|
category string |
Категория политики NAC. Варианты:
|
|
description string |
Описание шаблона сопоставления политики NAC. |
|
ems_tag string |
Тег EMS для сопоставления с политикой NAC. Источник: firewall.address.name. |
|
family string |
Семейство для сопоставления с политикой NAC. |
|
firewall_address string |
Динамический адрес брандмауэра, связываемый с MAC-адресом, соответствующим этой политике. Источник: firewall.address.name. |
|
fortivoice_tag string |
Тег FortiVoice для сопоставления с политикой NAC. Источник: firewall.address.name. |
|
host string |
Имя хоста для сопоставления с политикой NAC. |
|
hw_vendor string |
Производитель оборудования для сопоставления с политикой NAC. |
|
hw_version string |
Версия оборудования для сопоставления с политикой NAC. |
|
mac string |
MAC-адрес для сопоставления с политикой NAC. |
|
match_period integer |
Количество дней хранения сопоставленных устройств (0 — хранить всегда) |
|
match_remove string |
Параметры удаления устройств с совпавшими переопределениями. Варианты:
|
|
match_type string |
Сопоставление и сохранение устройств на основе их типа. Варианты:
|
|
name string / обязательный |
Имя политики NAC. |
|
os string |
Операционная система для сопоставления с политикой NAC. |
|
severity list / элементы=dictionary |
Списки уровней серьёзности уязвимостей устройств для сопоставления с политикой NAC. |
|
severity_num integer / обязательный |
Укажите несколько уровней серьёзности: 0 = информация, 1 = низкий, …, 4 = критический. См. <a href=’#notes’>Примечания</a>. |
|
src string |
Источник для сопоставления с политикой NAC. |
|
ssid_policy string |
Политика SSID, применяемая к сопоставленной политике NAC. Источник: wireless-controller.ssid-policy.name. |
|
status string |
Включить или отключить политику NAC. Варианты:
|
|
sw_version string |
Версия программного обеспечения для сопоставления с политикой NAC. |
|
switch_auto_auth string |
Автоматическая авторизация устройства NAC при обнаружении и совпадении с политикой NAC. Варианты:
|
|
switch_fortilink string |
Интерфейс FortiLink, к которому относится эта политика NAC. Источник: system.interface.name. |
|
switch_group list / элементы=dictionary |
Список управляемых групп FortiSwitch, к которым можно применить политику NAC. |
|
name string / обязательный |
Имя управляемой группы FortiSwitch из доступных вариантов. Источник: switch-controller.switch-group.name. |
|
switch_mac_policy string |
Действие политики MAC-адресов коммутатора, применяемое к сопоставленной политике NAC. Источник: switch-controller.mac-policy.name. |
|
switch_port_policy string |
Политика портов коммутатора, применяемая к сопоставленной политике NAC. Источник: switch-controller.port-policy.name. |
|
switch_scope list / элементы=dictionary |
Список управляемых коммутаторов FortiSwitch, к которым можно применить политику NAC. |
|
switch_id string / обязательный |
Имя управляемого коммутатора FortiSwitch из доступных вариантов. Источник: switch-controller.managed-switch.switch-id. |
|
type string |
Тип для сопоставления с политикой NAC. |
|
user string |
Пользователь для сопоставления с политикой NAC. |
|
user_group string |
Группа пользователей для сопоставления с политикой NAC. Источник: user.group.name. |
vdom string | Виртуальный домен из числа ранее определённых. VDOM — это виртуальный экземпляр FortiGate, который можно настраивать и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Устаревшая библиотека fortiosapi больше не рекомендуется; предпочтительный способ запуска плейбуков — httpapi
- Модуль поддерживает check_mode.
Примеры
- name: Configure NAC policy matching pattern to identify matching NAC devices.
fortinet.fortios.fortios_user_nac_policy:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
user_nac_policy:
category: "device"
description: "<your_own_value>"
ems_tag: "<your_own_value> (source firewall.address.name)"
family: "<your_own_value>"
firewall_address: "<your_own_value> (source firewall.address.name)"
fortivoice_tag: "<your_own_value> (source firewall.address.name)"
host: "myhostname"
hw_vendor: "<your_own_value>"
hw_version: "<your_own_value>"
mac: "<your_own_value>"
match_period: "0"
match_remove: "default"
match_type: "dynamic"
name: "default_name_16"
os: "<your_own_value>"
severity:
-
severity_num: "<you_own_value>"
src: "<your_own_value>"
ssid_policy: "<your_own_value> (source wireless-controller.ssid-policy.name)"
status: "enable"
sw_version: "<your_own_value>"
switch_auto_auth: "global"
switch_fortilink: "<your_own_value> (source system.interface.name)"
switch_group:
-
name: "default_name_27 (source switch-controller.switch-group.name)"
switch_mac_policy: "<your_own_value> (source switch-controller.mac-policy.name)"
switch_port_policy: "<your_own_value> (source switch-controller.port-policy.name)"
switch_scope:
-
switch_id: "<your_own_value> (source switch-controller.managed-switch.switch-id)"
type: "<your_own_value>"
user: "<your_own_value>"
user_group: "<your_own_value> (source user.group.name)"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_user_nac_policy_module.html