Модуль check_point.mgmt.cp_mgmt_threat_indicator — управление объектами индикаторов угроз в 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_indicator.
Добавлено в check_point.mgmt 1.0.0
Краткое описание
- Управляет объектами индикаторов угроз на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
- Доступен начиная с версии системы управления R80.20.M1.
Параметры
Параметр | Комментарии |
|---|---|
action string | Действие индикатора. Варианты:
|
auto_publish_session boolean | Опубликовать текущий сеанс после завершения задачи, если в нем были внесены изменения. Варианты:
|
color string | Цвет объекта. Должен быть одним из существующих цветов. Варианты:
|
comments string | Строка комментария. |
details_level string | Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до полного представления объекта. Варианты:
|
ignore_errors boolean | Применять изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты:
|
ignore_warnings boolean | Применять изменения, игнорируя предупреждения. Варианты:
|
name string / обязательный | Имя объекта. |
observables list / элементы=dictionary | Наблюдаемые данные индикатора. |
|
comments string |
Строка комментария. |
|
confidence string |
Уровень уверенности индикатора в том, что обнаружена реальная угроза. Варианты:
|
|
domain string |
Имя домена. |
|
ignore_errors boolean |
Применять изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты:
|
|
ignore_warnings boolean |
Применять изменения, игнорируя предупреждения. Варианты:
|
|
ip_address string |
Допустимый IP-адрес. |
|
ip_address_first string |
Допустимый IP-адрес, начало диапазона. Если для этого параметра задано значение, необходимо также задать значение параметра ‘ip-address-last’. |
|
ip_address_last string |
Допустимый IP-адрес, конец диапазона. Если для этого параметра задано значение, необходимо также задать значение параметра ‘ip-address-first’. |
|
mail_cc string |
Допустимый адрес электронной почты, поле cc. |
|
mail_from string |
Допустимый адрес электронной почты, поле отправителя. |
|
mail_reply_to string |
Допустимый адрес электронной почты, поле reply-to. |
|
mail_subject string |
Тема электронного письма. |
|
mail_to string |
Допустимый адрес электронной почты, поле получателя. |
|
md5 string |
Допустимая последовательность MD5. |
|
name string |
Имя объекта. Должно быть уникальным в домене. |
|
product string |
Программный блейд, обрабатывающий наблюдаемые данные: AV — антивирус, AB — AntiBot. Варианты:
|
|
severity string |
Уровень серьезности угрозы. Варианты:
|
|
url string |
Допустимый URL. |
observables_raw_data string | Содержимое файла с наблюдаемыми данными индикатора. |
profile_overrides list / элементы=dictionary | Профили, в которых следует переопределить действие индикатора по умолчанию. |
|
action string |
Действие индикатора в этом профиле. Варианты:
|
|
profile string |
Профиль, в котором следует переопределить действие индикатора. |
state string | Состояние правила доступа (present или absent). Варианты:
|
tags list / элементы=string | Список идентификаторов тегов. |
version string | Версия Check Point. Если не указана, используется последняя версия. |
wait_for_task boolean | Ожидать завершения задачи, например задачи публикации. Варианты:
|
wait_for_task_timeout integer | Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: |
Примеры
- name: add-threat-indicator
cp_mgmt_threat_indicator:
action: ask
ignore_warnings: true
name: My_Indicator
observables:
- confidence: medium
mail_to: someone@somewhere.com
name: My_Observable
product: AV
severity: low
profile_overrides:
- action: detect
profile: My_Profile
state: present
- name: set-threat-indicator
cp_mgmt_threat_indicator:
action: prevent
ignore_warnings: true
name: My_Indicator
state: present
- name: delete-threat-indicator
cp_mgmt_threat_indicator:
name: My_Indicator
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
cp_mgmt_threat_indicator 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_indicator_module.html