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

Примечание

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

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

Чтобы использовать его в playbook, укажите: check_point.mgmt.cp_mgmt_threat_indicator

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

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
action строка		Варианты: Неактивный Запрос Предотвратить Обнаружить	Действие индикатора.
auto_publish_session булево		Варианты: нет да	Опубликовать текущую сессию, если изменения были внесены после завершения задачи.
color строка		Варианты: аквамарин черный синий кремовый синий коричневато-золотистый голубой темно-зеленый хаки фиолетовый темно-оранжевый темно-морской зеленый розовый бирюзовый темно-синий красно-коричневый коричневый темно-зеленый золотистый темно-золотистый серый темно-серый светло-зеленый лимонно-кремовый коралловый морской зеленый небесно-голубой пурпурный фиолетовый серо-голубой фиолетово-красный темно-синий оливковый оранжевый красный сиена желтый	Цвет объекта. Должен быть одним из существующих цветов.
comments строка			Строка комментариев.
details_level строка		Варианты: uid стандартный полный	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полностью детализированного представления объекта.
ignore_errors булево		Варианты: нет да	Применять изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings опущен, будут игнорироваться и предупреждения.
ignore_warnings булево		Варианты: нет да	Применять изменения, игнорируя предупреждения.
name строка / обязательно			Имя объекта.
observables список / элементы=строка			Наблюдаемые индикатора.
	comments строка		Строка комментариев.
	confidence строка	Варианты: низкий средний высокий критический	Уровень доверия к тому, что обнаружена реальная угроза.
	domain строка		Имя домена.
	ignore_errors булево	Варианты: нет да	Применять изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings опущен, будут игнорироваться и предупреждения.
	ignore_warnings булево	Варианты: нет да	Применять изменения, игнорируя предупреждения.
	ip_address строка		Действительный IP-адрес.
	ip_address_first строка		Действительный IP-адрес, начало диапазона. Если вы настраиваете этот параметр, вы также должны настроить значение параметра 'ip-address-last'.
	ip_address_last строка		Действительный IP-адрес, конец диапазона. Если вы настраиваете этот параметр, вы также должны настроить значение параметра 'ip-address-first'.
	mail_cc строка		Действительный адрес электронной почты, поле cc.
	mail_from строка		Действительный адрес электронной почты, поле отправителя.
	mail_reply_to строка		Действительный адрес электронной почты, поле reply-to.
	mail_subject строка		Тема сообщения электронной почты.
	mail_to строка		Действительный адрес электронной почты, поле получателя.
	md5 строка		Действительная последовательность MD5.
	name строка		Имя объекта. Должно быть уникальным в домене.
	product строка	Варианты: AV AB	Модуль программного обеспечения, обрабатывающий наблюдаемые значения, AV - Антивирус, AB - Антибот.
	severity строка	Варианты: низкий средний высокий критический	Уровень серьезности угрозы.
	url строка		Действительный URL.
observables_raw_data строка			Содержание файла, содержащего наблюдаемые индикатора.
profile_overrides список / элементы=строка			Профили, в которых нужно переопределить действие индикатора.
	action строка	Варианты: Неактивный Запрос Предотвратить Обнаружить	Действие индикатора в данном профиле.
	profile строка		Профиль, в котором нужно переопределить действие индикатора.
state строка		Варианты: присутствует ← отсутствует	Состояние правила доступа (присутствует или отсутствует). По умолчанию - присутствует.
tags список / элементы=строка			Коллекция идентификаторов тегов.
version строка			Версия checkpoint. Если не указана, используется последняя версия.
wait_for_task булево		Варианты: нет да ←	Ожидать завершения задачи. Например, задачи публикации.

Примеры

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