модуль fortinet.fortios.fortios_vpn_ipsec_phase2_interface — настройка 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_ipsec_phase2_interface.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя функцию vpn_ipsec и категорию phase2_interface. В примерах приведены все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием. Проверено на 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, который можно настроить и использовать как отдельное устройство. По умолчанию: |
vpn_ipsec_phase2_interface dictionary | Настройка VPN-туннеля с автоматическим обменом ключами. |
|
add_route string |
Включить или отключить автоматическое добавление маршрутов. Варианты:
|
|
addke1 list / элементы типа string |
Группа ADDKE1 фазы 2. Варианты:
|
|
addke2 list / элементы типа string |
Группа ADDKE2 фазы 2. Варианты:
|
|
addke3 list / элементы типа string |
Группа ADDKE3 фазы 2. Варианты:
|
|
addke4 list / элементы типа string |
Группа ADDKE4 фазы 2. Варианты:
|
|
addke5 list / элементы типа string |
Группа ADDKE5 фазы 2. Варианты:
|
|
addke6 list / элементы типа string |
Группа ADDKE6 фазы 2. Варианты:
|
|
addke7 list / элементы типа string |
Группа ADDKE7 фазы 2. Варианты:
|
|
auto_discovery_forwarder string |
Включить или отключить пересылку сообщений для быстрого создания соединений. Варианты:
|
|
auto_discovery_sender string |
Включить или отключить отправку сообщений для быстрого создания соединений. Варианты:
|
|
auto_negotiate string |
Включить или отключить автоматическое согласование IPsec SA. Варианты:
|
|
comments string |
Комментарий. |
|
dhcp_ipsec string |
Включить или отключить DHCP-IPsec. Варианты:
|
|
dhgrp list / элементы типа string |
Группа DH фазы 2. Варианты:
|
|
diffserv string |
Включить или отключить применение значения DSCP к внешнему IP-заголовку IPsec-туннеля. Варианты:
|
|
diffservcode string |
Значение DSCP, применяемое к внешнему IP-заголовку IPsec-туннеля. |
|
dst_addr_type string |
Тип удаленного прокси-идентификатора. Варианты:
|
|
dst_end_ip string |
Конечный IPv4-адрес удаленного прокси-идентификатора. |
|
dst_end_ip6 string |
Конечный IPv6-адрес удаленного прокси-идентификатора. |
|
dst_name string |
Имя удаленного прокси-идентификатора. Источник: firewall.address.name, firewall.addrgrp.name. |
|
dst_name6 string |
Имя удаленного прокси-идентификатора. Источник: firewall.address6.name, firewall.addrgrp6.name. |
|
dst_port integer |
Порт назначения в режиме Quick mode (1–65535 или 0 для всех портов). |
|
dst_start_ip string |
Начальный IPv4-адрес удаленного прокси-идентификатора. |
|
dst_start_ip6 string |
Начальный IPv6-адрес удаленного прокси-идентификатора. |
|
dst_subnet string |
Подсеть IPv4 удаленного прокси-идентификатора. |
|
dst_subnet6 string |
Подсеть IPv6 удаленного прокси-идентификатора. |
|
encapsulation string |
Режим инкапсуляции ESP. Варианты:
|
|
inbound_dscp_copy string |
Включить или отключить копирование DSCP из заголовка ESP во внутренний IP-заголовок. Варианты:
|
|
initiator_ts_narrow string |
Включить или отключить сужение селектора трафика для инициатора IKEv2. Варианты:
|
|
ipv4_df string |
Включить или отключить установку и сброс бита IPv4 «Не фрагментировать». Варианты:
|
|
keepalive string |
Включить или отключить поддержание активности соединения. Варианты:
|
|
keylife_type string |
Тип срока действия ключа. Варианты:
|
|
keylifekbs integer |
Срок действия ключа фазы 2, измеряемый объемом переданного трафика в килобайтах (5120–4294967295). |
keylifeseconds integer | Срок действия ключа фазы 2 в секундах (120–172800). |
|
l2tp string |
Включить или отключить L2TP поверх IPsec. Варианты:
|
|
name string / обязательный |
Имя IPsec-туннеля. |
|
pfs string |
Включить или отключить функцию PFS. Варианты:
|
|
phase1name string |
Фаза 1 определяет параметры, необходимые для фазы 2. Источник: vpn.ipsec.phase1-interface.name. |
|
proposal list / elements=string |
Предложение Phase2. Варианты:
|
|
protocol integer |
Селектор протокола быстрого режима (от 1 до 255 или 0 для всех). |
|
replay string |
Включить/отключить обнаружение повторов. Варианты:
|
|
route_overlap string |
Действие для перекрывающихся маршрутов. Варианты:
|
|
single_source string |
Включить/отключить ограничение по одному IP-адресу источника. Варианты:
|
|
src_addr_type string |
Тип локального идентификатора прокси. Варианты:
|
|
src_end_ip string |
Конечный адрес локального идентификатора прокси. |
|
src_end_ip6 string |
Конечный IPv6-адрес локального идентификатора прокси. |
|
src_name string |
Имя локального идентификатора прокси. Источник: firewall.address.name, firewall.addrgrp.name. |
|
src_name6 string |
Имя локального идентификатора прокси. Источник: firewall.address6.name, firewall.addrgrp6.name. |
|
src_port integer |
Порт источника быстрого режима (от 1 до 65535 или 0 для всех). |
|
src_start_ip string |
Начальный адрес локального идентификатора прокси. |
|
src_start_ip6 string |
Начальный IPv6-адрес локального идентификатора прокси. |
|
src_subnet string |
Подсеть локального идентификатора прокси. |
|
src_subnet6 string |
Подсеть IPv6 локального идентификатора прокси. |
Примечания
Примечание
- Устаревший fortiosapi больше не поддерживается; предпочтительный способ запуска плейбуков — httpapi
- Модуль поддерживает check_mode.
Примеры
- name: Configure VPN autokey tunnel.
fortinet.fortios.fortios_vpn_ipsec_phase2_interface:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
vpn_ipsec_phase2_interface:
add_route: "phase1"
addke1: "0"
addke2: "0"
addke3: "0"
addke4: "0"
addke5: "0"
addke6: "0"
addke7: "0"
auto_discovery_forwarder: "phase1"
auto_discovery_sender: "phase1"
auto_negotiate: "enable"
comments: "<your_own_value>"
dhcp_ipsec: "enable"
dhgrp: "1"
diffserv: "enable"
diffservcode: "<your_own_value>"
dst_addr_type: "subnet"
dst_end_ip: "<your_own_value>"
dst_end_ip6: "<your_own_value>"
dst_name: "<your_own_value> (source firewall.address.name firewall.addrgrp.name)"
dst_name6: "<your_own_value> (source firewall.address6.name firewall.addrgrp6.name)"
dst_port: "0"
dst_start_ip: "<your_own_value>"
dst_start_ip6: "<your_own_value>"
dst_subnet: "<your_own_value>"
dst_subnet6: "<your_own_value>"
encapsulation: "tunnel-mode"
inbound_dscp_copy: "phase1"
initiator_ts_narrow: "enable"
ipv4_df: "enable"
keepalive: "enable"
keylife_type: "seconds"
keylifekbs: "5120"
keylifeseconds: "43200"
l2tp: "enable"
name: "default_name_38"
pfs: "enable"
phase1name: "<your_own_value> (source vpn.ipsec.phase1-interface.name)"
proposal: "null-md5"
protocol: "0"
replay: "enable"
route_overlap: "use-old"
single_source: "enable"
src_addr_type: "subnet"
src_end_ip: "<your_own_value>"
src_end_ip6: "<your_own_value>"
src_name: "<your_own_value> (source firewall.address.name firewall.addrgrp.name)"
src_name6: "<your_own_value> (source firewall.address6.name firewall.addrgrp6.name)"
src_port: "0"
src_start_ip: "<your_own_value>"
src_start_ip6: "<your_own_value>"
src_subnet: "<your_own_value>"
src_subnet6: "<your_own_value>"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; далее перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
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_ipsec_phase2_interface_module.html