check_point.mgmt.cp_mgmt_service_tcp – Управляет объектами service-tcp на Check Point через API веб-служб
Примечание
Этот плагин входит в коллекцию check_point.mgmt (версия 1.0.6).
Для его установки используйте: ansible-galaxy collection install check_point.mgmt.
Для использования в книге задач укажите: check_point.mgmt.cp_mgmt_service_tcp.
Новое в версии 2.9: check_point.mgmt
Описание
- Управляет объектами service-tcp на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| aggressive_aging словарь | Устанавливает короткие (агрессивные) таймауты для неактивных соединений. | ||
| default_timeout целое число | Таймаут агрессивного старения по умолчанию в секундах. | ||
| enable логическое значение |
| Н/Д | |
| timeout целое число | Таймаут агрессивного старения в секундах. | ||
| use_default_timeout логическое значение |
| Н/Д | |
| auto_publish_session логическое значение |
| Опубликовать текущую сессию, если изменения были внесены после завершения задачи. | |
| color строка |
| Цвет объекта. Должен быть одним из существующих цветов. | |
| comments строка | Строка комментариев. | ||
| details_level строка |
| Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного подробного представления объекта. | |
| groups список / элементы=строка | Коллекция идентификаторов групп. | ||
| ignore_errors логическое значение |
| Применить изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, предупреждения также будут проигнорированы. | |
| ignore_warnings логическое значение |
| Применить изменения, игнорируя предупреждения. | |
| keep_connections_open_after_policy_installation логическое значение |
| Удерживать соединения открытыми после установки политики, даже если они не разрешены новой политикой. Это переопределяет настройки на странице Сохранение подключений. Если вы измените этот параметр, изменение не повлияет на открытые подключения, а только на будущие подключения. | |
| match_by_protocol_signature логическое значение |
| Значение true включает сопоставление по подписи выбранного протокола — подпись идентифицирует протокол как подлинный. Выберите этот параметр, чтобы ограничить порт указанным протоколом. Если выбранный протокол не поддерживает сопоставление по подписи, это поле нельзя установить в значение true. | |
| match_for_any логическое значение |
| Указывает, используется ли эта служба, когда в качестве службы правила установлено «Любой», и есть несколько объектов служб с одинаковым исходным портом и протоколом. | |
| name строка / обязательно | Имя объекта. | ||
| override_default_settings логическое значение |
| Указывает, является ли эта служба службой Data Domain, которая была переопределена. | |
| port строка | Номер порта, используемого для предоставления этой службы. Чтобы указать диапазон портов, поместите дефис между наименьшим и наибольшим номерами портов, например 44-55. | ||
| protocol строка | Выберите тип протокола, связанный со службой, и, по умолчанию, управляющий сервер (если таковой имеется), который обеспечивает безопасность содержимого и аутентификацию для службы. Выбор типа протокола вызывает обработчики конкретного протокола для каждого типа протокола, тем самым обеспечивая более высокий уровень безопасности путем анализа протокола и более высокий уровень подключения путем отслеживания динамических действий (например, открытия портов). | ||
| session_timeout целое число | Время (в секундах) до истечения срока действия сессии. | ||
| source_port строка | Номер порта для клиентской службы. Если указан, только эти номера исходного порта будут приняты, отклонены или отвергнуты во время проверки пакетов. В противном случае исходный порт не проверяется. | ||
| state строка |
| Состояние правила доступа (present или absent). По умолчанию present. | |
| sync_connections_on_cluster логическое значение |
| Включает синхронизированное состояние высокодоступности или балансировки нагрузки в кластере ClusterXL или OPSEC-сертифицированном кластере. | |
| tags список / элементы=строка | Коллекция идентификаторов тегов. | ||
| use_default_session_timeout логическое значение |
| Использовать значение таймаута сессии по умолчанию. | |
| version строка | Версия checkpoint. Если не указана, используется последняя версия. | ||
| wait_for_task логическое значение |
| Подождать завершения задачи. Например, задачи публикации. | |
Примеры
- 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 словарь | всегда, кроме удаления объекта. | Созданный или обновлённый объект контрольной точки. |
Авторы
- Ор Соффер (@chkp-orso)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/check_point/mgmt/cp_mgmt_service_tcp_module.html
