panos_query_rules - Модуль PANOS, позволяющий искать правила безопасности на устройствах PANW NGFW.
Новая версия 2.5.
Обзор
-
- Политики безопасности позволяют применять правила и принимать действия, и могут быть как общими, так и специфичными. Правила политики сравниваются с входящим трафиком последовательно, и поскольку применяется первое правило, которое соответствует трафику, более специфичные правила должны предшествовать более общим.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- pan-python можно получить с PyPi https://pypi.org/project/pan-python/
- pandevice можно получить с PyPi https://pypi.org/project/pandevice/
- xmltodict можно получить с PyPi https://pypi.org/project/xmltodict/
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key | Ключ API, который можно использовать вместо учетных данных username/password. | |
| application | Значение по умолчанию: None | Имя приложения или группы приложений для запроса. |
| destination_ip | Значение по умолчанию: None | Запрашиваемый IP-адрес назначения. |
| destination_port | Значение по умолчанию: None | Запрашиваемый порт назначения. |
| destination_zone | Значение по умолчанию: None | Имя зоны безопасности назначения для запроса. |
| devicegroup | Значение по умолчанию: None | Группа устройств Panorama, в которой нужно выполнить запрос. |
| ip_address обязательно | IP-адрес (или имя хоста) брандмауэра PAN-OS или консоли управления Panorama, к которому осуществляется запрос. | |
| password обязательно | Пароль для аутентификации. | |
| protocol | Значение по умолчанию: None | Протокол, используемый для запроса. Должен быть либо tcp, либо udp. |
| source_ip | Значение по умолчанию: None | Запрашиваемый IP-адрес источника. |
| source_port | Значение по умолчанию: None | Запрашиваемый порт источника. |
| source_zone | Значение по умолчанию: None | Имя зоны безопасности источника для запроса. |
| tag_name | Значение по умолчанию: None | Имя тега правила для запроса. |
| username | Значение по умолчанию: admin | Имя пользователя для аутентификации. |
Примечания
Примечание
- Режим проверки (checkmode) не поддерживается.
- Поддерживается Panorama.
Примеры
- name: search for rules with tcp/3306
panos_query_rules:
ip_address: '{{ ip_address }}'
username: '{{ username }}'
password: '{{ password }}'
source_zone: 'DevNet'
destination_zone: 'DevVPC'
destination_port: '3306'
protocol: 'tcp'
- name: search devicegroup for inbound rules to dmz host
panos_query_rules:
ip_address: '{{ ip_address }}'
api_key: '{{ api_key }}'
destination_zone: 'DMZ'
destination_ip: '10.100.42.18'
address: 'DeviceGroupA'
- name: search for rules containing a specified rule tag
panos_query_rules:
ip_address: '{{ ip_address }}'
username: '{{ username }}'
password: '{{ password }}'
tag_name: 'ProjectX'
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратной совместимости.
Автор
- Bob Hagen (@rnh556)
Подсказка
Если вы обнаружите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/panos_query_rules_module.html