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

Примечание

Этот плагин входит в коллекцию check_point.mgmt (версия 2.0.0).

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

Для использования в книге задач укажите: check_point.mgmt.cp_mgmt_threat_rule.

Новое в версии 2.9: модуля check_point.mgmt

Описание
Параметры
Примеры
Значения возврата

Описание

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

Параметры

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

Примеры

- name: add-threat-rule
  cp_mgmt_threat_rule:
    comments: ''
    install_on: Policy Targets
    layer: New Layer 1
    name: First threat rule
    position: 1
    protected_scope: All_Internet
    state: present
    track: None

- name: set-threat-rule
  cp_mgmt_threat_rule:
    action: New Profile 1
    comments: commnet for the first rule
    install_on: Policy Targets
    layer: New Layer 1
    name: Rule Name
    position: 1
    protected_scope: All_Internet
    state: present

- name: delete-threat-rule
  cp_mgmt_threat_rule:
    layer: New Layer 1
    name: Rule Name
    state: absent

Значения возврата

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

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

Авторы

Or Soffer (@chkp-orso)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/check_point/mgmt/cp_mgmt_threat_rule_module.html