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 - | Имя приложения или группы приложений для запроса. | |
| destination_ip - | Запрашиваемый IP-адрес назначения. | |
| destination_port - | Запрашиваемый порт назначения. | |
| destination_zone - | Имя запрашиваемой зоны безопасности назначения. | |
| devicegroup - | Группа устройств Panorama, в которой необходимо выполнить запрос. | |
| ip_address - / обязательно | IP-адрес (или имя хоста) маршрутизатора PAN-OS или консоли управления Panorama, к которой осуществляется запрос. | |
| password - / обязательно | Пароль для аутентификации. | |
| protocol - | Используемый протокол для запроса. Должен быть tcp или udp. | |
| source_ip - | Запрашиваемый IP-адрес источника. | |
| source_port - | Запрашиваемый порт источника. | |
| source_zone - | Имя запрашиваемой зоны безопасности источника. | |
| tag_name - | Имя тега правила для запроса. | |
| 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'
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.7/modules/panos_query_rules_module.html