bigip_ipsec_policy – Управление политиками IPSec на BIG-IP
Новая в версии 2.8.
Описание
- Управление политиками IPSec на BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| auth_algorithm строка |
| Указывает алгоритм, используемый для аутентификации IKE. | |
| description строка | Описание политики | ||
| encrypt_algorithm строка |
| Указывает алгоритм, используемый для шифрования IKE. | |
| ipcomp строка |
| Указывает, использовать ли IPComp инкапсуляцию. Когда none, указывает, что IPComp отключен.Когда deflate, указывает, что IPComp включен и использует алгоритм сжатия Deflate. | |
| ipv4_interface логическое добавлено в 2.9 |
| Когда 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 строка | По умолчанию: "Общие" | Раздел устройства для управления ресурсами. | |
| perfect_forward_secrecy строка |
| Указывает группу Diffie-Hellman для использования в соглашении о безопасности IKE Phase 2. | |
| protocol строка |
| Указывает протокол IPsec Варианты включают ESP (протокол инкапсулирующей безопасности) или AH (заголовок аутентификации). | |
| provider словарь добавлено в 2.5 | Объект словаря, содержащий сведения о подключении. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации с удалённого устройства. Этот параметр фактически используется при работе с устройствами BIG-IQ. | ||
| password строка / обязательно | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| server_port целое число | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| ssh_keyfile путь | Указывает SSH-ключевой файл для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов cli. Вы можете опустить этот параметр, установив переменную среды ANSIBLE_NET_SSH_KEYFILE. | ||
| 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, сохранится на диске, обязательно включите хотя бы одну задачу, которая использует модуль 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 строка | изменено | Новое значение IKE Phase 2 IPComp. Пример: deflate |
| kb_lifetime целое число | изменено | Новое значение срока действия KB IKE Phase 2. |
| lifetime целое число | изменено | Новое значение срока действия IKE Phase 2. Пример: 1440 |
| mode строка | изменено | Новое значение Mode. Пример: tunnel |
| perfect_forward_secrecy строка | изменено | Новое значение Perfect Forward Secrecy IKE Phase 2. Пример: modp2048 |
| protocol строка | изменено | Новое значение IPsec Protocol. Пример: ah |
| route_domain целое число | изменено | Новое значение Route Domain при режиме Tunnel. Пример: 2 |
| tunnel_local_address строка | изменено | Новое значение Tunnel Local Address. Пример: 1.2.2.1 |
| tunnel_remote_address строка | изменено | Новое значение Tunnel Remote Address. Пример: 2.1.1.2 |
Статус
- Данный модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается партнером Ansible. [сертифицировано]
Авторы
- Tim Rupp (@caphrim007)
- Wojciech Wypior (@wojtek0806)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/bigip_ipsec_policy_module.html
