community.network.fmgr_secprof_ips – Управление профилями безопасности IPS в FortiManager

Примечание

Этот плагин является частью коллекции community.network (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.network.

Для использования в плейбуке укажите: community.network.fmgr_secprof_ips.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление профилями безопасности IPS в FortiManager

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
adom строка	По умолчанию: "root"	ADOM, к которому должна принадлежать конфигурация.
block_malicious_url строка	Варианты: disable enable	Включить/выключить блокировку вредоносных URL.
comment строка		Комментарий.
entries строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если предоставлены, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект является ВЗАИМНО ИСКЛЮЧАЮЩИМ со своими вариантами. Ожидается, что вы понимаете, что делаете с этими параметрами списка, и используете руководство по JSON API. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДВАРИАНТЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С МНОЖЕСТВОМ ЗАДАЧ
entries_action строка	Варианты: pass block reset default	Действие, выполняемое с трафиком, в котором обнаружены подписи.
entries_application строка		Приложения, которые нужно защитить. set application ? отображает доступные приложения. all включает все приложения. other включает все неперечисленные приложения.
entries_exempt_ip_dst_ip строка		IP-адрес назначения и маска сети.
entries_exempt_ip_src_ip строка		IP-адрес источника и маска сети.
entries_location строка		Защитить трафик клиента или сервера.
entries_log строка	Варианты: disable enable	Включить/выключить ведение журнала подписей, включенных в фильтр.
entries_log_attack_context строка	Варианты: disable enable	Включить/выключить ведение журнала контекста атаки\| буфер URL, буфер заголовков, буфер тела, буфер пакета.
entries_log_packet строка	Варианты: disable enable	Включить/выключить ведение журнала пакетов. Включите для сохранения пакета, который вызывает фильтр. Вы можете загрузить пакеты в формате pcap для диагностики.
entries_os строка		Операционные системы, которые необходимо защитить. all включает все операционные системы. other включает все неперечисленные операционные системы.
entries_protocol строка		Протоколы, которые необходимо проверить. set protocol ? отображает доступные протоколы. all включает все протоколы. other включает все неперечисленные протоколы.
entries_quarantine строка	Варианты: none attacker	Метод карантина.
entries_quarantine_expiry строка		Продолжительность карантина.
entries_quarantine_log строка	Варианты: disable enable	Включить/выключить ведение журнала карантина.
entries_rate_count строка		Счётчик скорости.
entries_rate_duration строка		Продолжительность (сек) скорости.
entries_rate_mode строка	Варианты: periodical continuous	Режим ограничения скорости.
entries_rate_track строка	Варианты: none src-ip dest-ip dhcp-client-mac dns-domain	Отслеживание поля протокола пакета.
entries_rule строка		Идентифицирует предварительно определённые или пользовательские подписи IPS для добавления в сенсор.
entries_severity строка		Относительная серьёзность подписи, от info до critical. Сообщения журнала, создаваемые подписью, включают серьёзность.
entries_status строка	Варианты: disable enable default	Статус подписей, включенных в фильтр. default включает фильтр и использует только фильтры со статусом enable по умолчанию. Фильтры со статусом disable по умолчанию не будут использоваться.
extended_log строка	Варианты: disable enable	Включить/выключить расширенное ведение журнала.
filter строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если предоставлены, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект является ВЗАИМНО ИСКЛЮЧАЮЩИМ со своими вариантами. Ожидается, что вы понимаете, что делаете с этими параметрами списка, и используете руководство по JSON API. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДВАРИАНТЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С МНОЖЕСТВОМ ЗАДАЧ
filter_action строка	Варианты: pass block default reset	Действие выбранных правил.
filter_application строка		Фильтр приложения уязвимости.
filter_location строка		Фильтр местоположения уязвимости.
filter_log строка	Варианты: disable enable	Включить/выключить ведение журнала выбранных правил.
filter_log_packet строка	Варианты: disable enable	Включить/выключить ведение журнала пакетов выбранных правил.
filter_name строка		Имя фильтра.
filter_os строка		Фильтр операционной системы уязвимости.
filter_protocol строка		Фильтр протокола уязвимости.
filter_quarantine строка	Варианты: none attacker	Карантин IP-адреса или интерфейса.
filter_quarantine_expiry строка		Продолжительность карантина в минутах.
filter_quarantine_log строка	Варианты: disable enable	Включить/выключить ведение журнала выбранного карантина.
filter_severity строка		Фильтр серьёзности уязвимости.
filter_status строка	Варианты: disable enable default	Статус выбранных правил.
mode строка	Варианты: add ← set delete update	Устанавливает один из трёх режимов для управления объектом. Позволяет использовать мягкие добавления вместо перезаписи существующих значений
name строка		Имя сенсора.
override строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМЫ ЗНАНИЯ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если предоставлены, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект является ВЗАИМНО ИСКЛЮЧАЮЩИМ со своими вариантами. Ожидается, что вы понимаете, что делаете с этими параметрами списка, и используете руководство по JSON API. В СЛУЧАЕ СОМНЕНИЙ, ИСПОЛЬЗУЙТЕ НИЖЕУКАЗАННЫЕ ПОДВАРИАНТЫ ДЛЯ СОЗДАНИЯ ОБЪЕКТОВ С МНОЖЕСТВОМ ЗАДАЧ
override_action строка	Варианты: pass block reset	Действие правила переопределения.
override_exempt_ip_dst_ip строка		IP-адрес назначения и маска сети.
override_exempt_ip_src_ip строка		IP-адрес источника и маска сети.
override_log строка	Варианты: disable enable	Включить/выключить ведение журнала.
override_log_packet строка	Варианты: disable enable	Включить/выключить ведение журнала пакетов.
override_quarantine строка	Варианты: none attacker	Карантин IP-адреса или интерфейса.
override_quarantine_expiry строка		Продолжительность карантина в минутах.

override_quarantine_log string	Choices: disable enable	Включить/выключить протоколирование выбранной карантинной зоны.
override_rule_id string		ID правила переопределения.
override_status string	Choices: disable enable	Включить/выключить статус правила переопределения.
replacemsg_group string		Группа сообщений замены.

Примечания

Примечание

Полная документация по адресу https://ftnt-ansible-docs.readthedocs.io/en/latest/.

Примеры

- name: DELETE Profile
  community.network.fmgr_secprof_ips:
    name: "Ansible_IPS_Profile"
    comment: "Created by Ansible Module TEST"
    mode: "delete"

- name: CREATE Profile
  community.network.fmgr_secprof_ips:
    name: "Ansible_IPS_Profile"
    comment: "Created by Ansible Module TEST"
    mode: "set"
    block_malicious_url: "enable"
    entries: [{severity: "high", action: "block", log-packet: "enable"}, {severity: "medium", action: "pass"}]

Возвращаемые значения

Общие возвращаемые значения описаны здесь, а следующие являются полями, уникальными для этого модуля:

Ключ	Возвращаемое значение	Описание
api_result string	всегда	полный ответ API, включает код состояния и сообщение

Авторы

Luke Weighall (@lweighall)
Andrew Welsh (@Ghilli3)
Jim Huber (@p4r4n0y1ng)

© 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/network/fmgr_secprof_ips_module.html