Модуль fortinet.fortios.fortios_vpn_ssl_settings — настройка VPN без агента в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_vpn_ssl_settings.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), устанавливая и изменяя параметры функции и категории настроек vpn_ssl. В примерах приведены все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Проверено на 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, который можно настроить и использовать как отдельное устройство. По умолчанию: |
vpn_ssl_settings dictionary | Настройка VPN без агента. |
|
algorithm string |
Принудительно задать уровень безопасности VPN без агента. Высокий уровень разрешает только высокий уровень. Средний уровень разрешает средний и высокий уровни. Низкий уровень разрешает любой уровень. Варианты:
|
|
auth_session_check_source_ip string |
Включить/отключить проверку IP-адреса источника для сеанса аутентификации. Варианты:
|
|
auth_timeout integer |
Тайм-аут аутентификации VPN без агента (1–259200 с (3 дня), 0 — без тайм-аута). |
|
authentication_rule list / elements=dictionary |
Правило аутентификации для VPN без агента. |
|
auth string |
Ограничение метода аутентификации VPN без агента. Варианты:
|
|
cipher string |
Стойкость шифра VPN без агента. Варианты:
|
|
client_cert string |
Включить/отключить ограничение по сертификату клиента VPN без агента. Варианты:
|
|
groups list / elements=dictionary |
Группы пользователей. |
|
name string / обязательный |
Имя группы. Источник: user.group.name. |
|
id integer / обязательный |
Идентификатор (0–4294967295). См. <a href=’#notes’>примечания</a>. |
|
portal string |
Портал VPN без агента. Источник: vpn.ssl.web.portal.name. |
|
realm string |
Область VPN без агента. Источник: vpn.ssl.web.realm.url-path. |
|
source_address list / elements=dictionary |
Адрес источника входящего трафика. |
|
name string / обязательный |
Имя адреса. Источники: firewall.address.name, firewall.addrgrp.name, system.external-resource.name. |
|
source_address6 list / elements=dictionary |
IPv6-адрес источника входящего трафика. |
|
name string / обязательный |
Имя IPv6-адреса. Источники: firewall.address6.name, firewall.addrgrp6.name, system.external-resource.name. |
|
source_address6_negate string |
Включить/отключить инвертированное сопоставление IPv6-адреса источника. Варианты:
|
|
source_address_negate string |
Включить/отключить инвертированное сопоставление адреса источника. Варианты:
|
|
source_interface list / elements=dictionary |
Исходный интерфейс входящего трафика VPN без агента. |
|
name string / обязательный |
Имя интерфейса. Источники: system.interface.name, system.zone.name. |
|
user_peer string |
Имя однорангового узла пользователя. Источник: user.peer.name. |
|
users list / elements=dictionary |
Имя пользователя. |
|
name string / обязательный |
Имя пользователя. Источник: user.local.name. |
|
auto_tunnel_static_route string |
Включить/отключить автоматическое создание статических маршрутов для IP-адресов туннеля SSL-VPN. Варианты:
|
|
banned_cipher list / elements=string |
Выберите одну или несколько технологий шифрования, которые нельзя использовать при согласовании параметров VPN без агента. Применяется только для TLS 1.2 и более ранних версий. Варианты:
|
|
browser_language_detection string |
Включить/отключить переопределение настроенного системного языка с учетом предпочтительного языка браузера. Варианты:
|
|
check_referer string |
Включить/отключить проверку поля referer в заголовке HTTP-запроса. Варианты:
|
|
ciphersuite list / elements=string |
Выберите один или несколько наборов шифров TLS 1.3 для включения. Не влияет на шифры TLS 1.2 и более ранних версий. Должен быть включен хотя бы один набор. Чтобы отключить все наборы, задайте для ssl-max-proto-ver значение tls1-2 или более раннюю версию. Варианты:
|
|
client_sigalgs string |
Задать алгоритмы подписи для аутентификации клиента. Влияет только на версии TLS <= 1.2. Варианты:
|
|
default_portal string |
Портал VPN без агента по умолчанию. Источник: vpn.ssl.web.portal.name. |
|
deflate_compression_level integer |
Уровень сжатия (0–9). |
|
deflate_min_data_size integer |
Минимальный объем данных, при котором запускается сжатие (200–65535 байт). |
|
dns_server1 string |
DNS-сервер 1. |
|
dns_server2 string |
DNS-сервер 2. |
|
dns_suffix string |
DNS-суффикс для клиентов VPN без агента. |
|
dtls_heartbeat_fail_count integer |
Количество пропущенных сигналов проверки активности, после которого соединение считается разорванным. |
|
dtls_heartbeat_idle_timeout integer |
Тайм-аут бездействия перед отправкой сигнала проверки активности DTLS. |
|
dtls_heartbeat_interval integer |
Интервал между сигналами проверки активности DTLS. |
|
dtls_hello_timeout integer |
Максимальный тайм-аут приветствия DTLS для SSLVPN (10–60 с). |
|
dtls_max_proto_ver string |
Максимальная версия протокола DTLS. Варианты:
|
|
dtls_min_proto_ver string |
Минимальная версия протокола DTLS. Варианты:
|
|
dtls_tunnel string |
Включить/отключить DTLS для защиты от перехвата, изменения или подделки сообщений. Варианты:
|
|
dual_stack_mode string |
Веб-режим VPN без агента: поддержка закладок IPv4 и IPv6 на портале. Варианты:
|
|
encode_2f_sequence string |
Кодировать последовательность 2F как косую черту в URL-адресах. Варианты:
|
|
encrypt_and_store_password string |
Шифровать и сохранять пароли пользователей для веб-сеансов VPN без агента. Варианты:
|
|
force_two_factor_auth string |
Включить/отключить доступ к VPN без агента только для пользователей PKI с двухфакторной аутентификацией. Варианты:
|
|
header_x_forwarded_for string |
Передать HTTP-заголовок без изменений, добавить его или удалить. Варианты:
|
|
hsts_include_subdomains string |
Добавить заголовок ответа HSTS includeSubDomains. Варианты:
|
|
http_compression string |
Включение/отключение сжатия HTTP для подключений Agentless VPN. Варианты:
|
|
http_only_cookie string |
Включение/отключение поддержки файлов cookie HttpOnly для Agentless VPN. Варианты:
|
|
http_request_body_timeout integer |
Сеанс Agentless VPN отключается, если тело HTTP-запроса не получено в течение указанного времени (1–60 с). |
|
http_request_header_timeout integer |
Сеанс Agentless VPN отключается, если заголовок HTTP-запроса не получен в течение указанного времени (1–60 с). |
|
https_redirect string |
Включение/отключение перенаправления с порта 80 на порт Agentless VPN. Варианты:
|
|
idle_timeout integer |
Agentless VPN отключается, если соединение бездействует в течение указанного времени (в секундах). |
|
ipv6_dns_server1 string |
DNS-сервер IPv6 1. |
|
ipv6_dns_server2 string |
DNS-сервер IPv6 2. |
|
ipv6_wins_server1 string |
Сервер WINS IPv6 1. |
|
ipv6_wins_server2 string |
Сервер WINS IPv6 2. |
|
login_attempt_limit integer |
Максимальное число попыток входа в Agentless VPN до блокировки (0–10). |
|
login_block_time integer |
Время, в течение которого пользователю запрещен вход после слишком большого числа неудачных попыток (0–86400 с). |
|
login_timeout integer |
Максимальное время ожидания входа в Agentless VPN (10–180 с). |
|
port integer |
Порт доступа Agentless VPN (1–65535). |
|
port_precedence string |
Включение/отключение. Если включено, при разрешении подключений Agentless VPN на интерфейсе подключения к графическому интерфейсу администратора блокируются на этом интерфейсе. Варианты:
|
|
remote_https_cert_check string |
Настройка проверки сертификата удаленного HTTPS-сервера устройством FortiGate и реакции на него. Варианты:
|
|
reqclientcert string |
Включение/отключение требования клиентских сертификатов для всех пользователей Agentless VPN. Варианты:
|
|
route_source_interface string |
Разрешает сеансам SSL-VPN обходить маршрутизацию и привязываться к входящему интерфейсу. Варианты:
|
|
saml_redirect_port integer |
Локальный порт перенаправления SAML на компьютере с FortiClient (0–65535). Значение 0 отключает перенаправление на стороне FGT. |
|
server_hostname string |
Имя узла сервера для HTTPS. Если задано, будет использоваться в заголовке узла веб-прокси Agentless VPN при перенаправлении. |
|
servercert string |
Имя сертификата сервера для Agentless VPN. Источник: vpn.certificate.local.name. |
|
source_address list / elements=dictionary |
Адрес источника входящего трафика. |
|
name string / обязательный |
Имя адреса. Источники: firewall.address.name, firewall.addrgrp.name, system.external-resource.name. |
|
source_address6 list / elements=dictionary |
IPv6-адрес источника входящего трафика. |
|
name string / обязательный |
Имя IPv6-адреса. Источники: firewall.address6.name, firewall.addrgrp6.name, system.external-resource.name. |
|
source_address6_negate string |
Включение/отключение инвертированного сопоставления адреса источника IPv6. Варианты:
|
|
source_address_negate string |
Включение/отключение инвертированного сопоставления адреса источника. Варианты:
|
|
source_interface list / elements=dictionary |
Входящий интерфейс источника Agentless VPN. |
|
name string / обязательный |
Имя интерфейса. Источники: system.interface.name, system.zone.name. |
|
ssl_client_renegotiation string |
Включение/отключение повторного согласования со стороны сервера для клиента при разрыве туннеля. Варианты:
|
|
ssl_insert_empty_fragment string |
Включение/отключение вставки пустого фрагмента. Варианты:
|
|
ssl_max_proto_ver string |
Максимальная версия протокола SSL. Варианты:
|
|
ssl_min_proto_ver string |
Минимальная версия протокола SSL. Варианты:
|
|
status string |
Включение/отключение Agentless VPN. Варианты:
|
|
tls_groups list / elements=string |
Настройка групп, поддерживаемых при согласовании TLS. Варианты:
|
|
tlsv1_0 string |
tlsv1-0 Варианты:
|
|
tlsv1_1 string |
tlsv1-1 Варианты:
|
|
tlsv1_2 string |
tlsv1-2 Варианты:
|
|
tlsv1_3 string |
tlsv1-3 Варианты:
|
|
transform_backward_slashes string |
Замена обратных косых черт на прямые косые черты в URL. Варианты:
|
|
tunnel_addr_assigned_method string |
Метод назначения адреса туннелю. Варианты:
|
|
tunnel_connect_without_reauth string |
Включение/отключение подключения к туннелю без повторной авторизации, если предыдущее подключение было разорвано. Варианты:
|
|
tunnel_ip_pools list / elements=dictionary |
Имена объектов межсетевого экрана IPv4 IP Pool, определяющих IP-адреса, зарезервированные для удаленных клиентов. |
|
name string / обязательный |
Имя адреса. Источники: firewall.address.name, firewall.addrgrp.name. |
|
tunnel_ipv6_pools list / elements=dictionary |
Имена объектов межсетевого экрана IPv6 IP Pool, определяющих IP-адреса, зарезервированные для удаленных клиентов. |
|
name string / обязательный |
Имя адреса. Источники: firewall.address6.name, firewall.addrgrp6.name. |
|
tunnel_user_session_timeout integer |
Время в секундах, по истечении которого сеансы пользователей очищаются после разрыва туннельного соединения (1–86400). |
|
unsafe_legacy_renegotiation string |
Включение/отключение небезопасного устаревшего повторного согласования. Варианты:
|
|
url_obscuration string |
Включение/отключение сокрытия имени узла URL в отображаемом окне веб-браузера. Варианты:
|
|
user_peer string |
Имя узла пользователя. Источник: user.peer.name. |
|
web_mode_snat string |
Включение/отключение использования пулов IP-адресов, заданных в политике межсетевого экрана, в режиме web-mode. Варианты:
|
|
wins_server1 string |
Сервер WINS 1. |
|
wins_server2 string |
Сервер WINS 2. |
|
x_content_type_options string |
Добавление заголовка HTTP X-Content-Type-Options. Варианты:
|
|
ztna_trusted_client string |
Включение/отключение проверки сертификата устройства для сеанса SSLVPN ZTNA. Варианты:
|
Примечания
Примечание
- Устаревшая библиотека fortiosapi объявлена нерекомендуемой; для запуска плейбуков предпочтительно использовать httpapi
- Модуль поддерживает check_mode.
Примеры
- name: Configure Agentless VPN.
fortinet.fortios.fortios_vpn_ssl_settings:
vdom: "{{ vdom }}"
vpn_ssl_settings:
algorithm: "high"
auth_session_check_source_ip: "enable"
auth_timeout: "28800"
authentication_rule:
-
auth: "any"
cipher: "any"
client_cert: "enable"
groups:
-
name: "default_name_11 (source user.group.name)"
id: "12"
portal: "<your_own_value> (source vpn.ssl.web.portal.name)"
realm: "<your_own_value> (source vpn.ssl.web.realm.url-path)"
source_address:
-
name: "default_name_16 (source firewall.address.name firewall.addrgrp.name system.external-resource.name)"
source_address_negate: "enable"
source_address6:
-
name: "default_name_19 (source firewall.address6.name firewall.addrgrp6.name system.external-resource.name)"
source_address6_negate: "enable"
source_interface:
-
name: "default_name_22 (source system.interface.name system.zone.name)"
user_peer: "<your_own_value> (source user.peer.name)"
users:
-
name: "default_name_25 (source user.local.name)"
auto_tunnel_static_route: "enable"
banned_cipher: "RSA"
browser_language_detection: "enable"
check_referer: "enable"
ciphersuite: "TLS-AES-128-GCM-SHA256"
client_sigalgs: "no-rsa-pss"
default_portal: "<your_own_value> (source vpn.ssl.web.portal.name)"
deflate_compression_level: "6"
deflate_min_data_size: "300"
dns_server1: "<your_own_value>"
dns_server2: "<your_own_value>"
dns_suffix: "<your_own_value>"
dtls_heartbeat_fail_count: "3"
dtls_heartbeat_idle_timeout: "3"
dtls_heartbeat_interval: "3"
dtls_hello_timeout: "10"
dtls_max_proto_ver: "dtls1-0"
dtls_min_proto_ver: "dtls1-0"
dtls_tunnel: "enable"
dual_stack_mode: "enable"
encode_2f_sequence: "enable"
encrypt_and_store_password: "enable"
force_two_factor_auth: "enable"
header_x_forwarded_for: "pass"
hsts_include_subdomains: "enable"
http_compression: "enable"
http_only_cookie: "enable"
http_request_body_timeout: "30"
http_request_header_timeout: "20"
https_redirect: "enable"
idle_timeout: "300"
ipv6_dns_server1: "<your_own_value>"
ipv6_dns_server2: "<your_own_value>"
ipv6_wins_server1: "<your_own_value>"
ipv6_wins_server2: "<your_own_value>"
login_attempt_limit: "2"
login_block_time: "60"
login_timeout: "30"
port: "10443"
port_precedence: "enable"
remote_https_cert_check: "no-check"
reqclientcert: "enable"
route_source_interface: "enable"
saml_redirect_port: "8020"
server_hostname: "myhostname"
servercert: "<your_own_value> (source vpn.certificate.local.name)"
source_address:
-
name: "default_name_73 (source firewall.address.name firewall.addrgrp.name system.external-resource.name)"
source_address_negate: "enable"
source_address6:
-
name: "default_name_76 (source firewall.address6.name firewall.addrgrp6.name system.external-resource.name)"
source_address6_negate: "enable"
source_interface:
-
name: "default_name_79 (source system.interface.name system.zone.name)"
ssl_client_renegotiation: "disable"
ssl_insert_empty_fragment: "enable"
ssl_max_proto_ver: "tls1-0"
ssl_min_proto_ver: "tls1-0"
status: "enable"
tls_groups: "P-521"
tlsv1_0: "enable"
tlsv1_1: "enable"
tlsv1_2: "enable"
tlsv1_3: "enable"
transform_backward_slashes: "enable"
tunnel_addr_assigned_method: "first-available"
tunnel_connect_without_reauth: "enable"
tunnel_ip_pools:
-
name: "default_name_94 (source firewall.address.name firewall.addrgrp.name)"
tunnel_ipv6_pools:
-
name: "default_name_96 (source firewall.address6.name firewall.addrgrp6.name)"
tunnel_user_session_timeout: "30"
unsafe_legacy_renegotiation: "enable"
url_obscuration: "enable"
user_peer: "<your_own_value> (source user.peer.name)"
web_mode_snat: "enable"
wins_server1: "<your_own_value>"
wins_server2: "<your_own_value>"
x_content_type_options: "enable"
ztna_trusted_client: "enable"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
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_vpn_ssl_settings_module.html