fortinet.fortimanager.fmgr_pkg_firewall_interfacepolicy – Настройка политик интерфейсов IPv4.

Примечание

Этот плагин входит в коллекцию fortinet.fortimanager (версия 2.0.1).

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

Для использования в книге задач укажите: fortinet.fortimanager.fmgr_pkg_firewall_interfacepolicy.

Новое в версии 2.10: модуля fortinet.fortimanager

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

Обзор

Этот модуль позволяет настроить устройство FortiManager.
Примеры включают все параметры и значения, которые необходимо скорректировать в источниках данных перед использованием.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно			параметр (adom) в запрошенном URL
bypass_validation логическое		Варианты: нет ← да	устанавливается в значение True только при расхождениях схемы модуля со структурой API FortiManager. Модуль продолжает выполняться без проверки параметров
pkg строка / обязательно			параметр (pkg) в запрошенном URL
pkg_firewall_interfacepolicy словарь			установленные параметры верхнего уровня
	address-type строка	Варианты: ipv4 ipv6	без описания
	application-list строка		Имя списка приложений.
	application-list-status строка	Варианты: отключить включить	Включение/выключение управления приложениями.
	av-profile строка		Профиль антивируса.
	av-profile-status строка	Варианты: отключить включить	Включение/выключение антивируса.
	comments строка		Комментарии.
	dlp-sensor строка		Имя датчика DLP.
	dlp-sensor-status строка	Варианты: отключить включить	Включение/выключение DLP.
	dsri строка	Варианты: отключить включить	Включение/выключение DSRI.
	dstaddr строка		Объект адреса для ограничения мониторинга трафика на сетевой трафик, отправленный по указанному адресу или диапазону.
	interface строка		Имя отслеживаемого интерфейса из доступных интерфейсов.
	ips-sensor строка		Имя датчика IPS.
	ips-sensor-status строка	Варианты: отключить включить	Включение/выключение IPS.
	label строка		Метка.
	logtraffic строка	Варианты: отключить все utm	Тип протоколирования, используемый в этой политике (Варианты: все \| utm \| отключить, По умолчанию: utm).
	policyid целое число		Идентификатор политики.
	scan-botnet-connections строка	Варианты: отключить заблокировать мониторинг	Включение/выключение сканирования соединений с серверами ботнета.
	service строка		Объект службы из доступных вариантов.
	spamfilter-profile строка		Профиль антиспама.
	spamfilter-profile-status строка	Варианты: отключить включить	Включение/выключение антиспама.
	srcaddr строка		Объект адреса для ограничения мониторинга трафика на сетевой трафик, отправленный с указанного адреса или диапазона.
	status строка	Варианты: отключить включить	Включение/выключение этой политики.
	webfilter-profile строка		Профиль веб-фильтра.
	webfilter-profile-status строка	Варианты: отключить включить	Включение/выключение веб-фильтрации.
rc_failed список / элементы=строка			список кодов rc, при которых условия будут считаться выполненными с ошибкой
rc_succeeded список / элементы=строка			список кодов rc, при которых условия будут считаться выполненными успешно
state строка / обязательно		Варианты: present absent	направление для создания, обновления или удаления объекта
workspace_locking_adom строка			adom для блокировки при работе FortiManager в режиме рабочего пространства, значение может быть глобальным и другими, включая корневой
workspace_locking_timeout целое число		По умолчанию: 300	максимальное время в секундах ожидания освобождения блокировки рабочего пространства другим пользователем

Примечания

Примечание

Поддерживается работа в режиме блокировки рабочего пространства в этом модуле FortiManager, параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout помогают в этом.
Для создания или обновления объекта используйте директиву state present.
Для удаления объекта используйте директиву state absent.
Обычно выполнение одного модуля может завершиться ошибкой при возвращении ненулевого rc. Вы также можете переопределить условия завершения ошибкой или успешного завершения с помощью параметров rc_failed и rc_succeeded

Примеры

- hosts: fortimanager-inventory
  collections:
    - fortinet.fortimanager
  connection: httpapi
  vars:
     ansible_httpapi_use_ssl: True
     ansible_httpapi_validate_certs: False
     ansible_httpapi_port: 443
  tasks:
   - name: Configure IPv4 interface policies.
     fmgr_pkg_firewall_interfacepolicy:
        bypass_validation: False
        workspace_locking_adom: <value in [global, custom adom including root]>
        workspace_locking_timeout: 300
        rc_succeeded: [0, -2, -3, ...]
        rc_failed: [-2, -3, ...]
        adom: <your own value>
        pkg: <your own value>
        state: <value in [present, absent]>
        pkg_firewall_interfacepolicy:
           address-type: <value in [ipv4, ipv6]>
           application-list: <value of string>
           application-list-status: <value in [disable, enable]>
           av-profile: <value of string>
           av-profile-status: <value in [disable, enable]>
           comments: <value of string>
           dlp-sensor: <value of string>
           dlp-sensor-status: <value in [disable, enable]>
           dsri: <value in [disable, enable]>
           dstaddr: <value of string>
           interface: <value of string>
           ips-sensor: <value of string>
           ips-sensor-status: <value in [disable, enable]>
           label: <value of string>
           logtraffic: <value in [disable, all, utm]>
           policyid: <value of integer>
           scan-botnet-connections: <value in [disable, block, monitor]>
           service: <value of string>
           spamfilter-profile: <value of string>
           spamfilter-profile-status: <value in [disable, enable]>
           srcaddr: <value of string>
           status: <value in [disable, enable]>
           webfilter-profile: <value of string>
           webfilter-profile-status: <value in [disable, enable]>

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

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

Ключ	Возвращаемое значение	Описание
request_url строка	всегда	Полный запрос url Пример: /sys/login/user
response_code целое число	всегда	Статус запроса api
response_message строка	всегда	Описание ответа api Пример: OK.

Авторы

Link Zheng (@chillancezen)
Jie Xue (@JieX19)
Frank Shen (@fshen01)
Hongbin Lu (@fgtdev-hblu)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/fortinet/fortimanager/fmgr_pkg_firewall_interfacepolicy_module.html