Модуль 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 — для передачи двоичных символов) для кодирования данных письма. Варианты:
|
|
mail_capacity integer |
Ограничение размера (в КБ) вложений во входящих письмах. |
|
strip_activex_tags boolean |
Удалять теги ActiveX. Варианты:
|
|
strip_applet_tags boolean |
Удалять апплеты JAVA. Варианты:
|
|
strip_file_by_name string |
Удаляет из сообщения вложения с указанным именем. |
|
strip_ftp_links boolean |
Удалять FTP-ссылки. Варианты:
|
|
strip_mime_of_type string |
Указывает тип MIME, который нужно удалить из сообщения. |
|
strip_port_strings boolean |
Удалять порты. Варианты:
|
|
strip_script_tags boolean |
Удалять скрипты JAVA. Варианты:
|
auto_publish_session boolean | Опубликовать текущий сеанс, если после завершения задачи были внесены изменения. Варианты:
|
check_rulebase_with_new_destination boolean | База правил будет проверена повторно с новым разрешённым IP-адресом для доставки почты. Варианты:
|
color string | Цвет объекта. Должен быть одним из существующих цветов. Варианты:
|
comments string | Текст комментария. |
cvp dictionary | Настройка проверки сообщений электронной почты с помощью CVP. |
|
allowed_to_modify_content boolean |
Настраивает сервер CVP на проверку содержимого без возможности его изменения. Варианты:
|
|
enable_cvp boolean |
Установите флажок, чтобы включить Content Vectoring Protocol. Варианты:
|
|
reply_order string |
Определяет, когда сервер CVP возвращает данные серверу безопасности Security Gateway. Варианты:
|
|
server string |
UID или имя сервера CVP. Убедитесь, что сервер CVP уже определён как приложение OPSEC. |
deliver_messages_using_dns_mx_records boolean | Для определения IP-адреса назначения соединения используется разрешение MX-записи. Варианты:
|
details_level string | Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до его полного подробного представления. Варианты:
|
error_check_rulebase_with_new_destination boolean | База правил будет проверена повторно с новым разрешённым IP-адресом для доставки сообщений об ошибках. Варианты:
|
error_deliver_messages_using_dns_mx_records boolean | Для определения исходного IP-адреса соединения, используемого для отправки сообщения об ошибке, будет применяться разрешение MX-записи. Варианты:
|
error_mail_delivery_server string | Сообщение об ошибке отправляется, если сервер безопасности SMTP не может доставить письмо в течение времени ожидания, а параметр «Уведомлять отправителя об ошибке» включён. |
exception_track string | Определяет, регистрируется ли действие, указанное в категориях Action 2 и CVP, которое выполняется в результате определения ресурса. Варианты:
|
ignore_errors boolean | Применить изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты:
|
ignore_warnings boolean | Применить изменения, игнорируя предупреждения. Варианты:
|
mail_delivery_server string | Укажите сервер, на который перенаправляется почта. |
match dictionary | Задаёт свойства сопоставления для ресурса SMTP. |
|
recipient string |
Задаёт свойство сопоставления получателя для ресурса SMTP. |
|
sender string |
Задаёт свойство сопоставления отправителя для ресурса SMTP. |
name string / обязательный | Имя объекта. |
notify_sender_on_error boolean | Включить отправку сообщений об ошибках. Варианты:
|
state string | Состояние правила доступа (present или absent). Варианты:
|
tags list / элементы=string | Список идентификаторов тегов. |
version string | Версия Checkpoint. Если она не указана, используется последняя версия. |
wait_for_task boolean | Дождаться завершения задачи, например задачи публикации. Варианты:
|
wait_for_task_timeout integer | Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: |
Примеры
- 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. Возвращается: всегда, кроме случаев удаления объекта. |
Ссылки на коллекцию
© 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