Spec-Zone.ru › Ansible 2.10

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
логическое
    Варианты:
  • no
  • yes ←
Зафиксировать конфигурацию, если она изменена.
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
логическое
    Варианты:
  • no
  • yes ←
Вести ли логирование в конце сессии.
log_start
логическое
    Варианты:
  • no ←
  • yes
Вести ли логирование в начале сессии.
operation
строка
    Варианты:
  • add ←
  • update
  • delete
  • find
Действие, которое нужно выполнить. Поддерживаемые значения: 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

Spec-Zone.ru

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