check_point.mgmt.cp_mgmt_threat_exception – Управляет объектами исключений угроз на Check Point через API веб-служб
Примечание
Этот плагин является частью коллекции check_point.mgmt (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install check_point.mgmt
Для использования в книге задач укажите: check_point.mgmt.cp_mgmt_threat_exception
Новое в версии 2.9: of check_point.mgmt
Обзор
- Управляет объектами исключений угроз на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| action строка | Действие — применённый профиль. | |
| auto_publish_session булево |
| Опубликовать текущую сессию, если после выполнения задачи были внесены изменения. |
| comments строка | Строка комментариев. | |
| destination список / элементы=строка | Коллекция объектов сети, определённых по имени или UID. | |
| destination_negate булево |
| Истина, если для назначения установлено отрицание. |
| details_level строка |
| Уровень детализации для некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полностью детализированного представления объекта. |
| enabled булево |
| Включить/отключить правило. |
| exception_group_name строка | Имя группы исключений. | |
| exception_group_uid строка | UID группы исключений. | |
| ignore_errors булево |
| Применить изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, то предупреждения также будут игнорироваться. |
| ignore_warnings булево |
| Применить изменения, игнорируя предупреждения. |
| install_on список / элементы=строка | Какие шлюзы, определённые по имени или UID, должны быть установлены для политики. | |
| layer строка | Слой, к которому относится правило, определённый по имени или UID. | |
| name строка / обязательный | Имя исключения. | |
| position строка | Позиция в базе правил. | |
| protected_scope список / элементы=строка | Коллекция объектов, определяющих защищённый объём, определённые по имени или UID. | |
| protected_scope_negate булево |
| Истина, если для защищённого объёма установлено отрицание. |
| protection_or_site список / элементы=строка | Имя защиты или сайта. | |
| rule_name строка | Имя родительского правила. | |
| service список / элементы=строка | Коллекция объектов сети, определённых по имени или UID. | |
| service_negate булево |
| Истина, если для службы установлено отрицание. |
| source список / элементы=строка | Коллекция объектов сети, определённых по имени или UID. | |
| source_negate булево |
| Истина, если для источника установлено отрицание. |
| state строка |
| Состояние правила доступа (present или absent). По умолчанию present. |
| track строка | Отслеживание пакетов. | |
| version строка | Версия checkpoint. Если не указана, используется последняя версия. | |
| wait_for_task булево |
| Ожидать завершения задачи. Например, задачи публикации. |
| wait_for_task_timeout целое число | По умолчанию: 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 словарь | всегда, кроме удаления объекта. | Созданный или обновлённый объект 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_exception_module.html
