Модуль check_point.mgmt.cp_mgmt_threat_rule — управление объектами правил защиты от угроз на Check Point через API веб-служб

Примечание

Этот модуль входит в коллекцию check_point.mgmt (версия 6.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

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

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

Добавлено в check_point.mgmt 1.0.0

Краткое описание
Параметры
Примеры
Возвращаемые значения

Краткое описание

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

Параметры

Параметр	Комментарии
action string	Действие — применяемый профиль.
auto_publish_session boolean	Опубликовать текущий сеанс, если после завершения задачи были внесены изменения. Варианты: `false` ← (по умолчанию) `true`
comments string	Строка комментария.
destination list / elements=string	Список сетевых объектов, указанных по имени или UID.
destination_negate boolean	Значение True, если для назначения задано отрицание. Варианты: `false` `true`
details_level string	Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до его полного подробного представления. Варианты: `"uid"` `"standard"` `"full"`
enabled boolean	Включить или отключить правило. Варианты: `false` `true`
ignore_errors boolean	Применить изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты: `false` `true`
ignore_warnings boolean	Применить изменения, игнорируя предупреждения. Варианты: `false` `true`
install_on list / elements=string	Шлюзы, указанные по имени или UID, на которых следует установить политику.
layer string	Слой, к которому относится правило, указанный по имени или UID.
name string / обязательный	Имя объекта.
position string	Позиция в базе правил. Использование значений “top” и “bottom” может нарушить идемпотентность.
protected_scope list / elements=string	Список объектов, определяющих защищаемую область, указанных по имени или UID.
protected_scope_negate boolean	Значение True, если для защищаемой области задано отрицание. Варианты: `false` `true`
service list / elements=string	Список сетевых объектов, указанных по имени или UID.
service_negate boolean	Значение True, если для службы задано отрицание. Варианты: `false` `true`
source list / elements=string	Список сетевых объектов, указанных по имени или UID.
source_negate boolean	Значение True, если для источника задано отрицание. Варианты: `false` `true`
state string	Состояние правила доступа (присутствует или отсутствует). Варианты: `"present"` ← (по умолчанию) `"absent"`
track string	Отслеживание пакетов.
track_settings dictionary	Параметры отслеживания правила защиты от угроз.
packet_capture boolean	Захват пакетов. Варианты: `false` `true`
version string	Версия Check Point. Если она не указана, используется последняя версия.
wait_for_task boolean	Дождаться завершения задачи, например задачи публикации. Варианты: `false` `true` ← (по умолчанию)
wait_for_task_timeout integer	Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: `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 dictionary	Созданный или обновлённый объект Check Point. Возвращается: всегда, кроме случаев удаления объекта.

Авторы

Or Soffer (@chkp-orso)

Ссылки на коллекцию

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