Модуль check_point.mgmt.cp_mgmt_threat_profile — управление объектами профилей угроз в 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_profile.
Добавлено в check_point.mgmt 1.0.0
Обзор
- Управляет объектами профилей угроз на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
- Доступно начиная с версии управления R80.
Параметры
Параметр | Комментарии |
|---|---|
activate_protections_by_extended_attributes list / elements=dictionary | Активировать защиты по этим расширенным атрибутам. |
|
category string |
Название категории тега IPS. |
|
name string |
Название тега IPS. |
active_protections_performance_impact string | В профиле будут активированы только защиты с таким влиянием на производительность. Варианты:
|
active_protections_severity string | В профиле будут активированы только защиты с таким уровнем серьезности. Варианты:
|
advanced_dns_settings dictionary | Расширенные настройки DNS. |
|
dga_detection string |
Включить/отключить обнаружение доменов на основе DGA. Варианты:
|
|
dns_domain_tunneling string |
Включить/отключить обнаружение туннелирования DNS на основе доменов. Варианты:
|
|
dns_over_https string |
Включить/отключить анализ протокола DNS over HTTPS. Варианты:
|
|
nxns_attack_detection string |
Включить/отключить обнаружение атак NXNS. Варианты:
|
anti_bot boolean | Активирован ли модуль Anti-Bot. Варианты:
|
anti_virus boolean | Активирован ли модуль Anti-Virus. Варианты:
|
auto_publish_session boolean | Опубликовать текущий сеанс, если после завершения задачи были внесены изменения. Варианты:
|
color string | Цвет объекта. Должен быть одним из существующих цветов. Варианты:
|
comments string | Строка комментариев. |
confidence_level_high string | Действие для защит с высоким уровнем достоверности. Варианты:
|
confidence_level_low string | Действие для защит с низким уровнем достоверности. Варианты:
|
confidence_level_medium string | Действие для защит со средним уровнем достоверности. Варианты:
|
deactivate_protections_by_extended_attributes list / elements=dictionary | Деактивировать защиты по этим расширенным атрибутам. |
|
category string |
Название категории тега IPS. |
|
name string |
Название тега IPS. |
details_level string | Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до полностью подробного представления объекта. Варианты:
|
ignore_errors boolean | Применить изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты:
|
ignore_warnings boolean | Применить изменения, игнорируя предупреждения. Варианты:
|
indicator_overrides list / elements=dictionary | Индикаторы, действие для которых будет переопределено в этом профиле. |
|
action string |
Действие индикатора в этом профиле. Варианты:
|
|
indicator string |
Индикатор, действие для которого необходимо переопределить. |
ips boolean | Активирован ли модуль IPS. Варианты:
|
ips_settings dictionary | Настройки модуля IPS. |
|
exclude_protection_with_performance_impact boolean |
Следует ли исключать защиты в зависимости от степени их влияния на производительность. Варианты:
|
|
exclude_protection_with_performance_impact_mode string |
Исключить защиты с таким уровнем влияния на производительность. Варианты:
|
|
exclude_protection_with_severity boolean |
Следует ли исключать защиты в зависимости от уровня их серьезности. Варианты:
|
|
exclude_protection_with_severity_mode string |
Исключить защиты с таким уровнем серьезности. Варианты:
|
|
newly_updated_protections string |
Активация недавно обновленных защит. Варианты:
|
malicious_mail_policy_settings dictionary | Политика обработки вредоносной почты для шлюзов MTA. Доступно начиная с версии управления R80.20.M1. |
|
add_customized_text_to_email_body boolean |
Добавить пользовательский текст в тело вредоносного электронного письма. Варианты:
|
|
add_email_subject_prefix boolean |
Добавить префикс к теме вредоносного электронного письма. Варианты:
|
|
add_x_header_to_email boolean |
Добавить заголовок X-Header в вредоносное электронное письмо. Варианты:
|
|
email_action string |
Block — заблокировать все вредоносное электронное письмо<br>Allow — пропустить вредоносное электронное письмо и применить к нему изменения (например, удалить вложения и ссылки, добавить заголовок x-header и т. д.). Варианты:
|
|
email_body_customized_text string |
Пользовательский текст для тела вредоносного электронного письма.<br> Доступные предопределенные поля:<br> $verdicts$ — вердикт для вредоносных вложений/ссылок или ошибок. |
|
email_subject_prefix_text string |
Префикс темы вредоносного электронного письма. |
|
failed_to_scan_attachments_text string |
Заменить вложения, которые не удалось проверить, этим текстом.<br> Доступные предопределенные поля:<br> $filename$ — имя вредоносного файла.<br> $md5$ — MD5-хеш вредоносного файла. |
|
malicious_attachments_text string |
Заменить вредоносные вложения этим текстом.<br> Доступные предопределенные поля:<br> $filename$ — имя вредоносного файла.<br> $md5$ — MD5-хеш вредоносного файла. |
|
malicious_links_text string |
Заменить вредоносные ссылки этим текстом.<br> Доступные предопределенные поля:<br> $neutralized_url$ — обезвреженная вредоносная ссылка. |
|
remove_attachments_and_links boolean |
Удалить вложения и ссылки из вредоносного электронного письма. Варианты:
|
|
send_copy boolean |
Отправить копию вредоносного электронного письма списку получателей. Варианты:
|
|
send_copy_list list / elements=string |
Список получателей копии вредоносного электронного письма. |
name string / обязательный | Имя объекта. |
overrides list / elements=dictionary | Переопределения этой защиты для каждого профиля. |
|
action string |
Действие защиты. Варианты:
|
|
capture_packets boolean |
Захватывать пакеты. Варианты:
|
|
protection string |
Защита IPS, указанная по имени или UID. |
|
track string |
Метод отслеживания для защиты. Варианты:
|
scan_malicious_links dictionary | Сканирует вредоносные ссылки (URL) в сообщениях электронной почты. |
|
max_bytes integer |
Сканировать ссылки в первых байтах тела письма. |
|
max_links integer |
Максимальное количество ссылок для сканирования в теле письма. |
state string | Состояние правила доступа (present или absent). Варианты:
|
tags list / elements=string | Коллекция идентификаторов тегов. |
threat_emulation boolean | Активирован ли модуль Threat Emulation. Варианты:
|
threat_extraction boolean | Активирован ли модуль Threat Extraction. Варианты:
|
use_extended_attributes boolean | Активировать или деактивировать защиты IPS в соответствии с расширенными атрибутами. Варианты:
|
use_indicators boolean | Указывает, следует ли профилю использовать индикаторы. Варианты:
|
version string | Версия Check Point. Если не указана, используется последняя версия. |
wait_for_task boolean | Ожидать завершения задачи, например задачи публикации. Варианты:
|
wait_for_task_timeout integer | Сколько минут ждать до возникновения ошибки тайм-аута. По умолчанию: |
zero_phishing boolean | Активирован ли модуль Zero Phishing. Варианты:
|
Примеры
- 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 dictionary | Созданный или обновлённый объект Check Point. Возвращается: всегда, кроме случаев удаления объекта. |
Ссылки на коллекцию
© 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_profile_module.html