Spec-Zone.ru › Ansible 2.5

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API