Spec-Zone.ru › Ansible 2.9

fortios_web_proxy_global – Настройка глобальных параметров веб-прокси в Fortinet’s FortiOS и FortiGate

Новая версия 2.8.

  • Описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Описание

  • Этот модуль позволяет настроить устройство FortiGate или FortiOS (FOS), позволяя пользователю задавать и изменять функцию web_proxy и глобальную категорию. Примеры включают все параметры и значения, которые необходимо скорректировать в источниках данных перед использованием. Тестировалось с FOS v6.0.5

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • fortiosapi>=0.9.8

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
host
строка
IP-адрес FortiOS или FortiGate.
https
логическое значение
    Варианты:
  • нет
  • да ←
Указывает, должны ли запросы к FortiGate использовать протокол HTTPS.
password
строка
Значение по умолчанию:
""
Пароль FortiOS или FortiGate.
ssl_verify
логическое значение
добавлен в 2.9
    Варианты:
  • нет
  • да ←
Обеспечивает проверку сертификата FortiGate надлежащим центром сертификации.
username
строка
Имя пользователя FortiOS или FortiGate.
vdom
строка
Значение по умолчанию:
"root"
Виртуальная область, определённая ранее. VDOM — это виртуальная инстанция FortiGate, которая может быть настроена и использована как отдельное устройство.
web_proxy_global
словарь
Значение по умолчанию:
null
Настройка глобальных настроек веб-прокси.
fast_policy_match
строка
    Варианты:
  • включить
  • выключить
Включение/выключение быстрого алгоритма сопоставления для политики явного и прозрачного прокси.
forward_proxy_auth
строка
    Варианты:
  • включить
  • выключить
Включение/выключение заголовков аутентификации прокси-сервера переадресации.
forward_server_affinity_timeout
целое число
Период времени, в течение которого трафик источника IP-адреса больше не назначается серверу переадресации (6—60 мин).
learn_client_ip
строка
    Варианты:
  • включить
  • выключить
Включение/выключение обучения IP-адресу клиента по заголовкам.
learn_client_ip_from_header
строка
    Варианты:
  • true-client-ip
  • x-real-ip
  • x-forwarded-for
Обучение IP-адресу клиента по указанным заголовкам.
learn_client_ip_srcaddr
список
Имя адреса источника (должен быть задан srcaddr или srcaddr6).
name
строка / обязательно
Имя адреса. Источник firewall.address.name firewall.addrgrp.name.
learn_client_ip_srcaddr6
список
Имя IPv6 адреса источника (должен быть задан srcaddr или srcaddr6).
name
строка / обязательно
Имя адреса. Источник firewall.address6.name firewall.addrgrp6.name.
max_message_length
целое число
Максимальная длина HTTP сообщения, не включая тело (16—256 Кбайт).
max_request_length
целое число
Максимальная длина строки HTTP запроса (2—64 Кбайт).
max_waf_body_cache_length
целое число
Максимальная длина HTTP сообщений, обрабатываемых Web Application Firewall (WAF) (10—1024 Кбайт).
proxy_fqdn
строка
Полное доменное имя (FQDN), к которому клиенты подключаются для подключения к явному веб-прокси.
strict_web_check
строка
    Варианты:
  • включить
  • выключить
Включение/выключение строгой проверки веб-страниц для блокировки веб-сайтов, которые отправляют некорректные заголовки, не соответствующие HTTP 1.1.
tunnel_non_http
строка
    Варианты:
  • включить
  • выключить
Включение/выключение разрешения трафика, отличного от HTTP. Разрешённый трафик, отличный от HTTP, туннелируется.
unknown_http_version
строка
    Варианты:
  • отклонить
  • туннель
  • лучшее усилие
Действие, которое необходимо выполнить при обнаружении неизвестной версии HTTP: отклонить, разрешить (туннель) или продолжить с лучшим результатом.
webproxy_profile
строка
Имя профиля веб-прокси, которое необходимо применить при разрешении трафика явного прокси по умолчанию и приёме трафика, не соответствующего политике явного прокси. Источник web-proxy.profile.name.

Примечания

Примечание

  • Требуется библиотека fortiosapi, разработанная Fortinet
  • Выполняется как local_action в вашем playbook

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
   ssl_verify: "False"
  tasks:
  - name: Configure Web proxy global settings.
    fortios_web_proxy_global:
      host:  "{{ host }}"
      username: "{{ username }}"
      password: "{{ password }}"
      vdom:  "{{ vdom }}"
      https: "False"
      web_proxy_global:
        fast_policy_match: "enable"
        forward_proxy_auth: "enable"
        forward_server_affinity_timeout: "5"
        learn_client_ip: "enable"
        learn_client_ip_from_header: "true-client-ip"
        learn_client_ip_srcaddr:
         -
            name: "default_name_9 (source firewall.address.name firewall.addrgrp.name)"
        learn_client_ip_srcaddr6:
         -
            name: "default_name_11 (source firewall.address6.name firewall.addrgrp6.name)"
        max_message_length: "12"
        max_request_length: "13"
        max_waf_body_cache_length: "14"
        proxy_fqdn: "<your_own_value>"
        strict_web_check: "enable"
        tunnel_non_http: "enable"
        unknown_http_version: "reject"
        webproxy_profile: "<your_own_value> (source web-proxy.profile.name)"

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

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

Ключ Возвращаемое значение Описание
build
строка
всегда
Номер сборки образа FortiGate

Пример:
1547
http_method
строка
всегда
Последний метод, используемый для предоставления содержимого в FortiGate

Пример:
PUT
http_status
строка
всегда
Последний результат, полученный от FortiGate при последней операции

Пример:
200
mkey
строка
успех
Главный ключ (id), используемый в последнем вызове FortiGate

Пример:
id
name
строка
всегда
Имя таблицы, используемой для выполнения запроса

Пример:
urlfilter
path
строка
всегда
Путь к таблице, используемой для выполнения запроса

Пример:
webfilter
revision
строка
всегда
Внутренний номер ревизии

Пример:
17.0.2.10658
serial
строка
всегда
Серийный номер устройства

Пример:
FGVMEVYYQT3AB5352
status
строка
всегда
Указание результата операции

Пример:
успех
vdom
строка
всегда
Используемый виртуальный домен

Пример:
root
version
строка
всегда
Версия FortiGate

Пример:
v5.6.3


Статус

  • Не гарантируется обратная совместимость этого модуля. [превью]
  • Этот модуль поддерживается сообществом Ansible. [community]

Авторы

  • Miguel Angel Munoz (@mamunozgonzalez)
  • Nicolas Thomas (@thomnico)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/fortios_web_proxy_global_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API