Spec-Zone.ru › Ansible 2.8

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

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

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

Обзор

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

Требования

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

  • fortiosapi>=0.9.8

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
host
- / обязательно
IP-адрес FortiOS или FortiGate.
https
boolean
    Варианты:
  • no
  • yes ←
Указывает, должны ли запросы к FortiGate использовать протокол HTTPS
password
-
Значение по умолчанию:
""
Пароль FortiOS или FortiGate.
username
- / обязательно
Имя пользователя FortiOS или FortiGate.
vdom
-
Значение по умолчанию:
"root"
Виртуальная область (vdom), определенная ранее. Vdom — виртуальная инстанция FortiGate, которая может быть настроена и использована как отдельное устройство.
web_proxy_global
-
Значение по умолчанию:
null
Настройка глобальных параметров веб-прокси.
fast-policy-match
-
    Варианты:
  • enable
  • disable
Включение/выключение алгоритма быстрого соответствия для явной и прозрачной политики прокси.
forward-proxy-auth
-
    Варианты:
  • enable
  • disable
Включение/выключение заголовков аутентификации прокси-сервера.
forward-server-affinity-timeout
-
Период времени, после которого трафик источника IP больше не назначается серверу пересылки (6-60 мин, по умолчанию = 30).
learn-client-ip
-
    Варианты:
  • enable
  • disable
Включение/выключение обучения 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 Кбайт, по умолчанию = 32).
max-request-length
-
Максимальная длина строки HTTP запроса (2-64 Кбайт, по умолчанию = 4).
max-waf-body-cache-length
-
Максимальная длина HTTP сообщений, обрабатываемых Web Application Firewall (WAF) (10-1024 Кбайт, по умолчанию = 32).
proxy-fqdn
-
Полное доменное имя (FQDN), к которому подключаются клиенты (по умолчанию = default.fqdn) для подключения к явному веб-прокси.
strict-web-check
-
    Варианты:
  • enable
  • disable
Включение/выключение строгой проверки веб-сайтов для блокирования сайтов, которые отправляют неправильные заголовки, не соответствующие HTTP 1.1.
tunnel-non-http
-
    Варианты:
  • enable
  • disable
Включение/выключение разрешения не-HTTP трафика. Разрешённый не-HTTP трафик туннелируется.
unknown-http-version
-
    Варианты:
  • reject
  • tunnel
  • best-effort
Действие, выполняемое при обнаружении неизвестной версии HTTP: отклонить, разрешить (туннель) или продолжить с наилучшим результатом.
webproxy-profile
-
Имя профиля веб-прокси, применяемого, когда явный прокси-трафик разрешен по умолчанию, и трафик принимается, если он не соответствует явной политике прокси. Источник web-proxy.profile.name.

Примечания

Примечание

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

Примеры

- hosts: localhost
  vars:
   host: "192.168.122.40"
   username: "admin"
   password: ""
   vdom: "root"
  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
строка
всегда
Указание результата операции

Пример:
success
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.8/modules/fortios_web_proxy_global_module.html

Spec-Zone.ru

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