fortinet.fortimanager.fmgr_waf_profile – Настройка брандмауэра веб-приложений.

Примечание

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

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

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

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

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

Обзор

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

Параметры

Параметр				Варианты/Значения по умолчанию	Комментарии
adom строка / обязательный					параметр (adom) в запрошенном URL
bypass_validation булево				Варианты: нет ← да	устанавливается в True только при расхождении схемы модуля со структурой API FortiManager, модуль продолжает выполнение без проверки параметров
rc_failed список / элементы=строка					список кодов rc, при которых условия выполнения будут отменены
rc_succeeded список / элементы=строка					список кодов rc, при которых условия выполнения будут выполнены
state строка / обязательный				Варианты: present absent	директива для создания, обновления или удаления объекта
waf_profile словарь					настройка параметров верхнего уровня
	comment строка				Комментарий.
	extended-log строка			Варианты: disable enable	Включить/выключить расширенное ведение журнала.
	external строка			Варианты: disable enable	Отключить/Включить внешнюю инспекцию HTTP.
	name строка				Имя профиля WAF.
	url-access список / элементы=строка				нет описания
		access-pattern список / элементы=строка			нет описания
			id целое число		Идентификатор шаблона доступа к URL.
			negate строка	Варианты: disable enable	Включить/выключить отрицание совпадения.
			pattern строка		Шаблон URL.
			regex строка	Варианты: disable enable	Включить/выключить соответствие шаблону на основе регулярных выражений.
			srcaddr строка		Исходный адрес.
		action строка		Варианты: bypass permit block	Действие.
		address строка			Адрес хоста.
		id целое число			Идентификатор доступа к URL.
		log строка		Варианты: disable enable	Включить/выключить ведение журнала.
		severity строка		Варианты: low medium high	Уровень серьезности.
workspace_locking_adom строка					adom для блокировки при работе в режиме рабочей области FortiManager, значение может быть глобальным и другими, включая root
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: Web application firewall configuration.
     fmgr_waf_profile:
        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>
        state: <value in [present, absent]>
        waf_profile:
           comment: <value of string>
           extended-log: <value in [disable, enable]>
           external: <value in [disable, enable]>
           name: <value of string>
           url-access:
             -
                 access-pattern:
                   -
                       id: <value of integer>
                       negate: <value in [disable, enable]>
                       pattern: <value of string>
                       regex: <value in [disable, enable]>
                       srcaddr: <value of string>
                 action: <value in [bypass, permit, block]>
                 address: <value of string>
                 id: <value of integer>
                 log: <value in [disable, enable]>
                 severity: <value in [low, medium, high]>

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

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

Ключ	Возвращаемое значение	Описание
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_waf_profile_module.html