avi_wafpolicy - Модуль для настройки объекта WafPolicy Avi RESTful
Новая версия с 2.5.
Обзор
- Этот модуль используется для конфигурации объекта WafPolicy.
- Дополнительные примеры см. на https://github.com/avinetworks/devops
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- avisdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_context (добавлено в 2.5) | Контекст API Avi, включающий текущий идентификатор сеанса и маркер CSRF. Это позволяет пользователю выполнить однократный вход и повторно использовать сеанс. | |
| api_version | Значение по умолчанию: 16.4.4 | Версия API Avi, используемая для API Avi и объектов. |
| avi_api_patch_op (добавлено в 2.5) |
| Операция исправления, используемая при использовании avi_api_update_method как patch. |
| avi_api_update_method (добавлено в 2.5) |
| Метод по умолчанию для обновления объекта — HTTP PUT. Установка на patch приведет к изменению поведения для использования HTTP PATCH. |
| avi_credentials (добавлено в 2.5) | Словарь учетных данных Avi, который может быть использован вместо перечисления данных входа в контроллер Avi. | |
| controller | Значение по умолчанию: | IP-адрес или имя хоста контроллера. Значение по умолчанию — переменная среды AVI_CONTROLLER. |
| created_by | Имя создателя. Поле добавлено в 17.2.4. | |
| crs_groups | Правила Waf категоризированы в группы на основе их характеристик. Эти группы создаются системой с crs groups. Поле добавлено в 17.2.1. | |
| description | Поле добавлено в 17.2.1. | |
| mode обязательно | Режим политики Waf. Это может быть обнаружение или принудительное выполнение. Варианты перечисления — WAF_MODE_DETECTION_ONLY, WAF_MODE_ENFORCEMENT. Поле добавлено в 17.2.1. Значение по умолчанию, если оно не указано в API или модуле, интерпретируется контроллером Avi как WAF_MODE_DETECTION_ONLY. | |
| name обязательно | Поле добавлено в 17.2.1. | |
| paranoia_level | Режим паранойи набора правил Waf. Это используется для выбора правил на основе тега уровня паранойи. Варианты перечисления — WAF_PARANOIA_LEVEL_LOW, WAF_PARANOIA_LEVEL_MEDIUM, WAF_PARANOIA_LEVEL_HIGH, WAF_PARANOIA_LEVEL_EXTREME. Поле добавлено в 17.2.1. Значение по умолчанию, если оно не указано в API или модуле, интерпретируется контроллером Avi как WAF_PARANOIA_LEVEL_LOW. | |
| password | Значение по умолчанию: | Пароль пользователя Avi в контроллере Avi. Значение по умолчанию — переменная среды AVI_PASSWORD. |
| post_crs_groups | Правила Waf категоризированы в группы на основе их характеристик. Эти группы создаются пользователем и будут применяться после групп crs. Поле добавлено в 17.2.1. | |
| pre_crs_groups | Правила Waf категоризированы в группы на основе их характеристик. Эти группы создаются пользователем и будут применяться перед группами crs. Поле добавлено в 17.2.1. | |
| state |
| Состояние, которое должно быть применено к сущности. |
| tenant | Значение по умолчанию: admin | Имя клиента, используемого для всех вызовов API Avi и контекста объекта. |
| tenant_ref | Ссылка на объект типа tenant. Поле добавлено в 17.2.1. | |
| tenant_uuid | Значение по умолчанию: | UUID клиента, используемого для всех вызовов API Avi и контекста объекта. |
| url | URL контроллера Avi объекта. | |
| username | Значение по умолчанию: | Имя пользователя, используемого для доступа к контроллеру Avi. Значение по умолчанию — переменная среды AVI_USERNAME. |
| uuid | Поле добавлено в 17.2.1. | |
| waf_profile_ref обязательно | Профиль Waf для политики waf. Ссылка на объект типа wafprofile. Поле добавлено в 17.2.1. |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами сети Avi см. на https://www.ansible.com/ansible-avi-networks.
Примеры
- name: Example to create WafPolicy object
avi_wafpolicy:
controller: 10.10.25.42
username: admin
password: something
state: present
name: sample_wafpolicy
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже приведены поля, уникальные для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| obj словарь | success, changed | Объект WafPolicy (api/wafpolicy) |
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость.
Автор
- Гaurav Rastogi (grastogi@avinetworks.com)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/avi_wafpolicy_module.html