panos_security_rule - Создание политики правил безопасности на устройствах PAN-OS или консоли управления Panorama.
Новое в версии 2.4.
Описание
- Политики безопасности позволяют вам применять правила и выполнять действия, и могут быть такими же общими или специфичными, как необходимо. Правила политики сравниваются с входящим трафиком последовательно, и поскольку первое правило, соответствующее трафику, применяется, более конкретные правила должны предшествовать более общим.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- pan-python можно получить из PyPi https://pypi.org/project/pan-python/
- pandevice можно получить из PyPi https://pypi.org/project/pandevice/
- xmltodict можно получить из PyPi https://pypi.org/project/xmltodict/
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| action | Значение по умолчанию: allow | Действие, применяемое после совпадения правил. |
| antivirus | Значение по умолчанию: None | Название уже определенного профиля антивируса. |
| api_key | Ключ API, который можно использовать вместо учетных данных username/password. | |
| application | Значение по умолчанию: any | Список приложений. |
| commit | Значение по умолчанию: yes | Зафиксировать изменения конфигурации. |
| data_filtering | Значение по умолчанию: None | Название уже определенного профиля фильтрации данных. |
| description | Значение по умолчанию: None | Описание правила безопасности. |
| destination_ip | Значение по умолчанию: any | Список адресов назначения. |
| destination_zone | Значение по умолчанию: any | Список зон назначения. |
| devicegroup | Значение по умолчанию: None | - Группы устройств используются для взаимодействия Panorama с брандмауэром(ами). Группа должна существовать в Panorama. Если группа устройств не определена, предполагается, что мы связываемся с брандмауэром. |
| file_blocking | Значение по умолчанию: None | Название уже определенного профиля блокировки файлов. |
| group_profile | Значение по умолчанию: None | - Группа профилей безопасности, которая уже определена в системе. Эта свойство перекрывает свойства antivirus, vulnerability, spyware, url_filtering, file_blocking, data_filtering и wildfire_analysis. |
| hip_profiles | Значение по умолчанию: any | - Если вы используете GlobalProtect с включенным профилем информации об узле (HIP), вы также можете основывать политику на информации, собранной GlobalProtect. Например, уровень доступа пользователя может быть определён HIP, который информирует брандмауэр о локальной конфигурации пользователя. |
| ip_address обязательно | IP-адрес (или имя хоста) устройства PAN-OS, которое настраивается. | |
| log_end | Значение по умолчанию: yes | Вести журнал по завершении сеанса. |
| log_start | Значение по умолчанию: no | Вести журнал при запуске сеанса. |
| operation | Значение по умолчанию: add | Действие, которое нужно выполнить. Доступные значения: add/update/find/delete. |
| password обязательно | Пароль для аутентификации, если не установлен api_key. | |
| rule_name обязательно | Название правила безопасности. | |
| rule_type | Значение по умолчанию: universal | Тип правила безопасности (версия PanOS 6.1 и выше). |
| service | Значение по умолчанию: application-default | Список сервисов. |
| source_ip | Значение по умолчанию: any | Список исходных адресов. |
| source_user | Значение по умолчанию: any | Использование пользователей для применения политики для отдельных пользователей или группы пользователей. |
| source_zone | Значение по умолчанию: any | Список исходных зон. |
| spyware | Значение по умолчанию: None | Название уже определенного профиля шпионского ПО. |
| tag_name | Значение по умолчанию: None | Административные теги, которые можно добавить к правилу. Примечание: теги должны быть уже определены. |
| url_filtering | Значение по умолчанию: None | Название уже определенного профиля фильтрации URL. |
| username | Значение по умолчанию: admin | Имя пользователя для аутентификации, если не установлен api_key. |
| vulnerability | Значение по умолчанию: None | Название уже определенного профиля уязвимостей. |
| wildfire_analysis | Значение по умолчанию: None | Название уже определенного профиля анализа Wildfire. |
Примечания
Примечание
- Режим проверки (checkmode) не поддерживается.
- Поддерживается Panorama.
Примеры
- name: add an SSH inbound rule to devicegroup
panos_security_rule:
ip_address: '{{ ip_address }}'
username: '{{ username }}'
password: '{{ password }}'
operation: 'add'
rule_name: 'SSH permit'
description: 'SSH rule test'
tag_name: ['ProjectX']
source_zone: ['public']
destination_zone: ['private']
source_ip: ['any']
source_user: ['any']
destination_ip: ['1.1.1.1']
category: ['any']
application: ['ssh']
service: ['application-default']
hip_profiles: ['any']
action: 'allow'
devicegroup: 'Cloud Edge'
- name: add a rule to allow HTTP multimedia only from CDNs
panos_security_rule:
ip_address: '10.5.172.91'
username: 'admin'
password: 'paloalto'
operation: 'add'
rule_name: 'HTTP Multimedia'
description: 'Allow HTTP multimedia only to host at 1.1.1.1'
source_zone: ['public']
destination_zone: ['private']
source_ip: ['any']
source_user: ['any']
destination_ip: ['1.1.1.1']
category: ['content-delivery-networks']
application: ['http-video', 'http-audio']
service: ['service-http', 'service-https']
hip_profiles: ['any']
action: 'allow'
- name: add a more complex rule that uses security profiles
panos_security_rule:
ip_address: '{{ ip_address }}'
username: '{{ username }}'
password: '{{ password }}'
operation: 'add'
rule_name: 'Allow HTTP w profile'
log_start: false
log_end: true
action: 'allow'
antivirus: 'default'
vulnerability: 'default'
spyware: 'default'
url_filtering: 'default'
wildfire_analysis: 'default'
- name: delete a devicegroup security rule
panos_security_rule:
ip_address: '{{ ip_address }}'
api_key: '{{ api_key }}'
operation: 'delete'
rule_name: 'Allow telnet'
devicegroup: 'DC Firewalls'
- name: find a specific security rule
panos_security_rule:
ip_address: '{{ ip_address }}'
password: '{{ password }}'
operation: 'find'
rule_name: 'Allow RDP to DCs'
register: result
- debug: msg='{{result.stdout_lines}}'
Статус
Этот модуль помечен как предварительный просмотр, что означает, что его интерфейс не гарантируется как обратная совместимость.
Автор
- Иван Божер (@ivanbojer), Роберт Хэген (@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_security_rule_module.html