f5networks.f5_modules.bigip_asm_policy_import – Управление импортом политик BIG-IP ASM
Примечание
Этот плагин является частью коллекции f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в playbook, укажите: f5networks.f5_modules.bigip_asm_policy_import.
Новое в версии 1.0.0: из f5networks.f5_modules
Обзор
- Управление импортом политик для политик BIG-IP ASM.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| base64 логическое |
| Указывает, закодирована ли импортированная строка политики в Base64. Параметр действует только при использовании метода импорта inline. | |
| encoding строка |
| Указывает желаемый язык приложения импортированной политики. Импортированная политика не может быть типа parent или прикреплена к политике parent при установке кодировки auto-detect.При импорте политики для присоединения к политике parent, encoding импортированной политики, если отличается, должно быть установлено такое же значение, как parent_policy, иначе импорт завершится ошибкой.Этот параметр доступен в TMOS версии 13.x и выше и действует только при использовании метода импорта inline. | |
| force логическое |
| При установке в yes, любая существующая политика с тем же именем будет перезаписана новым импортом.Действует как для импорта в строке, так и из файла, если политика не существует, это значение игнорируется. | |
| inline строка | При указании, политика ASM создается из предоставленной строки. Содержание должно быть в формате XML, в противном случае операция завершится ошибкой. | ||
| name строка / обязательно | Политика ASM для создания или перезаписи. | ||
| parent_policy строка | Родительская политика, к которой новая импортированная политика должна быть прикреплена в качестве дочерней. Когда указан parent_policy, импортированная policy_type не должна быть parent.Этот параметр доступен в TMOS версии 13.x и выше и действует только при использовании метода импорта inline. | ||
| partition строка | Значение по умолчанию: "Общая" | Раздел устройства, на котором нужно создать политику. Этот параметр также применяется для указания раздела политики parent. | |
| policy_type строка |
| Тип импортируемой политики. Когда policy_type равно security, политика импортируется как политика безопасности приложения, которую можно применить к виртуальному серверу.Когда policy_type равно parent, политика становится родительской, к которой присоединяются другие политики безопасности, наследуя ее атрибуты. Этот тип политики не может применяться к виртуальным серверам.Этот параметр доступен в TMOS версии 13.x и выше и действует только при использовании метода импорта inline. | |
| provider словарь добавлено в 1.0.0 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. | |
| retain_inheritance_settings логическое |
| Указывает, сохранит ли импортированная политика типа безопасности настройки при присоединении к родительской политике. Этот параметр доступен в TMOS версии 13.x и выше и действует только при использовании метода импорта inline. | |
| source путь | Полный путь к файлу политики, который нужно импортировать в BIG-IP ASM. Файлы политик, экспортированные из более новых версий BIG-IP, не могут быть импортированы в более старые версии BIG-IP. Обратное, однако, верно; можно импортировать старые в новые. Формат файла может быть двоичным или XML. | ||
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия ПО BIG-IP >= 12.
- Модули F5 манипулируют только текущей конфигурацией продукта F5. Чтобы гарантировать сохранение конфигурации BIG-IP на диске, убедитесь, что в вашем задании присутствует хотя бы одна задача, использующая модуль f5networks.f5_modules.bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения конфигурации.
Примеры
- name: Import ASM policy
bigip_asm_policy_import:
name: new_asm_policy
file: /root/asm_policy.xml
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Import ASM policy inline
bigip_asm_policy_import:
name: foo-policy4
inline: <xml>content</xml>
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Override existing ASM policy
bigip_asm_policy:
name: new_asm_policy
source: /root/asm_policy_new.xml
force: yes
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| base64 boolean | изменённое | Указывает, закодирована ли импортированная строка политики в Base64. Пример: True |
| encoding string | изменённое | Желаемый язык приложения импортированной политики. Пример: utf-8 |
| force boolean | изменённое | Устанавливается при перезаписи существующей политики. Пример: True |
| inline string | изменённое | Содержание политики в виде строки. Пример: <xml>foobar содержимое</xml> |
| name string | изменённое | Имя политики ASM, подлежащей созданию/перезаписи. Пример: Asm_APP1_Transparent |
| parent_policy string | изменённое | Родительская политика, к которой новая импортированная политика должна быть прикреплена как дочерняя. Пример: /Common/parent |
| policy_type string | изменённое | Тип политики для импорта. Пример: security |
| retain_inheritance_settings boolean | изменённое | Указывает, должна ли импортированная политика типа безопасности сохранять настройки при присоединении к родительской политике. Пример: True |
| source string | изменённое | Локальный путь к файлу политики ASM. Пример: /root/some_policy.xml |
Авторы
- Wojciech Wypior (@wojtek0806)
- Nitin Khanna (@nitinthewiz)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_asm_policy_import_module.html
