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

Примечание

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

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

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

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

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
activate_protections_by_extended_attributes список / элементы=строка			Активировать защиты по этим расширенным атрибутам.
	category строка		Имя категории тега IPS.
	name строка		Имя тега IPS.
active_protections_performance_impact строка		Варианты: высокий средний низкий очень_низкий	В профиле будут активированы только защиты с указанным уровнем влияния на производительность.
active_protections_severity строка		Варианты: Критический Высокий Средний или выше Низкий или выше	В профиле будут активированы только защиты с указанной степенью серьезности.
anti_bot логическое		Варианты: нет да	Активирован ли модуль Анти-бот.
anti_virus логическое		Варианты: нет да	Активирован ли модуль Антивирус.
auto_publish_session логическое		Варианты: нет да	Опубликовать текущую сессию, если после выполнения задачи были внесены изменения.
color строка		Варианты: аквамарин черный синий голубой Крит коричневато-золотистый голубовато-зеленый темно-зеленый хаки орхидея темно-оранжевый темно-морской зеленый розовый бирюзовый темно-синий кирпично-красный коричневый темно-зеленый лес золотой темно-золотой серый темно-серый светло-зеленый лимонно-кремовый коралловый морской зеленый небесно-голубой пурпурный фиолетовый серо-голубой фиолетово-красный темно-синий флот оливковый оранжевый красный сиена желтый	Цвет объекта. Должен быть одним из существующих цветов.
comments строка			Строка комментариев.
confidence_level_high строка		Варианты: Неактивный Запросить Предотвратить Обнаружить	Действие для защит с высоким уровнем уверенности.
confidence_level_low строка		Варианты: Неактивный Запросить Предотвратить Обнаружить	Действие для защит с низким уровнем уверенности.
confidence_level_medium строка		Варианты: Неактивный Запросить Предотвратить Обнаружить	Действие для защит со средним уровнем уверенности.
deactivate_protections_by_extended_attributes список / элементы=строка			Деактивировать защиты по этим расширенным атрибутам.
	category строка		Имя категории тега IPS.
	name строка		Имя тега IPS.
details_level строка		Варианты: uid стандартный полный	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного подробного представления объекта.
ignore_errors логическое		Варианты: нет да	Применять изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, то предупреждения также будут проигнорированы.
ignore_warnings логическое		Варианты: нет да	Применять изменения, игнорируя предупреждения.
indicator_overrides список / элементы=строка			Индикаторы, действие которых будет переопределено в этом профиле.
	action строка	Варианты: Неактивный Запросить Предотвратить Обнаружить	Действие индикатора в этом профиле.
	indicator строка		Индикатор, действие которого необходимо переопределить.
ips логическое		Варианты: нет да	Активирован ли модуль IPS.
ips_settings словарь			Настройки модуля IPS.
	exclude_protection_with_performance_impact логическое	Варианты: нет да	Исключать ли защиты в зависимости от уровня влияния на производительность.
	exclude_protection_with_performance_impact_mode строка	Варианты: очень низкий низкий или ниже средний или ниже высокий или ниже	Исключать защиты с этим уровнем влияния на производительность.
	exclude_protection_with_severity логическое	Варианты: нет да	Исключать ли защиты в зависимости от уровня серьезности.
	exclude_protection_with_severity_mode строка	Варианты: низкий или выше средний или выше высокий или выше критический	Исключать защиты с этим уровнем серьезности.
	newly_updated_protections строка	Варианты: активный неактивный этап подготовки	Активация недавно обновленных защит.
malicious_mail_policy_settings словарь			Политика обработки вредоносной почты для шлюзов MTA.
	add_customized_text_to_email_body логическое	Варианты: нет да	Добавить настраиваемый текст в тело вредоносного письма.
	add_email_subject_prefix логическое	Варианты: нет да	Добавить префикс к теме вредоносного письма.
	add_x_header_to_email логическое	Варианты: нет да	Добавить заголовок X-Header к вредоносному письму.
	email_action строка	Варианты: разрешить заблокировать	Заблокировать — заблокировать всё вредоносное письмо.<br>Разрешить — пропустить вредоносное письмо и применить изменения к письму (например, удалить вложения и ссылки, добавить заголовок x-header и т. д.).
	email_body_customized_text строка		Настраиваемый текст для тела вредоносного письма.<br> Доступные предопределённые поля,<br> $verdicts$ — вердикт по вредоносным/ошибочным вложениям/ссылкам.
	email_subject_prefix_text строка		Префикс для темы вредоносного письма.
	failed_to_scan_attachments_text строка		Заменить вложения, которые не удалось отсканировать, на этот текст.<br> Доступные предопределённые поля,<br> $filename$ — имя вредоносного файла.<br> $md5$ — MD5 вредоносного файла.
	malicious_attachments_text строка		Заменить вредоносные вложения на этот текст.<br> Доступные предопределённые поля,<br> $filename$ — имя вредоносного файла.<br> $md5$ — MD5 вредоносного файла.
	malicious_links_text строка		Заменить вредоносные ссылки на этот текст.<br> Доступные предопределённые поля,<br> $neutralized_url$ — нейтрализованная вредоносная ссылка.
	remove_attachments_and_links логическое	Варианты: нет да	Удалить вложения и ссылки из вредоносного письма.
	send_copy логическое	Варианты: нет да	Отправить копию вредоносного письма получателям.
	send_copy_list список / элементы=строка		Список получателей для отправки копии вредоносного письма.
name строка / обязательно			Имя объекта.
overrides список / элементы=строка			Переопределения настроек профиля для данной защиты.

	действие строка	Варианты: Облако угроз: Неактивно Обнаружение Предотвращение <br> Ядро: Отклонить Неактивно Принять	Действие защиты.
	capture_packets булево	Варианты: нет да	Захват пакетов.
	protection строка		Идентификатор защиты IPS по имени или UID.
	track строка	Варианты: нет журнал сигнализация почта snmp trap сигнализация пользователю сигнализация пользователю 1 сигнализация пользователю 2	Метод отслеживания защиты.
состояние строка		Варианты: присутствует ← отсутствует	Состояние правила доступа (присутствует или отсутствует). По умолчанию — присутствует.
метки список / элементы=строка			Коллекция идентификаторов меток.
эмуляция_угроз булево		Варианты: нет да	Включен ли модуль эмуляции угроз.
использовать_расширенные_атрибуты булево		Варианты: нет да	Включить/выключить защиту IPS в соответствии с расширенными атрибутами.
использовать_индикаторы булево		Варианты: нет да	Указывает, следует ли профилю использовать индикаторы.
версия строка			Версия Checkpoint. Если не указана, используется последняя версия.
подождать_завершения_задачи булево		Варианты: нет да ←	Подождать завершения задачи, например, задачи публикации.

Примеры

- name: add-threat-profile
  cp_mgmt_threat_profile:
    active_protections_performance_impact: low
    active_protections_severity: low or above
    anti_bot: true
    anti_virus: true
    confidence_level_high: prevent
    confidence_level_medium: prevent
    ips: true
    ips_settings:
      exclude_protection_with_performance_impact: true
      exclude_protection_with_performance_impact_mode: high or lower
      newly_updated_protections: staging
    name: New Profile 1
    state: present
    threat_emulation: true

- name: set-threat-profile
  cp_mgmt_threat_profile:
    active_protections_performance_impact: low
    active_protections_severity: low or above
    anti_bot: true
    anti_virus: false
    comments: update recommended profile
    confidence_level_high: prevent
    confidence_level_low: prevent
    confidence_level_medium: prevent
    ips: false
    ips_settings:
      exclude_protection_with_performance_impact: true
      exclude_protection_with_performance_impact_mode: high or lower
      newly_updated_protections: active
    name: New Profile 1
    state: present
    threat_emulation: true

- name: delete-threat-profile
  cp_mgmt_threat_profile:
    name: New Profile 1
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
cp_mgmt_threat_profile словарь	всегда, кроме удаления объекта.	Созданный или обновленный объект 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_profile_module.html