Spec-Zone.ru › Ansible

Модуль 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

Н/Д

Возможные значения:

  • 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 / elements=string

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

ignore_errors

boolean

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

Возможные значения:

  • false
  • true

ignore_warnings

boolean

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

Возможные значения:

  • false
  • true

keep_connections_open_after_policy_installation

boolean

Сохранять подключения открытыми после установки политики, даже если новая политика их не разрешает. Этот параметр переопределяет настройки на странице «Сохранение подключений». Если изменить это свойство, изменение не повлияет на уже открытые подключения, а будет применяться только к будущим подключениям.

Возможные значения:

  • false
  • true

match_by_protocol_signature

boolean

Значение true включает сопоставление по сигнатуре выбранного протокола — сигнатура подтверждает подлинность протокола. Выберите этот параметр, чтобы ограничить порт указанным протоколом. Если выбранный протокол не поддерживает сопоставление по сигнатуре, для этого поля нельзя задать значение true.

Доступно начиная с версии управления R80.10.

Возможные значения:

  • false
  • true

match_for_any

boolean

Указывает, используется ли эта служба, когда для службы правила задано значение «Any» и существует несколько объектов служб с одинаковым исходным портом и протоколом.

Возможные значения:

  • false
  • true

name

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

Имя объекта.

override_default_settings

boolean

Указывает, является ли эта служба службой Data Domain с переопределёнными настройками.

Доступно начиная с версии управления R80.10.

Возможные значения:

  • false
  • true

port

string

Номер порта, используемого для предоставления этой службы. Чтобы указать диапазон портов, поставьте дефис между наименьшим и наибольшим номерами портов, например 44-55.

protocol

string

Выберите тип протокола, связанный со службой, и, как следствие, сервер управления (если он есть), обеспечивающий безопасность содержимого и аутентификацию для этой службы. Выбор типа протокола активирует соответствующие обработчики для каждого типа протокола, повышая уровень безопасности за счёт анализа протокола, а также уровень связности за счёт отслеживания динамических действий (например, открытия портов).

Доступно начиная с версии управления R80.10.

session_timeout

integer

Время (в секундах) до истечения срока действия сеанса.

source_port

string

Номер порта службы на стороне клиента. Если он указан, при проверке пакетов принимаются, отбрасываются или отклоняются только пакеты с указанными номерами исходных портов. В противном случае проверка исходного порта не выполняется.

state

string

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

Возможные значения:

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

sync_connections_on_cluster

boolean

Включает высокую доступность с синхронизацией состояния или распределение нагрузки в кластере ClusterXL либо кластере, сертифицированном OPSEC.

Возможные значения:

  • false
  • true

tags

list / elements=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-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.

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

Авторы

  • 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_tcp_module.html

Spec-Zone.ru

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