community.network.fmgr_secprof_appctrl – Управление профилями безопасности управления приложениями

Примечание

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

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

Для использования в книге задач укажите: community.network.fmgr_secprof_appctrl.

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
adom строка	По умолчанию: "root"	ADOM, к которому должна принадлежать конфигурация.
app_replacemsg строка	Варианты: disable enable	Включить/отключить сообщения замены для заблокированных приложений. вариант \| disable \| Отключить сообщения замены для заблокированных приложений. вариант \| enable \| Включить сообщения замены для заблокированных приложений.
comment строка		комментарии
deep_app_inspection строка	Варианты: disable enable	Включить/отключить глубокий анализ приложений. вариант \| disable \| Отключить глубокий анализ приложений. вариант \| enable \| Включить глубокий анализ приложений.
entries строка		ТОЛЬКО ДЛЯ ЭКСПЕРТОВ! НЕОБХОДИМО ЗНАТЬ API FMGR JSON! Список нескольких дочерних объектов для добавления. Ожидается список словарей. Словари должны использовать параметры API FortiManager, а не ansible, перечисленные ниже. Если предоставлено, все другие префиксные подпараметры ИГНОРИРУЮТСЯ. Этот объект ВЗАИМНО ИСКЛЮЧАЕТ свои варианты. Ожидается, что вы знаете, что делаете с этими параметрами списков, и используете руководство по API JSON. В СЛУЧАЕ СОМНЕНИЙ, ИЗБЕГАЙТЕ ИСПОЛЬЗОВАНИЯ ЭТОГО ПАРАМЕТРА И ИСПОЛЬЗУЙТЕ ПОДВАРИАНТЫ НИЖЕ, ЧТОБЫ СОЗДАТЬ ОБЪЕКТЫ С МНОЖЕСТВОМ ЗАДАЧ
entries_action строка	Варианты: pass block reset	Пропустить или заблокировать трафик или сбросить соединение для трафика из этого приложения. вариант \| pass \| Пропустить или разрешить соответствующий трафик. вариант \| block \| Заблокировать или отбросить соответствующий трафик. вариант \| reset \| Сбросить сеансы для соответствующего трафика.
entries_application строка		Идентификатор разрешенных приложений.
entries_behavior строка		Фильтр поведения приложения.
entries_category строка		Список идентификаторов категорий.
entries_log строка	Варианты: disable enable	Включить/отключить ведение журнала для этого списка приложений. вариант \| disable \| Отключить ведение журнала. вариант \| enable \| Включить ведение журнала.
entries_log_packet строка	Варианты: disable enable	Включить/отключить ведение журнала пакетов. вариант \| disable \| Отключить ведение журнала пакетов. вариант \| enable \| Включить ведение журнала пакетов.
entries_parameters_value строка		Значение параметра.
entries_per_ip_shaper строка		Устройство формирования трафика на уровне IP.
entries_popularity строка	Варианты: 1 2 3 4 5	Фильтр популярности приложения (1—5, от наименее к наиболее популярному). Варианты на основе флагов. Укажите несколько в формате списка. флаг \| 1 \| Уровень популярности 1. флаг \| 2 \| Уровень популярности 2. флаг \| 3 \| Уровень популярности 3. флаг \| 4 \| Уровень популярности 4. флаг \| 5 \| Уровень популярности 5.
entries_protocols строка		Фильтр протоколов приложений.
entries_quarantine строка	Варианты: none attacker	Метод карантина. вариант \| none \| Карантин отключен. вариант \| attacker \| Блокировать весь трафик, отправленный с IP-адреса злоумышленника. IP-адрес злоумышленника также добавляется в список запрещенных пользователей. Адрес цели не затронут.
entries_quarantine_expiry строка		Продолжительность карантина. (Формат Требуется карантин, установленный на attacker.
entries_quarantine_log строка	Варианты: disable enable	Включить/отключить ведение журнала карантина. вариант \| disable \| Отключить ведение журнала карантина. вариант \| enable \| Включить ведение журнала карантина.
entries_rate_count строка		Количество лимита.
entries_rate_duration строка		Продолжительность (сек) лимита.
entries_rate_mode строка	Варианты: periodical continuous	Режим ограничения скорости. вариант \| periodical \| Разрешить заданное количество пакетов каждые rate-duration. вариант \| continuous \| Заблокировать пакеты, как только будет достигнут лимит.
entries_rate_track строка	Варианты: none src-ip dest-ip dhcp-client-mac dns-domain	Отслеживать поле протокола пакета. вариант \| none \| вариант \| src-ip \| Источник IP. вариант \| dest-ip \| Целевой IP. вариант \| dhcp-client-mac \| DHCP-клиент. вариант \| dns-domain \| Домен DNS.
entries_risk строка		Риск или воздействие, связанные с разрешением трафика из этого приложения (1—5); (Низкий, Высокий, Средний, Высокий и Критический).
entries_session_ttl строка		Время жизни сеанса (0 = по умолчанию).
entries_shaper строка		Формирователь трафика.
entries_shaper_reverse строка		Обратный формирователь трафика.
entries_sub_category строка		Список идентификаторов подкатегорий приложений.
entries_technology строка		Фильтр технологии приложения.
entries_vendor строка		Фильтр поставщика приложения.
extended_log строка	Варианты: disable enable	Включить/отключить расширенное ведение журнала. вариант \| disable \| Отключить настройку. вариант \| enable \| Включить настройку.
mode строка	Варианты: add ← set delete update	Устанавливает один из трех режимов управления объектом. Разрешает использование мягких добавлений вместо перезаписи существующих значений
name строка		Имя списка.
options строка	Варианты: allow-dns allow-icmp allow-http allow-ssl allow-quic	ОПИСАНИЕ НЕ ОБНАРУЖЕНО ВВЕДИТЕ РУЧНО Варианты на основе флагов. Укажите несколько в формате списка. флаг \| allow-dns \| Разрешить DNS. флаг \| allow-icmp \| Разрешить ICMP. флаг \| allow-http \| Разрешить общий веб-серфинг HTTP. флаг \| allow-ssl \| Разрешить общую SSL-связь. флаг \| allow-quic \| Разрешить QUIC.
other_application_action строка	Варианты: pass block	Действие для других приложений. вариант \| pass \| Разрешить сеансы, соответствующие приложению в этом списке приложений. вариант \| block \| Заблокировать сеансы, соответствующие приложению в этом списке приложений.
other_application_log строка	Варианты: disable enable	Включить/отключить ведение журнала для других приложений. вариант \| disable \| Отключить ведение журнала для других приложений. вариант \| enable \| Включить ведение журнала для других приложений.
p2p_black_list строка	Варианты: skype edonkey bittorrent	ОПИСАНИЕ НЕ ОБНАРУЖЕНО ВВЕДИТЕ РУЧНО Варианты на основе флагов. Укажите несколько в формате списка. флаг \| skype \| Skype. флаг \| edonkey \| Edonkey. флаг \| bittorrent \| BitTorrent.
replacemsg_group строка		Группа сообщений замены.
unknown_application_action строка	Варианты: pass block	Пропустить или заблокировать трафик от неизвестных приложений. вариант \| pass \| Пропустить или разрешить неизвестные приложения. вариант \| block \| Отбросить или заблокировать неизвестные приложения.
unknown_application_log строка	Варианты: disable enable	Включить/отключить ведение журнала для неизвестных приложений. вариант \| disable \| Отключить ведение журнала для неизвестных приложений. вариант \| enable \| Включить ведение журнала для неизвестных приложений.

Примечания

Примечание

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

Примеры

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

- name: CREATE Profile
  community.network.fmgr_secprof_appctrl:
    name: "Ansible_Application_Control_Profile"
    comment: "Created by Ansible Module TEST"
    mode: "set"
    entries: [{
              action: "block",
              log: "enable",
              log-packet: "enable",
              protocols: ["1"],
              quarantine: "attacker",
              quarantine-log: "enable",
              },
              {action: "pass",
              category: ["2","3","4"]},
            ]

Значения возврата

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

Ключ	Возвращаемое значение	Описание
api_result строка	всегда	полный ответ 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_appctrl_module.html