Модуль check_point.mgmt.cp_mgmt_service_other — управление объектами service-other в 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_service_other.

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

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

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

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

Параметры

Параметр	Комментарии
accept_replies boolean	Указывает, следует ли принимать ответы службы Other Service. Варианты: `false` `true`
action string	Содержит выражение INSPECT, определяющее действие при совпадении правила, содержащего эту службу. Например, set r_mhandler &open_ssl_handler задаёт обработчик соединения. Доступно начиная с версии управления R80.10.
aggressive_aging dictionary	Задаёт короткие (агрессивные) тайм-ауты для неактивных соединений.
default_timeout integer	Тайм-аут агрессивного старения по умолчанию, в секундах.
enable boolean	Н/Д Варианты: `false` `true`
timeout integer	Тайм-аут агрессивного старения, в секундах.
use_default_timeout boolean	Н/Д Варианты: `false` `true`
auto_publish_session boolean	Опубликовать текущий сеанс после завершения задачи, если были внесены изменения. Варианты: `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	Текст комментария.
details_level string	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного описания объекта. Варианты: `"uid"` `"standard"` `"full"`
groups list / элементы=string	Коллекция идентификаторов групп.
ignore_errors boolean	Применить изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты: `false` `true`
ignore_warnings boolean	Применить изменения, игнорируя предупреждения. Варианты: `false` `true`
ip_protocol integer	Номер протокола IP.
keep_connections_open_after_policy_installation boolean	Сохранять соединения открытыми после установки политики, даже если новая политика их не разрешает. Этот параметр переопределяет настройки на странице Connection Persistence. Изменение этого свойства не повлияет на открытые соединения, а будет применяться только к будущим соединениям. Варианты: `false` `true`
match string	Содержит выражение INSPECT, определяющее критерии сопоставления. Соединение проверяется на соответствие выражению при получении первого пакета. Например, tcp, dport = 21, direction = 0 соответствует входящим управляющим соединениям FTP. Доступно начиная с версии управления R80.10.
match_for_any boolean	Указывает, используется ли эта служба, когда в качестве службы правила задано значение «Any», а существует несколько объектов служб с одинаковыми исходным портом и протоколом. Варианты: `false` `true`
name string / обязательный	Имя объекта.
override_default_settings boolean	Указывает, является ли эта служба службой Data Domain, для которой переопределены настройки. Доступно начиная с версии управления R80.10. Варианты: `false` `true`
session_timeout integer	Время в секундах до истечения срока действия сеанса.
state string	Состояние правила доступа (присутствует или отсутствует). Варианты: `"present"` ← (по умолчанию) `"absent"`
sync_connections_on_cluster boolean	Включает отказоустойчивость с синхронизацией состояния или распределение нагрузки в кластере ClusterXL или кластере, сертифицированном OPSEC. Варианты: `false` `true`
tags list / элементы=string	Коллекция идентификаторов тегов.
use_default_session_timeout boolean	Использовать тайм-аут виртуального сеанса по умолчанию. Доступно начиная с версии управления R80.10. Варианты: `false` `true`
version string	Версия Check Point. Если она не указана, используется последняя версия.
wait_for_task boolean	Ожидать завершения задачи, например задачи публикации. Варианты: `false` `true` ← (по умолчанию)
wait_for_task_timeout integer	Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: `30`

Примеры

- name: add-service-other
  cp_mgmt_service_other:
    aggressive_aging:
      enable: true
      timeout: 360
      use_default_timeout: false
    ip_protocol: 51
    keep_connections_open_after_policy_installation: false
    match_for_any: true
    name: New_Service_1
    session_timeout: 0
    state: present
    sync_connections_on_cluster: true

- name: set-service-other
  cp_mgmt_service_other:
    aggressive_aging:
      default_timeout: 3600
    color: green
    name: New_Service_1
    state: present

- name: delete-service-other
  cp_mgmt_service_other:
    name: New_Service_2
    state: absent

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

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

Ключ	Описание
cp_mgmt_service_other dictionary	Созданный или обновлённый объект Check Point. Возвращается: всегда, кроме случаев удаления объекта.

Авторы

Or Soffer (@chkp-orso)

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

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