модуль check_point.mgmt.cp_mgmt_threat_exception — управление объектами исключений угроз в 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_exception.

Добавлено в 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	Истина, если для назначения задано отрицание. Варианты: `false` `true`
details_level string	Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до его полного подробного представления. Варианты: `"uid"` `"standard"` `"full"`
enabled boolean	Включить или отключить правило. Варианты: `false` `true`
exception_group_name string	Имя группы исключений.
exception_group_uid string	UID группы исключений.
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	Истина, если для защищаемой области задано отрицание. Варианты: `false` `true`
protection_or_site list / elements=string	Имя защиты или сайта.
rule_name string	Имя родительского правила.
service list / elements=string	Коллекция сетевых объектов, указанных по имени или UID.
service_negate boolean	Истина, если для службы задано отрицание. Варианты: `false` `true`
source list / elements=string	Коллекция сетевых объектов, указанных по имени или UID.
source_negate boolean	Истина, если для источника задано отрицание. Варианты: `false` `true`
state string	Состояние правила доступа (присутствует или отсутствует). Варианты: `"present"` ← (по умолчанию) `"absent"`
track string	Отслеживание пакетов.
version string	Версия Check Point. Если не указана, используется последняя версия.
wait_for_task boolean	Ожидать завершения задачи, например публикации. Варианты: `false` `true` ← (по умолчанию)
wait_for_task_timeout integer	Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: `30`

Примеры

- 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	Созданный или обновлённый объект 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_exception_module.html