Spec-Zone.ru › Ansible

Модуль f5networks.f5_modules.bigip_ipsec_policy — управление политиками IPsec на BIG-IP

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.39.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать коллекцию в плейбуке, укажите: f5networks.f5_modules.bigip_ipsec_policy.

Добавлено в f5networks.f5_modules 1.0.0

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управление политиками IPsec на устройстве BIG-IP.

Параметры

Параметр

Комментарии

auth_algorithm

string

Задает алгоритм для аутентификации IKE.

Варианты:

  • "sha1"
  • "sha256"
  • "sha384"
  • "sha512"
  • "aes-gcm128"
  • "aes-gcm192"
  • "aes-gcm256"
  • "aes-gmac128"
  • "aes-gmac192"
  • "aes-gmac256"

description

string

Описание политики

encrypt_algorithm

string

Задает алгоритм для шифрования IKE.

Варианты:

  • "none"
  • "3des"
  • "aes128"
  • "aes192"
  • "aes256"
  • "aes-gmac256"
  • "aes-gmac192"
  • "aes-gmac128"
  • "aes-gcm256"
  • "aes-gcm192"
  • "aes-gcm256"
  • "aes-gcm128"

ipcomp

string

Указывает, следует ли использовать инкапсуляцию IPComp.

Если задано none, IPComp отключен.

Если задано deflate, IPComp включен и использует алгоритм сжатия Deflate.

Варианты:

  • "none"
  • "null"
  • "deflate"

ipv4_interface

boolean

Если для параметра mode задано значение interface, указывает, следует ли использовать адрес IPv4 any. По умолчанию BIG-IP предполагает адрес any6 для адресов туннеля, если для параметра mode задано значение interface.

Этот параметр применяется только если для mode задано значение interface.

Варианты:

  • false
  • true

kb_lifetime

integer

Задает срок действия ассоциации безопасности IKE в килобайтах, по истечении которого она прекращает действие.

lifetime

integer

Задает срок действия ассоциации безопасности IKE в минутах, по истечении которого она прекращает действие.

mode

string

Задает режим обработки.

Если задано transport, указывает режим, в котором инкапсулируется только полезная нагрузка (добавляются заголовок ESP, трейлер и тег аутентификации).

Если задано tunnel, указывает режим, в котором инкапсулируются как заголовок, так и полезная нагрузка (добавляется новый IP-заголовок, а также заголовок ESP, трейлер и тег аутентификации). Если выбран этот параметр, необходимо также указать IP-адреса локальной и удаленной конечных точек туннеля IPsec.

Если задано isession, указывает на использование iSession через туннель IPsec. Чтобы использовать этот параметр, необходимо также настроить конечные точки iSession с IPsec в разделе «Ускорение» пользовательского интерфейса.

Если задано interface, указывает, что политика IPsec может использоваться в профиле туннеля для сетевых интерфейсов.

Варианты:

  • "transport"
  • "interface"
  • "isession"
  • "tunnel"

name

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

Задает имя политики IPsec.

partition

string

Раздел устройства, в котором будут управляться ресурсы.

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

perfect_forward_secrecy

string

Задает группу Диффи — Хеллмана для согласования IKE Phase 2.

Варианты:

  • "none"
  • "modp768"
  • "modp1024"
  • "modp1536"
  • "modp2048"
  • "modp3072"
  • "modp4096"
  • "modp6144"
  • "modp8192"

protocol

string

Задает протокол IPsec.

Доступны варианты ESP (протокол инкапсуляции защитных данных) или AH (заголовок аутентификации).

Варианты:

  • "esp"
  • "ah"

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Словарь с данными для подключения.

auth_provider

string

Настраивает поставщика аутентификации для получения токенов аутентификации от удаленного устройства.

Этот параметр используется при работе с устройствами BIG-IQ.

no_f5_teem

boolean

Если задано yes, данные телеметрии TEEM не отправляются в F5.

Этот параметр можно не указывать, задав переменную окружения F5_TELEMETRY_OFF.

Ранее использовавшаяся переменная F5_TEEM считается устаревшей, поскольку ее название было неоднозначным.

Варианты:

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

password

псевдонимы: pass, pwd

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

Пароль учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную окружения F5_PASSWORD.

server

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

Узел BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную окружения F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Этот параметр можно не указывать, задав переменную окружения F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

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

transport

string

Настраивает транспортное соединение для подключения к удаленному устройству.

Варианты:

  • "rest" ← (по умолчанию)

user

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

Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь права администратора на устройстве.

Этот параметр можно не указывать, задав переменную окружения F5_USER.

validate_certs

boolean

Если задано no, SSL-сертификаты не проверяются. Используйте этот параметр только на подконтрольных вам сайтах с самоподписанными сертификатами.

Этот параметр можно не указывать, задав переменную окружения F5_VALIDATE_CERTS.

Варианты:

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

route_domain

integer

Задает домен маршрутизации, если для параметра mode выбрано значение interface.

state

string

Если задано present, обеспечивает наличие ресурса.

Если задано absent, обеспечивает удаление ресурса.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tunnel_local_address

string

Задает IP-адрес локальной конечной точки туннеля IPsec.

Этот параметр действителен только если mode имеет значение tunnel.

tunnel_remote_address

string

Задает IP-адрес удаленной конечной точки туннеля IPsec.

Этот параметр действителен только если mode имеет значение tunnel.

Примечания

Примечание

  • Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
  • Требуется версия программного обеспечения BIG-IP >= 12.
  • Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы сохранить конфигурацию BIG-IP на диске, обязательно включите хотя бы одну задачу, использующую модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Инструкции по правильному использованию модуля для сохранения текущей конфигурации см. в документации модуля.

Примеры

- name: Create a IPSec policy
  bigip_ipsec_policy:
    name: policy1
    mode: tunnel
    tunnel_local_address: 1.1.1.1
    tunnel_remote_address: 2.2.2.
    auth_algorithm: sha1
    encrypt_algorithm: 3des
    protocol: esp
    perfect_forward_secrecy: modp1024
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ

Описание

auth_algorithm

string

Новое значение алгоритма аутентификации IKE Phase 2.

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

Пример: "sha512"

description

string

Новое значение описания.

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

Пример: "My policy"

encrypt_algorithm

string

Новое значение алгоритма шифрования IKE Phase 2.

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

Пример: "aes256"

ipcomp

string

Новое значение IPComp для IKE Phase 2.

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

Пример: "deflate"

kb_lifetime

integer

Новое значение срока действия IKE Phase 2 в килобайтах.

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

Пример: 0

lifetime

integer

Новое значение срока действия IKE Phase 2.

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

Пример: 1440

mode

string

Новое значение режима.

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

Пример: "tunnel"

perfect_forward_secrecy

string

Новое значение Perfect Forward Secrecy для IKE Phase 2.

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

Пример: "modp2048"

protocol

string

Новое значение протокола IPsec.

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

Пример: "ah"

route_domain

integer

Новое значение домена маршрутизации в режиме туннеля.

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

Пример: 2

tunnel_local_address

string

Новое значение локального адреса туннеля.

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

Пример: "1.2.2.1"

tunnel_remote_address

string

Новое значение удаленного адреса туннеля.

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

Пример: "2.1.1.2"

Авторы

  • Tim Rupp (@caphrim007)
  • Wojciech Wypior (@wojtek0806)

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

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

© 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/f5networks/f5_modules/bigip_ipsec_policy_module.html

Spec-Zone.ru

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