panos_object - создание/чтение/обновление/удаление объекта в PAN-OS или Panorama
Новое в версии 2.4.
Описание
- Объекты политики образуют критерии сопоставления для правил политики и многих других функций в PAN-OS. Они могут включать объекты адресов, группы адресов, объекты служб, группы служб и метки.
Требования (к хосту, на котором выполняется модуль)
- pan-python можно получить с PyPi https://pypi.python.org/pypi/pan-python
- pandevice можно получить с PyPi https://pypi.python.org/pypi/pandevice
Параметры
| Параметр | Обязательно | По умолчанию | Варианты | Комментарии |
|---|---|---|---|---|
| адрес | нет | IP-адрес хоста или сети в нотации CIDR. | ||
| тип_адреса | нет | Тип определения объекта адреса. Допустимые типы: ip-netmask и ip-range. | ||
| группа_адресов | нет | Статическая группа объектов адресов или динамическая группа адресов. | ||
| объект_адреса | нет | Имя объекта адреса. | ||
| ключ_api | нет | Ключ API, который можно использовать вместо учетных данных имя_пользователя/пароль. | ||
| цвет | нет | - Цвет объекта метки. Допустимые значения: красный, зеленый, синий, желтый, медный, оранжевый, фиолетовый, серый, светло-зеленый, голубой, светло-серый, сине-серый, лайм, черный, золотой и коричневый. | ||
| описание | нет | Описание объекта. | ||
| порт_назначения | нет | Порт назначения, используемый в определении объекта службы. | ||
| группа_устройств | нет | None | - Имя группы устройств Panorama. Группа должна существовать в Panorama. Если группа устройств не определена, предполагается, что мы обращаемся к брандмауэру. | |
| динамическое_значение | нет | Критерии сопоставления фильтра, используемые в определении динамической группы адресов. | ||
| ip_адрес | да | IP-адрес (или имя хоста) устройства PAN-OS или консоли управления Panorama. | ||
| операция | да | Выполняемая операция. Поддерживаемые значения: добавить/удалить/найти. | ||
| пароль | да | Учетные данные пароля для аутентификации. | ||
| протокол | нет | IP-протокол, используемый в определении объекта службы. Допустимые значения: tcp или udp. | ||
| группа_служб | нет | Группа объектов служб. | ||
| объект_службы | нет | Имя объекта службы. | ||
| службы | нет | Группа объектов служб, используемых в определении группы служб. | ||
| порт_источника | нет | Порт источника, используемый в определении объекта службы. | ||
| статическое_значение | нет | Группа объектов адресов, используемых в определении группы адресов. | ||
| имя_метки | нет | Имя метки объекта или правила. | ||
| имя_пользователя | нет | admin | Учетные данные имени пользователя для аутентификации. |
Примеры
- name: search for shared address object
panos_object:
ip_address: '{{ ip_address }}'
username: '{{ username }}'
password: '{{ password }}'
operation: 'find'
address: 'DevNet'
- name: create an address group in devicegroup using API key
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
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
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
panos_object:
ip_address: '{{ ip_address }}'
api_key: '{{ api_key }}'
operation: 'delete'
addressobject: 'Win2K test'
Примечания
Примечание
- Режим проверки недоступен.
- Panorama поддерживается.
Статус
Этот модуль помечен как предварительная версия, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вас это заинтересует, пожалуйста, ознакомьтесь с Справочной информацией сообщества и сотрудничеством, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/panos_object_module.html