Модуль fortinet.fortios.fortios_web_proxy_global — настройка глобальных параметров веб-прокси в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_web_proxy_global.
Добавлено в fortinet.fortios 2.0.0
Обзор
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), устанавливая и изменяя параметры функций web_proxy и категорию global. Примеры включают все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Проверено на FOS v6.0.0
Требования
На хосте, выполняющем этот модуль, должны быть установлены следующие компоненты.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Токен создаётся в графическом интерфейсе FortiGate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
member_path string | Путь к атрибуту элемента, с которым выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр с атрибутом member_path можно использовать для выполнения операций над элементами. |
member_state string | Добавить или удалить элемент по указанному пути к атрибуту. Если задан параметр member_state, параметр state игнорируется. Варианты:
|
vdom string | Виртуальный домен из числа ранее определённых. VDOM — это виртуальный экземпляр FortiGate, который можно настраивать и использовать как отдельное устройство. По умолчанию: |
web_proxy_global dictionary | Настройка глобальных параметров веб-прокси. |
|
always_learn_client_ip string |
Включить или отключить получение IP-адреса клиента из заголовков для каждого запроса. Варианты:
|
|
auth_sign_timeout integer |
Тайм-аут подписи запроса аутентификации прокси-сервера в секундах (30–3600). |
|
fast_policy_match string |
Включить или отключить алгоритм быстрого сопоставления для политик явного и прозрачного прокси. Варианты:
|
|
forward_proxy_auth string |
Включить или отключить передачу заголовков аутентификации прокси-сервера. Варианты:
|
|
forward_server_affinity_timeout integer |
Период времени, по истечении которого трафик исходного IP-адреса больше не будет назначаться серверу переадресации (6–60 мин). |
|
http2_client_window_size integer |
Начальный размер окна клиента HTTP/2 в байтах (65535–2147483647). |
|
http2_server_window_size integer |
Начальный размер окна сервера HTTP/2 в байтах (65535–2147483647). |
|
ldap_user_cache string |
Включить или отключить кэш пользователей LDAP для пользователей явного и прозрачного прокси. Варианты:
|
|
learn_client_ip string |
Включить или отключить получение IP-адреса клиента из заголовков. Варианты:
|
|
learn_client_ip_from_header list / elements=string |
Получать IP-адрес клиента из указанных заголовков. Варианты:
|
|
learn_client_ip_srcaddr list / elements=dictionary |
Имя исходного адреса (должен быть задан srcaddr или srcaddr6). |
|
name string / обязательный |
Имя адреса. Источник: firewall.address.name, firewall.addrgrp.name. |
|
learn_client_ip_srcaddr6 list / elements=dictionary |
Имя исходного адреса IPv6 (должен быть задан srcaddr или srcaddr6). |
|
name string / обязательный |
Имя адреса. Источник: firewall.address6.name, firewall.addrgrp6.name. |
|
log_app_id string |
Включить или отключить постоянную запись типа приложения в журнал трафика. Варианты:
|
|
log_forward_server string |
Включить или отключить запись имени сервера переадресации в журнал пересылаемого трафика. Варианты:
|
|
log_policy_pending string |
Включить или отключить запись в журнал сеансов, ожидающих сопоставления с политикой. Варианты:
|
|
max_message_length integer |
Максимальная длина HTTP-сообщения без учёта тела (16–256 Кбайт). |
|
max_request_length integer |
Максимальная длина строки HTTP-запроса (2–64 Кбайт). |
|
max_waf_body_cache_length integer |
Максимальная длина HTTP-сообщений, обрабатываемых межсетевым экраном веб-приложений (WAF) (1–1024 Кбайт). |
|
policy_category_deep_inspect string |
Включить или отключить глубокую проверку при сопоставлении политик по категориям на уровне приложений. Варианты:
|
|
policy_partial_match string |
Включить или отключить частичное сопоставление политик. Варианты:
|
|
proxy_fqdn string |
Полное доменное имя явного веб-прокси, к которому подключаются клиенты. |
|
proxy_transparent_cert_inspection string |
Включить или отключить проверку сертификатов прозрачным прокси. Варианты:
|
|
request_obs_fold string |
Действие, выполняемое, если заголовок запроса HTTP/1.x содержит obs-fold. Варианты:
|
|
src_affinity_exempt_addr list / elements=string |
Исходные адреса IPv4, для которых не применяется привязка к прокси. |
|
src_affinity_exempt_addr6 list / elements=string |
Исходные адреса IPv6, для которых не применяется привязка к прокси. |
|
ssl_ca_cert string |
Сертификат центра сертификации SSL для перехвата SSL. Источник: vpn.certificate.local.name, vpn.certificate.hsm-local.name. |
|
ssl_cert string |
Сертификат SSL для перехвата SSL. Источник: vpn.certificate.local.name. |
|
strict_web_check string |
Включить или отключить строгую проверку веб-трафика для блокировки сайтов, отправляющих некорректные заголовки, не соответствующие HTTP. Варианты:
|
|
tunnel_non_http string |
Включить или отключить разрешение трафика, не использующего HTTP. Разрешённый трафик, не использующий HTTP, передаётся через туннель. Варианты:
|
|
unknown_http_version string |
Действие при обнаружении неизвестной версии HTTP: отклонить, разрешить (туннелировать) или продолжить с максимально возможной совместимостью. Варианты:
|
|
webproxy_profile string |
Имя профиля веб-прокси, который применяется, если трафик явного прокси разрешён по умолчанию и принимается трафик, не соответствующий политике явного прокси. Источник: web-proxy.profile.name. |
Примечания
Примечание
- Устаревший fortiosapi объявлен устаревшим; для запуска плейбуков рекомендуется использовать httpapi.
- Модуль поддерживает check_mode.
Примеры
- name: Configure Web proxy global settings.
fortinet.fortios.fortios_web_proxy_global:
vdom: "{{ vdom }}"
web_proxy_global:
always_learn_client_ip: "enable"
auth_sign_timeout: "120"
fast_policy_match: "enable"
forward_proxy_auth: "enable"
forward_server_affinity_timeout: "30"
http2_client_window_size: "1048576"
http2_server_window_size: "1048576"
ldap_user_cache: "enable"
learn_client_ip: "enable"
learn_client_ip_from_header: "true-client-ip"
learn_client_ip_srcaddr:
-
name: "default_name_14 (source firewall.address.name firewall.addrgrp.name)"
learn_client_ip_srcaddr6:
-
name: "default_name_16 (source firewall.address6.name firewall.addrgrp6.name)"
log_app_id: "enable"
log_forward_server: "enable"
log_policy_pending: "enable"
max_message_length: "32"
max_request_length: "8"
max_waf_body_cache_length: "1"
policy_category_deep_inspect: "enable"
policy_partial_match: "enable"
proxy_fqdn: "<your_own_value>"
proxy_transparent_cert_inspection: "enable"
request_obs_fold: "replace-with-sp"
src_affinity_exempt_addr: "<your_own_value>"
src_affinity_exempt_addr6: "<your_own_value>"
ssl_ca_cert: "<your_own_value> (source vpn.certificate.local.name vpn.certificate.hsm-local.name)"
ssl_cert: "<your_own_value> (source vpn.certificate.local.name)"
strict_web_check: "enable"
tunnel_non_http: "enable"
unknown_http_version: "reject"
webproxy_profile: "<your_own_value> (source web-proxy.profile.name)"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для передачи содержимого в FortiGate Возвращается: всегда Пример: |
http_status string | Последний результат, возвращённый FortiGate для последней выполненной операции Возвращается: всегда Пример: |
mkey string | Главный ключ (идентификатор), использованный при последнем вызове FortiGate Возвращается: при успехе Пример: |
name string | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер ревизии Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Результат операции Возвращается: всегда Пример: |
vdom string | Используемый виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_web_proxy_global_module.html