f5networks.f5_modules.bigip_ipsec_policy – Управление политиками IPSec на устройстве BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.7.1).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в книге задач укажите: f5networks.f5_modules.bigip_ipsec_policy.
Введено в версии 1.0.0: of f5networks.f5_modules
Обзор
- Управление политиками IPSec на устройстве BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| auth_algorithm строка |
| Указывает алгоритм, используемый для аутентификации IKE. | |
| description строка | Описание политики | ||
| encrypt_algorithm строка |
| Указывает алгоритм, используемый для шифрования IKE. | |
| ipcomp строка |
| Указывает, использовать ли IPComp для инкапсуляции. Когда none, указывает, что IPComp отключен.Когда deflate, указывает, что IPComp включен и использует алгоритм сжатия Deflate. | |
| ipv4_interface логическое |
| Когда mode является interface, указывает, следует ли использовать IPv4 any адрес. По умолчанию BIG-IP предполагает any6 адрес для адресов туннеля, когда mode является interface. Этот параметр действует только тогда, когда mode установлен на interface. | |
| kb_lifetime целое число | Указывает длительность, в килобайтах, до истечения срока действия ассоциации безопасности IKE. | ||
| lifetime целое число | Указывает длительность, в минутах, до истечения срока действия ассоциации безопасности IKE. | ||
| mode строка |
| Указывает режим обработки. Когда transport, задает режим, инкапсулирующий только полезную нагрузку (добавляя заголовок ESP, трейлер и тег аутентификации).Когда tunnel, задает режим, включающий инкапсуляцию заголовка и полезной нагрузки (добавляя новый IP-заголовок, помимо добавления заголовка ESP, трейлера и тега аутентификации). Если вы выбираете этот параметр, вы также должны указать IP-адреса локального и удаленного узлов IPsec-туннеля.Когда isession, задает использование iSession через IPsec-туннель. Чтобы использовать этот параметр, необходимо также настроить конечные точки iSession с IPsec в разделе «Ускорение» пользовательского интерфейса.Когда interface, указывает, что политика IPsec может использоваться в профиле туннеля для сетевых интерфейсов. | |
| name строка / обязательно | Указывает имя политики IPSec. | ||
| partition строка | Значение по умолчанию: "Common" | Раздел устройства для управления ресурсами. | |
| perfect_forward_secrecy строка |
| Указывает группу Diffie-Hellman для использования при переговорах IKE Phase 2. | |
| protocol строка |
| Указывает протокол IPsec. Варианты: ESP (Encapsulating Security Protocol) или AH (Authentication Header). | |
| provider словарь добавлен в 1.0.0 of f5networks.f5_modules | Объект словаря, содержащий данные подключения. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации с удаленного устройства. Этот параметр используется, когда работаете с устройствами BIG-IQ. | ||
| no_f5_teem логическое |
| Если yes, данные телеметрии TEEM не отправляются на F5.Вы можете опустить этот параметр, установив переменную среды F5_TEEM. | |
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD. псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port целое число | Значение по умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| timeout целое число | Указывает тайм-аут в секундах для связи с сетевым устройством для подключения или отправки команд. Если тайм-аут превышен до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs логическое |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самоподписанными сертификатами.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| route_domain целое число | Указывает домен маршрутизации, когда interface выбран для mode параметра. | ||
| state строка |
| Когда present, гарантирует существование ресурса.Когда absent, гарантирует удаление ресурса. | |
| tunnel_local_address строка | Указывает локальный IP-адрес конечной точки IPsec-туннеля. Этот параметр действителен только когда mode равен tunnel. | ||
| tunnel_remote_address строка | Указывает удаленный 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 строка | изменено | Новое значение алгоритма аутентификации IKE Phase 2. Пример: sha512 |
| description строка | изменено | Новое значение описания. Пример: Моя политика |
| encrypt_algorithm строка | изменено | Новое значение алгоритма шифрования IKE Phase 2. Пример: aes256 |
| ipcomp строка | изменено | Новое значение IPComp IKE Phase 2. Пример: deflate |
| kb_lifetime целое число | изменено | Новое значение срока действия KB IKE Phase 2. |
| lifetime целое число | изменено | Новое значение срока действия IKE Phase 2. Пример: 1440 |
| mode строка | изменено | Новое значение режима. Пример: tunnel |
| perfect_forward_secrecy строка | изменено | Новое значение Perfect Forward Secrecy IKE Phase 2. Пример: modp2048 |
| protocol строка | изменено | Новое значение протокола IPsec. Пример: ah |
| route_domain целое число | изменено | Новое значение Домена маршрутизации при использовании режима туннеля. Пример: 2 |
| tunnel_local_address строка | изменено | Новое значение локального адреса туннеля. Пример: 1.2.2.1 |
| tunnel_remote_address строка | изменено | Новое значение удаленного адреса туннеля. Пример: 2.1.1.2 |
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/f5networks/f5_modules/bigip_ipsec_policy_module.html
