fortinet.fortimanager.fmgr_firewall_profileprotocoloptions_http — Настройка параметров протокола HTTP.

Примечание

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

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

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

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

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно			параметр (adom) в запрошенном URL
bypass_validation логическое значение		Варианты: нет ← да	устанавливается в True только тогда, когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполнение без проверки параметров
firewall_profileprotocoloptions_http словарь			установленные параметры верхнего уровня
	block-page-status-code целое число		Код, возвращаемый для заблокированных страниц HTTP (только не FortiGuard) (100 – 599, по умолчанию = 403).
	comfort-amount целое число		Объем данных для отправки в передаче для обеспечения комфорта клиента (1 – 10240 байт, по умолчанию = 1).
	comfort-interval целое число		Период времени между началом или последней передачей и следующей передачей данных для обеспечения комфорта клиента (1 – 900 сек, по умолчанию = 10).
	fortinet-bar строка	Варианты: отключить включить	Включить/выключить панель Fortinet в содержимом HTML.
	fortinet-bar-port целое число		Порт для использования панелью Fortinet (1 – 65535, по умолчанию = 8011).
	http-policy строка	Варианты: отключить включить	Включить/выключить проверку политики HTTP.
	inspect-all строка	Варианты: отключить включить	Включить/выключить проверку всех портов для протокола.
	options список / элементы=строка	Варианты: oversize chunkedbypass clientcomfort no-content-summary servercomfort	нет описания
	oversize-limit целое число		Максимальный размер файла в оперативной памяти, который можно сканировать (1 – 383 МБ, по умолчанию = 10).
	ports целое число		нет описания
	post-lang список / элементы=строка	Варианты: … (Список значений остается без изменений) …	нет описания
	range-block строка	Варианты: отключить включить	Включить/выключить блокировку частичных загрузок.
	retry-count целое число		Количество попыток повторного подключения HTTP (0 – 100, по умолчанию = 0).
	scan-bzip2 строка	Варианты: отключить включить	Включить/выключить сканирование файлов, сжатых в формате BZip2.
	status строка	Варианты: отключить включить	Включить/выключить активный статус сканирования для этого протокола.
	streaming-content-bypass строка	Варианты: отключить включить	Включить/выключить обход потокового содержимого из буферизации.
	strip-x-forwarded-for строка	Варианты: отключить включить	Включить/выключить удаление заголовка HTTP X-Forwarded-For.
	switching-protocols строка	Варианты: пропустить заблокировать	Пропустить сканирование или заблокировать подключение, которое пытается изменить протокол.
	uncompressed-nest-limit целое число		Максимальное количество вложенных уровней сжатия, которые можно разархивировать и сканировать (2 – 100, по умолчанию = 12).
	uncompressed-oversize-limit целое число		Максимальный размер разархивированного файла в оперативной памяти, который можно сканировать (0 – 383 МБ, 0 = без ограничений, по умолчанию = 10).
profile-protocol-options строка / обязательно			параметр (profile-protocol-options) в запрошенном URL
rc_failed список / элементы=строка			список кодов rc, с которыми будут переопределены условия для сбоя
rc_succeeded список / элементы=строка			список кодов rc, с которыми будут переопределены условия для успеха
state строка / обязательно		Варианты: present absent	директива для создания, обновления или удаления объекта
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: Configure HTTP protocol options.
     fmgr_firewall_profileprotocoloptions_http:
        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-protocol-options: <your own value>
        firewall_profileprotocoloptions_http:
           block-page-status-code: <value of integer>
           comfort-amount: <value of integer>
           comfort-interval: <value of integer>
           fortinet-bar: <value in [disable, enable]>
           fortinet-bar-port: <value of integer>
           http-policy: <value in [disable, enable]>
           inspect-all: <value in [disable, enable]>
           options:
             - oversize
             - chunkedbypass
             - clientcomfort
             - no-content-summary
             - servercomfort
           oversize-limit: <value of integer>
           ports: <value of integer>
           post-lang:
             - jisx0201
             - jisx0208
             - jisx0212
             - gb2312
             - ksc5601-ex
             - euc-jp
             - sjis
             - iso2022-jp
             - iso2022-jp-1
             - iso2022-jp-2
             - euc-cn
             - ces-gbk
             - hz
             - ces-big5
             - euc-kr
             - iso2022-jp-3
             - iso8859-1
             - tis620
             - cp874
             - cp1252
             - cp1251
           range-block: <value in [disable, enable]>
           retry-count: <value of integer>
           scan-bzip2: <value in [disable, enable]>
           status: <value in [disable, enable]>
           streaming-content-bypass: <value in [disable, enable]>
           strip-x-forwarded-for: <value in [disable, enable]>
           switching-protocols: <value in [bypass, block]>
           uncompressed-nest-limit: <value of integer>
           uncompressed-oversize-limit: <value of integer>

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

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

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