Spec-Zone.ru › Ansible

Модуль check_point.mgmt.cp_mgmt_resource_smtp — управление объектами resource-smtp на Checkpoint через Web Services 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_resource_smtp.

Добавлено в check_point.mgmt 6.0.0

  • Краткое описание
  • Параметры
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управляет объектами resource-smtp на устройствах Checkpoint, включая создание, обновление и удаление объектов.
  • Все операции выполняются через Web Services API.
  • Доступно начиная с версии управления R82.

Параметры

Параметр

Комментарии

action_1

dictionary

Используйте правила переписывания для изменения заголовков Sender и Recipient в электронных письмах; также можно изменять другие заголовки писем с помощью поля пользовательского заголовка.

custom_field

dictionary

Имя заголовка.

field

string

Имя заголовка.

original

string

Исходное поле.

rewritten

string

Поле замены.

recipient

dictionary

Переписать заголовок Recipient.

original

string

Исходное поле.

rewritten

string

Поле замены.

sender

dictionary

Переписать заголовок Sender.

original

string

Исходное поле.

rewritten

string

Поле замены.

action_2

dictionary

Используйте это окно для настройки проверки почты для ресурса SMTP.

allowed_characters

string

Заголовки электронной почты MIME могут состоять из 8- или 7-битных символов (7 — ASCII, 8 — для передачи двоичных символов) для кодирования данных письма.

Варианты:

  • "8_bit"
  • "7_bit"

mail_capacity

integer

Ограничение размера (в КБ) вложений во входящих письмах.

strip_activex_tags

boolean

Удалять теги ActiveX.

Варианты:

  • false
  • true

strip_applet_tags

boolean

Удалять апплеты JAVA.

Варианты:

  • false
  • true

strip_file_by_name

string

Удаляет из сообщения вложения с указанным именем.

strip_ftp_links

boolean

Удалять FTP-ссылки.

Варианты:

  • false
  • true

strip_mime_of_type

string

Указывает тип MIME, который нужно удалить из сообщения.

strip_port_strings

boolean

Удалять порты.

Варианты:

  • false
  • true

strip_script_tags

boolean

Удалять скрипты JAVA.

Варианты:

  • false
  • true

auto_publish_session

boolean

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

Варианты:

  • false ← (по умолчанию)
  • true

check_rulebase_with_new_destination

boolean

База правил будет проверена повторно с новым разрешённым IP-адресом для доставки почты.

Варианты:

  • false
  • true

color

string

Цвет объекта. Должен быть одним из существующих цветов.

Варианты:

  • "aquamarine"
  • "black"
  • "blue"
  • "crete blue"
  • "burlywood"
  • "cyan"
  • "dark green"
  • "khaki"
  • "orchid"
  • "dark orange"
  • "dark sea green"
  • "pink"
  • "turquoise"
  • "dark blue"
  • "firebrick"
  • "brown"
  • "forest green"
  • "gold"
  • "dark gold"
  • "gray"
  • "dark gray"
  • "light green"
  • "lemon chiffon"
  • "coral"
  • "sea green"
  • "sky blue"
  • "magenta"
  • "purple"
  • "slate blue"
  • "violet red"
  • "navy blue"
  • "olive"
  • "orange"
  • "red"
  • "sienna"
  • "yellow"

comments

string

Текст комментария.

cvp

dictionary

Настройка проверки сообщений электронной почты с помощью CVP.

allowed_to_modify_content

boolean

Настраивает сервер CVP на проверку содержимого без возможности его изменения.

Варианты:

  • false
  • true

enable_cvp

boolean

Установите флажок, чтобы включить Content Vectoring Protocol.

Варианты:

  • false
  • true

reply_order

string

Определяет, когда сервер CVP возвращает данные серверу безопасности Security Gateway.

Варианты:

  • "return_data_after_content_is_approved"
  • "return_data_before_content_is_approved"

server

string

UID или имя сервера CVP. Убедитесь, что сервер CVP уже определён как приложение OPSEC.

deliver_messages_using_dns_mx_records

boolean

Для определения IP-адреса назначения соединения используется разрешение MX-записи.

Варианты:

  • false
  • true

details_level

string

Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до его полного подробного представления.

Варианты:

  • "uid"
  • "standard"
  • "full"

error_check_rulebase_with_new_destination

boolean

База правил будет проверена повторно с новым разрешённым IP-адресом для доставки сообщений об ошибках.

Варианты:

  • false
  • true

error_deliver_messages_using_dns_mx_records

boolean

Для определения исходного IP-адреса соединения, используемого для отправки сообщения об ошибке, будет применяться разрешение MX-записи.

Варианты:

  • false
  • true

error_mail_delivery_server

string

Сообщение об ошибке отправляется, если сервер безопасности SMTP не может доставить письмо в течение времени ожидания, а параметр «Уведомлять отправителя об ошибке» включён.

exception_track

string

Определяет, регистрируется ли действие, указанное в категориях Action 2 и CVP, которое выполняется в результате определения ресурса.

Варианты:

  • "none"
  • "exception log"
  • "exception alert"

ignore_errors

boolean

Применить изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться.

Варианты:

  • false
  • true

ignore_warnings

boolean

Применить изменения, игнорируя предупреждения.

Варианты:

  • false
  • true

mail_delivery_server

string

Укажите сервер, на который перенаправляется почта.

match

dictionary

Задаёт свойства сопоставления для ресурса SMTP.

recipient

string

Задаёт свойство сопоставления получателя для ресурса SMTP.

sender

string

Задаёт свойство сопоставления отправителя для ресурса SMTP.

name

string / обязательный

Имя объекта.

notify_sender_on_error

boolean

Включить отправку сообщений об ошибках.

Варианты:

  • false
  • true

state

string

Состояние правила доступа (present или absent).

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tags

list / элементы=string

Список идентификаторов тегов.

version

string

Версия Checkpoint. Если она не указана, используется последняя версия.

wait_for_task

boolean

Дождаться завершения задачи, например задачи публикации.

Варианты:

  • false
  • true ← (по умолчанию)

wait_for_task_timeout

integer

Количество минут ожидания до возникновения ошибки тайм-аута.

По умолчанию: 30

Примеры

- name: add-resource-smtp
  cp_mgmt_resource_smtp:
    deliver_messages_using_dns_mx_records: 'true'
    exception_track: exception log
    mail_delivery_server: deliverServer
    match:
      recipient: recipientName
      sender: senderName
    name: newSmtpResource
    state: present

- name: set-resource-smtp
  cp_mgmt_resource_smtp:
    mail_delivery_server: newServer
    name: newSmtpResource
    state: present

- name: delete-resource-smtp
  cp_mgmt_resource_smtp:
    name: newSmtpResource
    state: absent

Возвращаемые значения

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

Ключ

Описание

cp_mgmt_resource_smtp

dictionary

Созданный или обновлённый объект Checkpoint.

Возвращается: всегда, кроме случаев удаления объекта.

Авторы

  • Eden Brillant (@chkp-edenbr)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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_resource_smtp_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API