Spec-Zone.ru › Ansible 2.5

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

Spec-Zone.ru

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