panos_security_policy - Создание политики правил безопасности на устройствах PanOS.
Новая в версии 2.3.
УСТАРЕЛО
| Удалено в Ansible: | |
|---|---|
| версия: 2.9 | |
| Почему: | Этот модуль зависел от устаревшего SDK. В версии 2.4 используйте panos_security_rule вместо него. |
| Альтернатива: | Используйте panos_security_rule вместо этого. |
Обзор
- Политики безопасности позволяют вам применять правила и совершать действия, и могут быть как общими, так и специфичными по мере необходимости. Правила политики сравниваются с входящим трафиком последовательно, и поскольку первое правило, соответствующее трафику, применяется, более конкретные правила должны предшествовать более общим.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- pan-python можно получить с PyPi https://pypi.org/project/pan-python/
- pandevice можно получить с PyPi https://pypi.org/project/pandevice/
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| action | Значение по умолчанию: allow | Действие, применяемое после совпадения с правилами. |
| antivirus | Значение по умолчанию: None | Имя уже определенного профиля антивируса. |
| api_key | Ключ API, который можно использовать вместо учетных данных username/password. | |
| application | Значение по умолчанию: any | Список приложений. |
| commit | Значение по умолчанию: yes | Сохранить конфигурацию при изменении. |
| data_filtering | Значение по умолчанию: None | Имя уже определенного профиля фильтрации данных. |
| description | Значение по умолчанию: None | Описание правила безопасности. |
| destination | Значение по умолчанию: any | Список адресов назначения. |
| devicegroup | Значение по умолчанию: None | Группы устройств используются для взаимодействия Panorama с брандмауэром(ами). Группа должна существовать в Panorama. Если группа устройств не определена, предполагается, что мы обращаемся к брандмауэру. |
| file_blocking | Значение по умолчанию: None | Имя уже определенного профиля блокировки файлов. |
| from_zone | Значение по умолчанию: any | Список исходных зон. |
| 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 | Вести ли протокол при старте сессии. |
| password обязательно | Пароль для аутентификации, если не указан api_key. | |
| rule_name обязательно | Название правила безопасности. | |
| rule_type | Значение по умолчанию: universal | Тип правила безопасности (версия PanOS 6.1 и выше). |
| service | Значение по умолчанию: application-default | Список служб. |
| source | Значение по умолчанию: any | Список исходных адресов. |
| source_user | Значение по умолчанию: any | Использование пользователей для принудительного выполнения политики для отдельных пользователей или группы пользователей. |
| spyware | Значение по умолчанию: None | Имя уже определенного профиля шпионского ПО. |
| tag | Значение по умолчанию: None | Административные метки, которые могут быть добавлены к правилу. Обратите внимание, что метки должны быть уже определены. |
| to_zone | Значение по умолчанию: any | Список зон назначения. |
| url_filtering | Значение по умолчанию: None | Имя уже определенного профиля фильтрации URL. |
| username | Значение по умолчанию: admin | Имя пользователя для аутентификации, если не указан api_key. |
| vulnerability | Значение по умолчанию: None | Имя уже определенного профиля уязвимости. |
| wildfire_analysis | Значение по умолчанию: None | Имя уже определенного профиля анализа Wildfire. |
Примечания
Примечание
- Режим проверки (checkmode) не поддерживается.
- Поддерживается Panorama
Примеры
- name: permit ssh to 1.1.1.1
panos_security_policy:
ip_address: '10.5.172.91'
username: 'admin'
password: 'paloalto'
rule_name: 'SSH permit'
description: 'SSH rule test'
from_zone: ['public']
to_zone: ['private']
source: ['any']
source_user: ['any']
destination: ['1.1.1.1']
category: ['any']
application: ['ssh']
service: ['application-default']
hip_profiles: ['any']
action: 'allow'
commit: false
- name: Allow HTTP multimedia only from CDNs
panos_security_policy:
ip_address: '10.5.172.91'
username: 'admin'
password: 'paloalto'
rule_name: 'HTTP Multimedia'
description: 'Allow HTTP multimedia only to host at 1.1.1.1'
from_zone: ['public']
to_zone: ['private']
source: ['any']
source_user: ['any']
destination: ['1.1.1.1']
category: ['content-delivery-networks']
application: ['http-video', 'http-audio']
service: ['service-http', 'service-https']
hip_profiles: ['any']
action: 'allow'
commit: false
- name: more complex fictitious rule that uses profiles
panos_security_policy:
ip_address: '10.5.172.91'
username: 'admin'
password: 'paloalto'
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'
commit: false
- name: deny all
panos_security_policy:
ip_address: '10.5.172.91'
username: 'admin'
password: 'paloalto'
rule_name: 'DenyAll'
log_start: true
log_end: true
action: 'deny'
rule_type: 'interzone'
commit: false
# permit ssh to 1.1.1.1 using panorama and pushing the configuration to firewalls
# that are defined in 'DeviceGroupA' device group
- name: permit ssh to 1.1.1.1 through Panorama
panos_security_policy:
ip_address: '10.5.172.92'
password: 'paloalto'
rule_name: 'SSH permit'
description: 'SSH rule test'
from_zone: ['public']
to_zone: ['private']
source: ['any']
source_user: ['any']
destination: ['1.1.1.1']
category: ['any']
application: ['ssh']
service: ['application-default']
hip_profiles: ['any']
action: 'allow'
devicegroup: 'DeviceGroupA'
Статус
Этот модуль помечен как устаревший и будет удален в версии 2.9. Для получения дополнительной информации см. УСТАРЕЛО.
Автор
- Иван Божер (@ivanbojer)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_policy_module.html