Модуль fortinet.fortios.fortios_ztna_traffic_forward_proxy — настройка прокси-сервера для перенаправления трафика ZTNA в FortiOS и FortiGate от Fortinet.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать его в плейбуке, укажите: fortinet.fortios.fortios_ztna_traffic_forward_proxy.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя функцию ztna и категорию traffic_forward_proxy. Все параметры и значения в примерах необходимо адаптировать к источникам данных перед использованием. Проверено на 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 игнорируется. Возможные значения:
|
state string / обязательный | Указывает, следует ли создать или удалить объект. Возможные значения:
|
vdom string | Виртуальный домен из числа предварительно определённых. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
ztna_traffic_forward_proxy dictionary | Настроить прокси-сервер для пересылки трафика ZTNA. |
|
auth_portal string |
Включить/отключить портал аутентификации. Возможные значения:
|
|
auth_virtual_host string |
Виртуальный хост для портала аутентификации. Источник: firewall.access-proxy-virtual-host.name. |
|
client_cert string |
Включить/отключить запрос сертификата клиента. Возможные значения:
|
|
comment string |
Комментарий. |
|
decrypted_traffic_mirror string |
Зеркалирование расшифрованного трафика. Источник: firewall.decrypted-traffic-mirror.name. |
|
empty_cert_action string |
Действие при отсутствии сертификата клиента. Возможные значения:
|
|
h3_support string |
Включить/отключить поддержку HTTP3/QUIC. Возможные значения:
|
|
host string |
Имя виртуального или реального хоста. Источник: firewall.access-proxy-virtual-host.name. |
|
interface string |
Имя интерфейса. Источник: system.interface.name. |
|
log_blocked_traffic string |
Включить/отключить регистрацию заблокированного трафика. Возможные значения:
|
|
name string / обязательный |
Имя прокси-сервера ZTNA. |
|
port string |
Принимать входящий трафик на одном или нескольких портах (0–65535). |
|
quic dictionary |
Настройки QUIC. |
|
ack_delay_exponent integer |
Показатель степени задержки ACK (1–20). |
|
active_connection_id_limit integer |
Лимит активных идентификаторов соединений (1–8). |
|
active_migration string |
Включить/отключить активную миграцию. Возможные значения:
|
|
grease_quic_bit string |
Включить/отключить бит GREASE QUIC. Возможные значения:
|
|
max_ack_delay integer |
Максимальная задержка ACK в миллисекундах (1–16383). |
|
max_datagram_frame_size integer |
Максимальный размер кадра дейтаграммы в байтах (1–1500). |
|
max_idle_timeout integer |
Максимальное время ожидания бездействия в миллисекундах (1–60000). |
|
max_udp_payload_size integer |
Максимальный размер полезной нагрузки UDP в байтах (1200–1500). |
|
ssl_accept_ffdhe_groups string |
Включить/отключить набор шифров FFDHE для обмена ключами SSL. Варианты:
|
|
ssl_algorithm string |
Допустимые алгоритмы шифрования для SSL-сеансов в соответствии с уровнем стойкости шифрования. Варианты:
|
|
ssl_certificate list / elements=dictionary |
Имя сертификата, используемого для рукопожатия SSL. |
|
name string / required |
Список сертификатов. Источник: vpn.certificate.local.name. |
|
ssl_cipher_suites list / elements=dictionary |
Приемлемые для клиента наборы шифров SSL/TLS, упорядоченные по приоритету. |
|
cipher string |
Имя набора шифров. Варианты:
|
|
priority integer / required |
Приоритет наборов шифров SSL/TLS. См. <a href=’#notes’>Примечания</a>. |
|
versions list / elements=string |
Версии SSL/TLS, с которыми можно использовать набор шифров. Варианты:
|
|
ssl_client_fallback string |
Включить/отключить защиту клиентских подключений от атак понижения версии (RFC 7507). Варианты:
|
|
ssl_client_rekey_count integer |
Максимальный объем данных в МБ до инициирования повторного обмена ключами клиента (0 = отключить). |
|
ssl_client_renegotiation string |
Разрешить, запретить или требовать безопасное повторное согласование параметров клиентских сеансов в соответствии с RFC 5746. Варианты:
|
|
ssl_client_session_state_max integer |
Максимальное количество состояний SSL-сеансов между клиентом и FortiProxy, которые следует хранить. |
|
ssl_client_session_state_timeout integer |
Количество минут хранения состояния SSL-сеанса между клиентом и FortiProxy. |
|
ssl_client_session_state_type string |
Способ завершения SSL-сеансов для участка SSL-подключения между клиентом и FortiGate. Варианты:
|
|
ssl_dh_bits string |
Размер в битах простого числа Диффи — Хеллмана (DH), используемого при согласовании DHE-RSA. Варианты:
|
|
ssl_hpkp string |
Включить/отключить добавление заголовка HPKP в ответ. Варианты:
|
|
ssl_hpkp_age integer |
Количество секунд, в течение которых клиент должен соблюдать настройку HPKP. |
|
ssl_hpkp_backup string |
Сертификат для создания резервного ключевого отпечатка HPKP. Источники: vpn.certificate.local.name, vpn.certificate.ca.name. |
|
ssl_hpkp_include_subdomains string |
Указывает, что заголовок HPKP применяется ко всем поддоменам. Варианты:
|
|
ssl_hpkp_primary string |
Сертификат для создания основного ключевого отпечатка HPKP. Источники: vpn.certificate.local.name, vpn.certificate.ca.name. |
|
ssl_hpkp_report_uri string |
URL-адрес для отправки отчетов о нарушениях HPKP. |
|
ssl_hsts string |
Включить или отключить добавление заголовка HSTS в ответ. Варианты:
|
|
ssl_hsts_age integer |
Количество секунд, в течение которых клиент должен соблюдать настройку HSTS. |
|
ssl_hsts_include_subdomains string |
Указывает, что заголовок HSTS применяется ко всем поддоменам. Варианты:
|
|
ssl_http_location_conversion string |
Включить замену HTTP на HTTPS в поле заголовка Location ответа. Варианты:
|
|
ssl_http_match_host string |
Включить или отключить сопоставление HTTP-хоста при преобразовании Location. Варианты:
|
|
ssl_max_version string |
Максимальная версия SSL/TLS, допустимая для клиента. Варианты:
|
|
ssl_min_version string |
Минимальная версия SSL/TLS, допустимая для клиента. Варианты:
|
|
ssl_mode string |
Применить разгрузку SSL между клиентом и FortiGate (половинный режим) либо между клиентом и FortiGate, а также между FortiGate и сервером (полный режим). Варианты:
|
|
ssl_pfs string |
Выберите наборы шифров, которые можно использовать для совершенной прямой секретности SSL (PFS). Применяется как к сеансам клиента, так и к сеансам сервера. Варианты:
|
|
ssl_send_empty_frags string |
Включить или отключить отправку пустых фрагментов для предотвращения атак на вектор инициализации CBC (только SSL 3.0 и TLS 1.0). Для совместимости со старыми системами может потребоваться отключение. Варианты:
|
|
ssl_server_algorithm string |
Допустимые алгоритмы шифрования для серверной стороны сеансов SSL в полном режиме в зависимости от надежности шифрования. Варианты:
|
|
ssl_server_cipher_suites list / elements=dictionary |
Наборы шифров SSL/TLS, предлагаемые серверу в порядке приоритета. |
|
cipher string |
Название набора шифров. Варианты:
|
|
priority integer / обязательный |
Приоритет наборов шифров SSL/TLS. См. <a href=’#notes’>примечания</a>. |
|
versions list / elements=string |
Версии SSL/TLS, с которыми можно использовать набор шифров. Варианты:
|
|
ssl_server_max_version string |
Максимальная версия SSL/TLS, допустимая для сервера. По умолчанию используется настройка клиента. Варианты:
|
|
ssl_server_min_version string |
Минимальная версия SSL/TLS, допустимая для сервера. По умолчанию используется настройка клиента. Варианты:
|
|
ssl_server_renegotiation string |
Включить или отключить безопасное повторное согласование в соответствии с RFC 5746. Варианты:
|
|
ssl_server_session_state_max integer |
Максимальное количество состояний SSL-сеансов между FortiGate и сервером, которые следует хранить. |
|
ssl_server_session_state_timeout integer |
Количество минут, в течение которых следует хранить состояние SSL-сеанса между FortiGate и сервером. |
|
ssl_server_session_state_type string |
Способ завершения SSL-сеансов для сегмента SSL-соединения между сервером и FortiGate. Варианты:
|
|
status string |
Включить или отключить прокси-сервер пересылки трафика ZTNA. Варианты:
|
|
svr_pool_multiplex string |
Включить или отключить мультиплексирование пула серверов. Использовать подключенный сервер совместно для HTTP, HTTPS и API-шлюза веб-портала. Варианты:
|
|
svr_pool_server_max_concurrent_request integer |
Максимальное количество одновременных запросов, которые могут обрабатывать серверы в пуле серверов. |
|
svr_pool_server_max_request integer |
Максимальное количество запросов, обрабатываемых серверами в пуле серверов до отключения. |
|
svr_pool_ttl integer |
Время жизни неактивных соединений с серверами в пуле серверов. |
|
user_agent_detect string |
Включить или отключить определение типа устройства по HTTP user-agent, если клиентский сертификат не предоставлен. Варианты:
|
|
vip string |
Имя виртуального IP-адреса. Источник: firewall.vip.name. |
|
vip6 string |
Имя виртуального IPv6-адреса. Источник: firewall.vip6.name. |
Примечания
Примечание
- Устаревший fortiosapi считается нежелательным; для запуска плейбуков предпочтительно использовать httpapi.
- Модуль поддерживает check_mode.
Примеры
- name: Configure ZTNA traffic forward proxy.
fortinet.fortios.fortios_ztna_traffic_forward_proxy:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
ztna_traffic_forward_proxy:
auth_portal: "disable"
auth_virtual_host: "myhostname (source firewall.access-proxy-virtual-host.name)"
client_cert: "disable"
comment: "Comment."
decrypted_traffic_mirror: "<your_own_value> (source firewall.decrypted-traffic-mirror.name)"
empty_cert_action: "accept"
h3_support: "enable"
host: "myhostname (source firewall.access-proxy-virtual-host.name)"
interface: "<your_own_value> (source system.interface.name)"
log_blocked_traffic: "disable"
name: "default_name_13"
port: "<your_own_value>"
quic:
ack_delay_exponent: "3"
active_connection_id_limit: "2"
active_migration: "enable"
grease_quic_bit: "enable"
max_ack_delay: "25"
max_datagram_frame_size: "1500"
max_idle_timeout: "30000"
max_udp_payload_size: "1500"
ssl_accept_ffdhe_groups: "enable"
ssl_algorithm: "high"
ssl_certificate:
-
name: "default_name_27 (source vpn.certificate.local.name)"
ssl_cipher_suites:
-
cipher: "TLS-AES-128-GCM-SHA256"
priority: "<you_own_value>"
versions: "ssl-3.0"
ssl_client_fallback: "disable"
ssl_client_rekey_count: "0"
ssl_client_renegotiation: "allow"
ssl_client_session_state_max: "1000"
ssl_client_session_state_timeout: "30"
ssl_client_session_state_type: "disable"
ssl_dh_bits: "768"
ssl_hpkp: "disable"
ssl_hpkp_age: "5184000"
ssl_hpkp_backup: "<your_own_value> (source vpn.certificate.local.name vpn.certificate.ca.name)"
ssl_hpkp_include_subdomains: "disable"
ssl_hpkp_primary: "<your_own_value> (source vpn.certificate.local.name vpn.certificate.ca.name)"
ssl_hpkp_report_uri: "<your_own_value>"
ssl_hsts: "disable"
ssl_hsts_age: "5184000"
ssl_hsts_include_subdomains: "disable"
ssl_http_location_conversion: "enable"
ssl_http_match_host: "enable"
ssl_max_version: "ssl-3.0"
ssl_min_version: "ssl-3.0"
ssl_mode: "half"
ssl_pfs: "require"
ssl_send_empty_frags: "enable"
ssl_server_algorithm: "high"
ssl_server_cipher_suites:
-
cipher: "TLS-AES-128-GCM-SHA256"
priority: "<you_own_value>"
versions: "ssl-3.0"
ssl_server_max_version: "ssl-3.0"
ssl_server_min_version: "ssl-3.0"
ssl_server_renegotiation: "enable"
ssl_server_session_state_max: "100"
ssl_server_session_state_timeout: "60"
ssl_server_session_state_type: "disable"
status: "enable"
svr_pool_multiplex: "enable"
svr_pool_server_max_concurrent_request: "0"
svr_pool_server_max_request: "0"
svr_pool_ttl: "15"
user_agent_detect: "disable"
vip: "<your_own_value> (source firewall.vip.name)"
vip6: "<your_own_value> (source firewall.vip6.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_ztna_traffic_forward_proxy_module.html