aws_waf_facts - Получение фактов для WAF ACL, правил, условий и фильтров.
Новое в версии 2.4.
Обзор
- Получение фактов для WAF ACL, правил, условий и фильтров.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- boto
- boto3
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aws_access_key | Значение по умолчанию: None | Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key |
| aws_secret_key | Значение по умолчанию: None | Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key |
| ec2_url | Значение по умолчанию: None | URL для подключения к облаку EC2 или Eucalyptus (по умолчанию используются конечные точки EC2). Игнорируется для модулей, где необходим регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковая имеется. |
| name | Имя системы Web Application Firewall | |
| profile (добавлен в 1.6) | Значение по умолчанию: None | Использует профиль boto. Работает только с boto >= 2.24.0. |
| region | AWS регион для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если таковая имеется. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
Псевдонимы: aws_region, ec2_region | |
| security_token (добавлен в 1.6) | Значение по умолчанию: None | AWS STS security token. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token |
| validate_certs (добавлен в 1.5) |
| Если установлено "no", сертификаты SSL для boto версий >= 2.6.0 не будут проверяться. |
Примечания
Примечание
- Если параметры не заданы в модуле, могут быть использованы следующие переменные окружения в порядке убывания приоритета
AWS_URLилиEC2_URL,AWS_ACCESS_KEY_IDилиAWS_ACCESS_KEYилиEC2_ACCESS_KEY,AWS_SECRET_ACCESS_KEYилиAWS_SECRET_KEYилиEC2_SECRET_KEY,AWS_SECURITY_TOKENилиEC2_SECURITY_TOKEN,AWS_REGIONилиEC2_REGION - Ansible использует файл конфигурации boto (обычно ~/.boto), если учетные данные не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
-
AWS_REGIONилиEC2_REGIONмогут использоваться для указания AWS региона, если требуется, но это также можно настроить в файле конфигурации boto
Примеры
- name: obtain all WAF facts
aws_waf_facts:
- name: obtain all facts for a single WAF
aws_waf_facts:
name: test_waf
Возвращаемые значения
Общие возвращаемые значения описаны в здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание | ||
|---|---|---|---|---|
| wafs сложный | success | WAF, соответствующие переданным аргументам | ||
| rules сложный | всегда | Массив, содержащий действие для каждого правила в WebACL и приоритет правила. | ||
| action строка | всегда | Действие, выполняемое при совпадении правила. Пример: BLOCK | ||
| predicates список | всегда | Список предикатов содержит предикат для каждого объекта ByteMatchSet, IPSet, SizeConstraintSet, SqlInjectionMatchSet или XssMatchSet в правиле. Пример: [{'negated': False, 'byte_match_set_id': '47b822b5-abcd-1234-faaf-1234567890', 'byte_match_tuples': [{'text_transformation': 'NONE', 'field_to_match': {'type': 'QUERY_STRING'}, 'target_string': 'bobbins', 'positional_constraint': 'STARTS_WITH'}], 'type': 'ByteMatch', 'name': 'bobbins'}] | ||
| metric_name строка | всегда | Наименование или описание метрик для этого правила. Пример: ipblockrule | ||
| name строка | всегда | Наименование или описание правила. Пример: ip_block_rule | ||
| default_action целое число | всегда | Действие, выполняемое, если ни одно из правил WebACL не совпадает. Пример: BLOCK | ||
| name строка | всегда | Наименование или описание WebACL. Пример: test_waf | ||
| metric_name строка | всегда | Наименование или описание метрик для данного WebACL. Пример: test_waf_metric | ||
Статус
Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется как обратная совместимость.
Автор
- Mike Mochan (@mmochan)
- Will Thames (@willthames)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/aws_waf_facts_module.html