Spec-Zone.ru › Ansible

Модуль 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

Включить/отключить ведение журнала для задачи.

Варианты:

  • false ← (по умолчанию)
  • true

member_path

string

Путь к атрибуту элемента, с которым выполняется операция.

Если атрибутов несколько, они разделяются символом косой черты.

Параметр с указанным member_path можно использовать для выполнения операции над элементом.

member_state

string

Добавить или удалить элемент по указанному пути атрибута.

Если указан member_state, параметр state игнорируется.

Варианты:

  • "present"
  • "absent"

vdom

string

Виртуальный домен из числа ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство.

По умолчанию: "root"

vpn_ssl_settings

dictionary

Настройка VPN без агента.

algorithm

string

Принудительно задать уровень безопасности VPN без агента. Высокий уровень разрешает только высокий уровень. Средний уровень разрешает средний и высокий уровни. Низкий уровень разрешает любой уровень.

Варианты:

  • "high"
  • "medium"
  • "default"
  • "low"

auth_session_check_source_ip

string

Включить/отключить проверку IP-адреса источника для сеанса аутентификации.

Варианты:

  • "enable"
  • "disable"

auth_timeout

integer

Тайм-аут аутентификации VPN без агента (1–259200 с (3 дня), 0 — без тайм-аута).

authentication_rule

list / elements=dictionary

Правило аутентификации для VPN без агента.

auth

string

Ограничение метода аутентификации VPN без агента.

Варианты:

  • "any"
  • "local"
  • "radius"
  • "tacacs+"
  • "ldap"
  • "peer"

cipher

string

Стойкость шифра VPN без агента.

Варианты:

  • "any"
  • "high"
  • "medium"

client_cert

string

Включить/отключить ограничение по сертификату клиента VPN без агента.

Варианты:

  • "enable"
  • "disable"

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-адреса источника.

Варианты:

  • "enable"
  • "disable"

source_address_negate

string

Включить/отключить инвертированное сопоставление адреса источника.

Варианты:

  • "enable"
  • "disable"

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.

Варианты:

  • "enable"
  • "disable"

banned_cipher

list / elements=string

Выберите одну или несколько технологий шифрования, которые нельзя использовать при согласовании параметров VPN без агента. Применяется только для TLS 1.2 и более ранних версий.

Варианты:

  • "RSA"
  • "DHE"
  • "ECDHE"
  • "DSS"
  • "ECDSA"
  • "AES"
  • "AESGCM"
  • "CAMELLIA"
  • "3DES"
  • "SHA1"
  • "SHA256"
  • "SHA384"
  • "STATIC"
  • "CHACHA20"
  • "ARIA"
  • "AESCCM"
  • "DH"
  • "ECDH"

browser_language_detection

string

Включить/отключить переопределение настроенного системного языка с учетом предпочтительного языка браузера.

Варианты:

  • "enable"
  • "disable"

check_referer

string

Включить/отключить проверку поля referer в заголовке HTTP-запроса.

Варианты:

  • "enable"
  • "disable"

ciphersuite

list / elements=string

Выберите один или несколько наборов шифров TLS 1.3 для включения. Не влияет на шифры TLS 1.2 и более ранних версий. Должен быть включен хотя бы один набор. Чтобы отключить все наборы, задайте для ssl-max-proto-ver значение tls1-2 или более раннюю версию.

Варианты:

  • "TLS-AES-128-GCM-SHA256"
  • "TLS-AES-256-GCM-SHA384"
  • "TLS-CHACHA20-POLY1305-SHA256"
  • "TLS-AES-128-CCM-SHA256"
  • "TLS-AES-128-CCM-8-SHA256"

client_sigalgs

string

Задать алгоритмы подписи для аутентификации клиента. Влияет только на версии TLS <= 1.2.

Варианты:

  • "no-rsa-pss"
  • "all"

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.

Варианты:

  • "dtls1-0"
  • "dtls1-2"

dtls_min_proto_ver

string

Минимальная версия протокола DTLS.

Варианты:

  • "dtls1-0"
  • "dtls1-2"

dtls_tunnel

string

Включить/отключить DTLS для защиты от перехвата, изменения или подделки сообщений.

Варианты:

  • "enable"
  • "disable"

dual_stack_mode

string

Веб-режим VPN без агента: поддержка закладок IPv4 и IPv6 на портале.

Варианты:

  • "enable"
  • "disable"

encode_2f_sequence

string

Кодировать последовательность 2F как косую черту в URL-адресах.

Варианты:

  • "enable"
  • "disable"

encrypt_and_store_password

string

Шифровать и сохранять пароли пользователей для веб-сеансов VPN без агента.

Варианты:

  • "enable"
  • "disable"

force_two_factor_auth

string

Включить/отключить доступ к VPN без агента только для пользователей PKI с двухфакторной аутентификацией.

Варианты:

  • "enable"
  • "disable"

header_x_forwarded_for

string

Передать HTTP-заголовок без изменений, добавить его или удалить.

Варианты:

  • "pass"
  • "add"
  • "remove"

hsts_include_subdomains

string

Добавить заголовок ответа HSTS includeSubDomains.

Варианты:

  • "enable"
  • "disable"

http_compression

string

Включение/отключение сжатия HTTP для подключений Agentless VPN.

Варианты:

  • "enable"
  • "disable"

http_only_cookie

string

Включение/отключение поддержки файлов cookie HttpOnly для Agentless VPN.

Варианты:

  • "enable"
  • "disable"

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.

Варианты:

  • "enable"
  • "disable"

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 на интерфейсе подключения к графическому интерфейсу администратора блокируются на этом интерфейсе.

Варианты:

  • "enable"
  • "disable"

remote_https_cert_check

string

Настройка проверки сертификата удаленного HTTPS-сервера устройством FortiGate и реакции на него.

Варианты:

  • "no-check"
  • "warn-on-error"
  • "reject-on-error"

reqclientcert

string

Включение/отключение требования клиентских сертификатов для всех пользователей Agentless VPN.

Варианты:

  • "enable"
  • "disable"

route_source_interface

string

Разрешает сеансам SSL-VPN обходить маршрутизацию и привязываться к входящему интерфейсу.

Варианты:

  • "enable"
  • "disable"

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.

Варианты:

  • "enable"
  • "disable"

source_address_negate

string

Включение/отключение инвертированного сопоставления адреса источника.

Варианты:

  • "enable"
  • "disable"

source_interface

list / elements=dictionary

Входящий интерфейс источника Agentless VPN.

name

string / обязательный

Имя интерфейса. Источники: system.interface.name, system.zone.name.

ssl_client_renegotiation

string

Включение/отключение повторного согласования со стороны сервера для клиента при разрыве туннеля.

Варианты:

  • "disable"
  • "enable"

ssl_insert_empty_fragment

string

Включение/отключение вставки пустого фрагмента.

Варианты:

  • "enable"
  • "disable"

ssl_max_proto_ver

string

Максимальная версия протокола SSL.

Варианты:

  • "tls1-0"
  • "tls1-1"
  • "tls1-2"
  • "tls1-3"

ssl_min_proto_ver

string

Минимальная версия протокола SSL.

Варианты:

  • "tls1-0"
  • "tls1-1"
  • "tls1-2"
  • "tls1-3"

status

string

Включение/отключение Agentless VPN.

Варианты:

  • "enable"
  • "disable"

tls_groups

list / elements=string

Настройка групп, поддерживаемых при согласовании TLS.

Варианты:

  • "P-521"
  • "P-384"
  • "P-256"
  • "ML-KEM512"
  • "ML-KEM768"
  • "ML-KEM1024"
  • "P-384-MLKEM1024"
  • "P-256-MLKEM768"
  • "X25519-MLKEM768"
  • "X448"
  • "X25519"
  • "FFDHE2048"
  • "FFDHE3072"
  • "FFDHE4096"
  • "FFDHE6144"
  • "FFDHE8192"

tlsv1_0

string

tlsv1-0

Варианты:

  • "enable"
  • "disable"

tlsv1_1

string

tlsv1-1

Варианты:

  • "enable"
  • "disable"

tlsv1_2

string

tlsv1-2

Варианты:

  • "enable"
  • "disable"

tlsv1_3

string

tlsv1-3

Варианты:

  • "enable"
  • "disable"

transform_backward_slashes

string

Замена обратных косых черт на прямые косые черты в URL.

Варианты:

  • "enable"
  • "disable"

tunnel_addr_assigned_method

string

Метод назначения адреса туннелю.

Варианты:

  • "first-available"
  • "round-robin"

tunnel_connect_without_reauth

string

Включение/отключение подключения к туннелю без повторной авторизации, если предыдущее подключение было разорвано.

Варианты:

  • "enable"
  • "disable"

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

Включение/отключение небезопасного устаревшего повторного согласования.

Варианты:

  • "enable"
  • "disable"

url_obscuration

string

Включение/отключение сокрытия имени узла URL в отображаемом окне веб-браузера.

Варианты:

  • "enable"
  • "disable"

user_peer

string

Имя узла пользователя. Источник: user.peer.name.

web_mode_snat

string

Включение/отключение использования пулов IP-адресов, заданных в политике межсетевого экрана, в режиме web-mode.

Варианты:

  • "enable"
  • "disable"

wins_server1

string

Сервер WINS 1.

wins_server2

string

Сервер WINS 2.

x_content_type_options

string

Добавление заголовка HTTP X-Content-Type-Options.

Варианты:

  • "enable"
  • "disable"

ztna_trusted_client

string

Включение/отключение проверки сертификата устройства для сеанса SSLVPN ZTNA.

Варианты:

  • "enable"
  • "disable"

Примечания

Примечание

  • Устаревшая библиотека 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

Возвращается: всегда

Пример: "1547"

http_method

string

Последний метод, использованный для передачи содержимого в FortiGate

Возвращается: всегда

Пример: "PUT"

http_status

string

Последний результат, полученный от FortiGate при выполнении последней операции

Возвращается: всегда

Пример: "200"

mkey

string

Мастер-ключ (идентификатор), использованный при последнем вызове FortiGate

Возвращается: при успешном выполнении

Пример: "id"

name

string

Имя таблицы, использованной для выполнения запроса

Возвращается: всегда

Пример: "urlfilter"

path

string

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

Возвращается: всегда

Пример: "webfilter"

revision

string

Внутренний номер редакции

Возвращается: всегда

Пример: "17.0.2.10658"

serial

string

Серийный номер устройства

Возвращается: всегда

Пример: "FGVMEVYYQT3AB5352"

status

string

Результат выполнения операции

Возвращается: всегда

Пример: "success"

vdom

string

Использованный виртуальный домен

Возвращается: всегда

Пример: "root"

version

string

Версия FortiGate

Возвращается: всегда

Пример: "v5.6.3"

Авторы

  • Link Zheng (@chillancezen)
  • Jie Xue (@JieX19)
  • Hongbin Lu (@fgtdev-hblu)
  • Frank Shen (@frankshen01)
  • Miguel Angel Munoz (@mamunozgonzalez)
  • Nicolas Thomas (@thomnico)

Ссылки на коллекцию

  • Отслеживание ошибок
  • Домашняя страница
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

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