community.network.panos_security_rule – Создание политики правил безопасности на устройствах PAN-OS или консоли управления Panorama.
Примечание
Этот плагин является частью коллекции community.network (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в playbook, укажите: community.network.panos_security_rule.
УСТАРЕВШИЙ
- Удалено в
-
версии 2.0.0
- Почему
-
Консолидация кодовой базы.
- Альтернатива
-
Используйте https://galaxy.ansible.com/PaloAltoNetworks/paloaltonetworks вместо этого.
Краткое описание
- Политики безопасности позволяют применять правила и предпринимать действия, и могут быть как общими, так и специфическими по необходимости. Правила политики сравниваются с входящим трафиком последовательно, и поскольку применяется первое правило, соответствующее трафику, более специфические правила должны предшествовать более общим.
Требования
Ниже перечислены требования, необходимые на хосте, который выполняет этот модуль.
- 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 строка | Имя уже определенного профиля антивируса. | |
| api_key строка | API ключ, который может быть использован вместо учетных данных username/password. | |
| application строка | Значение по умолчанию: "any" | Список приложений. |
| category список / элементы=строка | Значение по умолчанию: ["any"] | Категория. |
| commit логическое |
| Зафиксировать конфигурацию, если она изменена. |
| data_filtering строка | Имя уже определенного профиля data_filtering. | |
| description строка | Описание правила безопасности. | |
| destination_ip строка | Значение по умолчанию: "any" | Список адресов назначения. |
| destination_zone строка | Значение по умолчанию: "any" | Список зон назначения. |
| devicegroup строка | - Группы устройств используются для взаимодействия Panorama с брандмауэром (ами). Группа должна существовать в Panorama. Если группа устройств не определена, мы предполагаем, что мы контактируем с брандмауэром. | |
| file_blocking строка | Имя уже определенного профиля file_blocking. | |
| group_profile строка | - Группа профилей безопасности, которая уже определена в системе. Это свойство заменяет свойства 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 логическое |
| Вести ли логирование в конце сессии. |
| log_start логическое |
| Вести ли логирование в начале сессии. |
| operation строка |
| Действие, которое нужно выполнить. Поддерживаемые значения: add/update/find/delete. |
| password строка / обязательно | Учетные данные пароля для аутентификации, если не установлен api_key. | |
| rule_name строка / обязательно | Имя правила безопасности. | |
| rule_type строка | Значение по умолчанию: "universal" | Тип правила безопасности (версия 6.1 PanOS и выше). |
| service строка | Значение по умолчанию: "application-default" | Список сервисов. |
| source_ip строка | Значение по умолчанию: "any" | Список исходных адресов. |
| source_user строка | Значение по умолчанию: "any" | Используйте пользователей для применения политики для отдельных пользователей или группы пользователей. |
| source_zone строка | Значение по умолчанию: "any" | Список исходных зон. |
| spyware строка | Имя уже определенного профиля spyware. | |
| tag_name строка | Административные теги, которые могут быть добавлены к правилу. Обратите внимание, теги должны быть уже определены. | |
| url_filtering строка | Имя уже определенного профиля url_filtering. | |
| username строка | Значение по умолчанию: "admin" | Учетные данные имени пользователя для аутентификации, если не установлен api_key. |
| vulnerability строка | Имя уже определенного профиля vulnerability. | |
| wildfire_analysis строка | Имя уже определенного профиля wildfire_analysis. |
Примечания
Примечание
- Checkmode не поддерживается.
- Panorama поддерживается.
Примеры
- name: Add an SSH inbound rule to devicegroup
community.network.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
community.network.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
community.network.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
community.network.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
community.network.panos_security_rule:
ip_address: '{{ ip_address }}'
password: '{{ password }}'
operation: 'find'
rule_name: 'Allow RDP to DCs'
register: result
- ansible.builtin.debug: msg='{{result.stdout_lines}}'
Статус
- Этот модуль будет удален в версии 2.0.0. [устаревший]
- Для получения дополнительной информации см. УСТАРЕВШИЙ.
Авторы
- Ivan Bojer (@ivanbojer), Robert 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.10/collections/community/network/panos_security_rule_module.html