check_point.mgmt.cp_mgmt_threat_exception – Управляет объектами исключений угроз на Check Point через API веб-служб

Примечание

Этот плагин является частью коллекции check_point.mgmt (версия 1.0.6).

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

Чтобы использовать его в плейбуке, укажите: check_point.mgmt.cp_mgmt_threat_exception.

Введено в версии 2.9: of check_point.mgmt

Обзор
Параметры
Примеры
Возвращаемые значения

Обзор

Управляет объектами исключений угроз на устройствах Check Point, включая создание, обновление и удаление объектов.
Все операции выполняются через API веб-служб.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
action string		Действие — применённый профиль.
auto_publish_session boolean	Варианты: no yes	Опубликовать текущую сессию, если после выполнения задачи были внесены изменения.
comments string		Строка комментариев.
destination list / elements=string		Коллекция объектов сети, идентифицируемых по имени или идентификатору.
destination_negate boolean	Варианты: no yes	Истина, если для назначения установлено отрицание.
details_level string	Варианты: uid standard full	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного подробного представления объекта.
enabled boolean	Варианты: no yes	Включить/выключить правило.
exception_group_name string		Имя группы исключений.
exception_group_uid string		Идентификатор группы исключений.
ignore_errors boolean	Варианты: no yes	Применить изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, будут игнорироваться и предупреждения.
ignore_warnings boolean	Варианты: no yes	Применить изменения, игнорируя предупреждения.
install_on list / elements=string		Какие шлюзы, идентифицированные по имени или идентификатору, установить политику.
layer string		Слой, к которому относится правило, идентифицированный по имени или идентификатору.
name string / required		Имя исключения.
position string		Позиция в базе правил.
protected_scope list / elements=string		Коллекция объектов, определяющих защищённый охват, идентифицируемые по имени или идентификатору.
protected_scope_negate boolean	Варианты: no yes	Истина, если для защищённого охвата установлено отрицание.
protection_or_site list / elements=string		Имя защиты или сайта.
rule_name string		Имя родительского правила.
service list / elements=string		Коллекция объектов сети, идентифицируемых по имени или идентификатору.
service_negate boolean	Варианты: no yes	Истина, если для службы установлено отрицание.
source list / elements=string		Коллекция объектов сети, идентифицируемых по имени или идентификатору.
source_negate boolean	Варианты: no yes	Истина, если для источника установлено отрицание.
state string	Варианты: present ← absent	Состояние правила доступа (present или absent). По умолчанию present.
track string		Отслеживание пакетов.
version string		Версия checkpoint. Если не указана, используется последняя версия.
wait_for_task boolean	Варианты: no yes ←	Ожидать завершения задачи. Например, задачи публикации.

Примеры

- name: add-threat-exception
  cp_mgmt_threat_exception:
    layer: New Layer 1
    name: Exception Rule
    position: 1
    protected_scope: All_Internet
    rule_name: Threat Rule 1
    state: present
    track: Log

- name: set-threat-exception
  cp_mgmt_threat_exception:
    layer: New Layer 1
    name: Exception Rule
    rule_name: Threat Rule 1
    state: present

- name: delete-threat-exception
  cp_mgmt_threat_exception:
    name: Exception Rule
    layer: New Layer 1
    rule_name: Threat Rule 1
    state: absent

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
cp_mgmt_threat_exception dictionary	всегда, кроме удаления объекта.	Созданный или обновлённый объект checkpoint.

Авторы

Or Soffer (@chkp-orso)

© 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/check_point/mgmt/cp_mgmt_threat_exception_module.html