community.network.panos_object – создание/чтение/обновление/удаление объекта в PAN-OS или Panorama

Примечание

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

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

Для использования в книге задач укажите: community.network.panos_object

УСТАРЕЛО
Описание
Требования
Параметры
Примечания
Примеры
Статус

УСТАРЕЛО

Удалено в: версии 2.0.0
Почему: Консолидация кодовой базы.
Альтернатива: Используйте https://galaxy.ansible.com/PaloAltoNetworks/paloaltonetworks вместо этого.

Описание

Объекты политик образуют критерии соответствия для правил политик и многих других функций в PAN-OS. Они могут включать объекты адресов, группы адресов, объекты сервисов, группы сервисов и теги.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

pan-python можно получить с PyPI https://pypi.org/project/pan-python/
pandevice можно получить с PyPI https://pypi.org/project/pandevice/

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
address строка		IP-адрес хоста или сети в нотации CIDR.
address_type строка	Варианты: ip-netmask ← ip-range fqdn	Тип определения объекта адреса. Допустимые типы — ip-netmask и ip-range.
addressgroup строка		Статическая группа объектов адресов или динамическая группа адресов.
addressobject строка		Имя объекта адреса.
api_key строка		Ключ API, который можно использовать вместо учетных данных username/password.
color строка	Варианты: красный зеленый синий желтый медный оранжевый фиолетовый серый светло-зеленый сине-зеленый светло-серый сине-серый лимонный черный золотой коричневый	- Цвет объекта тега. Допустимые значения — красный, зеленый, синий, желтый, медный, оранжевый, фиолетовый, серый, светло-зеленый, сине-зеленый, светло-серый, сине-серый, лимонный, черный, золотой и коричневый.
description строка		Описание объекта.
destination_port строка		Порт назначения, используемый при определении объекта сервиса.
devicegroup строка		- Имя группы устройств Panorama. Группа должна существовать в Panorama. Если группа устройств не определена, предполагается, что мы связываемся с файрволом.
dynamic_value строка		Критерии соответствия фильтра, используемые при определении динамической группы адресов.
ip_address строка / обязательно		IP-адрес (или имя хоста) устройства PAN-OS или консоли управления Panorama.
operation строка / обязательно	Варианты: add update delete find	Выполняемая операция. Поддерживаются значения add/delete/find.
password строка / обязательно		Учетные данные пароля для аутентификации.
protocol строка	Варианты: tcp udp	IP-протокол, используемый при определении объекта сервиса. Допустимые значения — tcp или udp.
servicegroup строка		Группа объектов сервиса.
serviceobject строка		Имя объекта сервиса.
services строка		Группа объектов сервиса, используемая при определении группы сервисов.
source_port строка		Порт источника, используемый при определении объекта сервиса.
static_value строка		Группа объектов адресов, используемая при определении группы адресов.
tag_name строка		Имя объекта или тега правила.
username строка	По умолчанию: "admin"	Учетные данные имени пользователя для аутентификации.

Примечания

Примечание

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

Примеры

- name: Search for shared address object
  community.network.panos_object:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    operation: 'find'
    address: 'DevNet'

- name: Create an address group in devicegroup using API key
  community.network.panos_object:
    ip_address: '{{ ip_address }}'
    api_key: '{{ api_key }}'
    operation: 'add'
    addressgroup: 'Prod_DB_Svrs'
    static_value: ['prod-db1', 'prod-db2', 'prod-db3']
    description: 'Production DMZ database servers'
    tag_name: 'DMZ'
    devicegroup: 'DMZ Firewalls'

- name: Create a global service for TCP 3306
  community.network.panos_object:
    ip_address: '{{ ip_address }}'
    api_key: '{{ api_key }}'
    operation: 'add'
    serviceobject: 'mysql-3306'
    destination_port: '3306'
    protocol: 'tcp'
    description: 'MySQL on tcp/3306'

- name: Create a global tag
  community.network.panos_object:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    operation: 'add'
    tag_name: 'ProjectX'
    color: 'yellow'
    description: 'Associated with Project X'

- name: Delete an address object from a devicegroup using API key
  community.network.panos_object:
    ip_address: '{{ ip_address }}'
    api_key: '{{ api_key }}'
    operation: 'delete'
    addressobject: 'Win2K test'

Статус

Этот модуль будет удален в версии 2.0.0. [устарел]
Дополнительную информацию см. в разделе УСТАРЕЛО.

Авторы

Bob 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_object_module.html