Модуль check_point.mgmt.cp_mgmt_service_tcp — управление объектами service-tcp на 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_tcp.
Добавлено в check_point.mgmt 1.0.0
Краткое описание
- Управление объектами service-tcp на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
- Доступно начиная с версии управления R80.
Параметры
Параметр | Комментарии |
|---|---|
aggressive_aging dictionary | Задаёт короткие (агрессивные) тайм-ауты для неактивных подключений. |
|
default_timeout integer |
Тайм-аут агрессивного старения по умолчанию в секундах. |
|
enable boolean |
Н/Д Возможные значения:
|
|
timeout integer |
Тайм-аут агрессивного старения в секундах. |
|
use_default_timeout boolean |
Н/Д Возможные значения:
|
auto_publish_session boolean | Опубликовать текущий сеанс после завершения задачи, если в нём были внесены изменения. Возможные значения:
|
color string | Цвет объекта. Должен соответствовать одному из существующих цветов. Возможные значения:
|
comments string | Строка комментария. |
details_level string | Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного представления объекта. Возможные значения:
|
groups list / elements=string | Список идентификаторов групп. |
ignore_errors boolean | Применять изменения, игнорируя ошибки. Такие изменения нельзя будет опубликовать. Если флаг ignore-warnings не задан, предупреждения также будут игнорироваться. Возможные значения:
|
ignore_warnings boolean | Применять изменения, игнорируя предупреждения. Возможные значения:
|
keep_connections_open_after_policy_installation boolean | Сохранять подключения открытыми после установки политики, даже если новая политика их не разрешает. Этот параметр переопределяет настройки на странице «Сохранение подключений». Если изменить это свойство, изменение не повлияет на уже открытые подключения, а будет применяться только к будущим подключениям. Возможные значения:
|
match_by_protocol_signature boolean | Значение true включает сопоставление по сигнатуре выбранного протокола — сигнатура подтверждает подлинность протокола. Выберите этот параметр, чтобы ограничить порт указанным протоколом. Если выбранный протокол не поддерживает сопоставление по сигнатуре, для этого поля нельзя задать значение true. Доступно начиная с версии управления R80.10. Возможные значения:
|
match_for_any boolean | Указывает, используется ли эта служба, когда для службы правила задано значение «Any» и существует несколько объектов служб с одинаковым исходным портом и протоколом. Возможные значения:
|
name string / обязательный | Имя объекта. |
override_default_settings boolean | Указывает, является ли эта служба службой Data Domain с переопределёнными настройками. Доступно начиная с версии управления R80.10. Возможные значения:
|
port string | Номер порта, используемого для предоставления этой службы. Чтобы указать диапазон портов, поставьте дефис между наименьшим и наибольшим номерами портов, например 44-55. |
protocol string | Выберите тип протокола, связанный со службой, и, как следствие, сервер управления (если он есть), обеспечивающий безопасность содержимого и аутентификацию для этой службы. Выбор типа протокола активирует соответствующие обработчики для каждого типа протокола, повышая уровень безопасности за счёт анализа протокола, а также уровень связности за счёт отслеживания динамических действий (например, открытия портов). Доступно начиная с версии управления R80.10. |
session_timeout integer | Время (в секундах) до истечения срока действия сеанса. |
source_port string | Номер порта службы на стороне клиента. Если он указан, при проверке пакетов принимаются, отбрасываются или отклоняются только пакеты с указанными номерами исходных портов. В противном случае проверка исходного порта не выполняется. |
state string | Состояние правила доступа (присутствует или отсутствует). Возможные значения:
|
sync_connections_on_cluster boolean | Включает высокую доступность с синхронизацией состояния или распределение нагрузки в кластере ClusterXL либо кластере, сертифицированном OPSEC. Возможные значения:
|
tags list / elements=string | Список идентификаторов тегов. |
use_default_session_timeout boolean | Использовать тайм-аут виртуального сеанса по умолчанию. Доступно начиная с версии управления R80.10. Возможные значения:
|
version string | Версия Check Point. Если она не указана, используется последняя версия. |
wait_for_task boolean | Ожидать завершения задачи, например задачи публикации. Возможные значения:
|
wait_for_task_timeout integer | Время ожидания в минутах до возникновения ошибки тайм-аута. По умолчанию: |
Примеры
- name: add-service-tcp
cp_mgmt_service_tcp:
aggressive_aging:
enable: true
timeout: 360
use_default_timeout: false
keep_connections_open_after_policy_installation: false
match_for_any: true
name: New_TCP_Service_1
port: 5669
session_timeout: 0
state: present
sync_connections_on_cluster: true
- name: set-service-tcp
cp_mgmt_service_tcp:
aggressive_aging:
default_timeout: 3600
color: green
name: New_TCP_Service_1
port: 5656
state: present
- name: delete-service-tcp
cp_mgmt_service_tcp:
name: New_TCP_Service_1
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
cp_mgmt_service_tcp 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_service_tcp_module.html