community.network.panos_match_rule – Тест на соответствие правила безопасности на устройствах PAN-OS или консоли управления Panorama.

Примечание

Этот плагин входит в коллекцию community.network (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.network.

Для использования в playbook, укажите: community.network.panos_match_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/

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API, который можно использовать вместо учетных данных username/password.
application строка		Приложение.
category строка		Категория URL
destination_ip строка		Адрес назначения IP.
destination_port строка		Порт назначения.
destination_zone строка		Зона назначения.
ip_address строка / обязательно		IP-адрес (или имя хоста) устройства PAN-OS, которое настраивается.
password строка / обязательно		Учетные данные пароля для использования для авторизации, если api_key не задан.
protocol строка		Номер IP-протокола от 1 до 255.
rule_type строка / обязательно	Варианты: security nat	Тип правила. Допустимые типы — security или nat.
source_ip строка / обязательно		Адрес источника IP.
source_port строка		Порт источника.
source_user строка		Пользователь или группа источника.
source_zone строка		Зона источника.
to_interface строка		Входящий интерфейс в правиле NAT.
username строка	Значение по умолчанию: "admin"	Учетные данные пользователя для использования для авторизации, если api_key не задан.
vsys_id строка / обязательно	Значение по умолчанию: "vsys1"	Идентификатор объекта VSYS.

Примечания

Примечание

Режим проверки (checkmode) не поддерживается.
Panorama НЕ поддерживается.

Примеры

- name: Check security rules for Google DNS
  community.network.panos_match_rule:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    rule_type: 'security'
    source_ip: '10.0.0.0'
    destination_ip: '8.8.8.8'
    application: 'dns'
    destination_port: '53'
    protocol: '17'
  register: result
- ansible.builtin.debug: msg='{{result.stdout_lines}}'

- name: Check security rules inbound SSH with user match
  community.network.panos_match_rule:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    rule_type: 'security'
    source_ip: '0.0.0.0'
    source_user: 'mydomain\jsmith'
    destination_ip: '192.168.100.115'
    destination_port: '22'
    protocol: '6'
  register: result
- ansible.builtin.debug: msg='{{result.stdout_lines}}'

- name: Check NAT rules for source NAT
  community.network.panos_match_rule:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    rule_type: 'nat'
    source_zone: 'Prod-DMZ'
    source_ip: '10.10.118.50'
    to_interface: 'ethernet1/2'
    destination_zone: 'Internet'
    destination_ip: '0.0.0.0'
    protocol: '6'
  register: result
- ansible.builtin.debug: msg='{{result.stdout_lines}}'

- name: Check NAT rules for inbound web
  community.network.panos_match_rule:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    rule_type: 'nat'
    source_zone: 'Internet'
    source_ip: '0.0.0.0'
    to_interface: 'ethernet1/1'
    destination_zone: 'Prod DMZ'
    destination_ip: '192.168.118.50'
    destination_port: '80'
    protocol: '6'
  register: result
- ansible.builtin.debug: msg='{{result.stdout_lines}}'

- name: Check security rules for outbound POP3 in vsys4
  community.network.panos_match_rule:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    vsys_id: 'vsys4'
    rule_type: 'security'
    source_ip: '10.0.0.0'
    destination_ip: '4.3.2.1'
    application: 'pop3'
    destination_port: '110'
    protocol: '6'
  register: result
- ansible.builtin.debug: msg='{{result.stdout_lines}}'

Статус

Этот модуль будет удален в версии 2.0.0. [устаревший]
Для получения дополнительной информации см. УСТАРЕВШИЙ.

Авторы

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_match_rule_module.html