fortinet.fortimanager.fmgr_waf_profile_constraint_exception – Исключение ограничения HTTP.

Примечание

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

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

Чтобы использовать его в книге задач, укажите: fortinet.fortimanager.fmgr_waf_profile_constraint_exception.

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

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно			параметр (adom) в запрошенном URL-адресе
bypass_validation логический тип		Варианты: нет ← да	устанавливается в True только тогда, когда схема модуля отличается от структуры API FortiManager; модуль продолжает выполнение без проверки параметров
profile строка / обязательно			параметр (profile) в запрошенном URL-адресе
rc_failed список / элементы=строка			список кодов rc, при которых будут переопределены условия для отказа
rc_succeeded список / элементы=строка			список кодов rc, при которых будут переопределены условия для успеха
state строка / обязательно		Варианты: present absent	направление для создания, обновления или удаления объекта
waf_profile_constraint_exception словарь			установленные параметры верхнего уровня
	address строка		Адрес хоста.
	content-length строка	Варианты: выключено включено	Длина HTTP содержимого в запросе.
	header-length строка	Варианты: выключено включено	Длина HTTP заголовка в запросе.
	hostname строка	Варианты: выключено включено	Включение/выключение проверки имени хоста.
	id целое число		Идентификатор исключения.
	line-length строка	Варианты: выключено включено	Длина HTTP строки в запросе.
	malformed строка	Варианты: выключено включено	Включение/выключение проверки некорректного HTTP запроса.
	max-cookie строка	Варианты: выключено включено	Максимальное количество cookie в HTTP запросе.
	max-header-line строка	Варианты: выключено включено	Максимальное количество строк HTTP заголовка.
	max-range-segment строка	Варианты: выключено включено	Максимальное количество фрагментов в строке HTTP диапазона.
	max-url-param строка	Варианты: выключено включено	Максимальное количество параметров в URL.
	method строка	Варианты: выключено включено	Включение/выключение проверки HTTP метода.
	param-length строка	Варианты: выключено включено	Максимальная длина параметра в URL, HTTP POST запросе или HTTP теле.
	pattern строка		Шаблон URL.
	regex строка	Варианты: выключено включено	Включение/выключение проверки шаблона на основе регулярных выражений.
	url-param-length строка	Варианты: выключено включено	Максимальная длина параметра в URL.
	version строка	Варианты: выключено включено	Включение/выключение проверки версии HTTP.
workspace_locking_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: HTTP constraint exception.
     fmgr_waf_profile_constraint_exception:
        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>
        profile: <your own value>
        state: <value in [present, absent]>
        waf_profile_constraint_exception:
           address: <value of string>
           content-length: <value in [disable, enable]>
           header-length: <value in [disable, enable]>
           hostname: <value in [disable, enable]>
           id: <value of integer>
           line-length: <value in [disable, enable]>
           malformed: <value in [disable, enable]>
           max-cookie: <value in [disable, enable]>
           max-header-line: <value in [disable, enable]>
           max-range-segment: <value in [disable, enable]>
           max-url-param: <value in [disable, enable]>
           method: <value in [disable, enable]>
           param-length: <value in [disable, enable]>
           pattern: <value of string>
           regex: <value in [disable, enable]>
           url-param-length: <value in [disable, enable]>
           version: <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_waf_profile_constraint_exception_module.html