check_point.mgmt.cp_mgmt_service_udp – Управляет объектами service-udp на Check Point через API веб-служб
Примечание
Этот плагин входит в коллекцию check_point.mgmt (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install check_point.mgmt
Чтобы использовать его в плейбуке, укажите: check_point.mgmt.cp_mgmt_service_udp
Новый в версии 2.9: модуля check_point.mgmt
Обзор
- Управляет объектами service-udp на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| accept_replies boolean |
| Н/Д | |
| 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. | |
| match_for_any boolean |
| Указывает, используется ли эта служба, когда в качестве службы правила установлено «Любой», и существует несколько объектов службы с тем же исходным портом и протоколом. | |
| name string / обязательно | Имя объекта. | ||
| override_default_settings boolean |
| Указывает, является ли эта служба службой Data Domain, которая была переопределена. | |
| port string | Номер порта, используемого для предоставления этой службы. Чтобы указать диапазон портов, поместите дефис между наименьшим и наибольшим номерами портов, например, 44-55. | ||
| protocol string | Выберите тип протокола, связанный со службой, и, по умолчанию, сервер управления (если есть), который обеспечивает безопасность содержимого и аутентификацию для службы. Выбор типа протокола запускает конкретные обработчики протоколов для каждого типа протокола, что позволяет обеспечить более высокий уровень безопасности путем анализа протокола и более высокий уровень подключения путем отслеживания динамических действий (таких как открытие портов). | ||
| session_timeout integer | Время (в секундах) до истечения сессии. | ||
| source_port string | Номер порта для службы со стороны клиента. Если указан, будут приняты только те номера исходных портов, которые будут приняты, отклонены или отклонены во время проверки пакетов. В противном случае исходный порт не проверяется. | ||
| state string |
| Состояние правила доступа (present или absent). По умолчанию — present. | |
| sync_connections_on_cluster boolean |
| Включает синхронизацию состояния высокодоступности или балансировки нагрузки в кластере ClusterXL или сертифицированном OPSEC кластере. | |
| tags list / elements=string | Коллекция идентификаторов тегов. | ||
| use_default_session_timeout boolean |
| Использовать значение таймаута сессии по умолчанию. | |
| version string | Версия checkpoint. Если не указана, используется последняя версия. | ||
| wait_for_task boolean |
| Дождаться завершения задачи. Например, задачи публикации. | |
| wait_for_task_timeout integer | По умолчанию: 30 | Сколько минут ждать до выдачи ошибки таймаута. | |
Примеры
- name: add-service-udp
cp_mgmt_service_udp:
accept_replies: false
aggressive_aging:
enable: true
timeout: 360
use_default_timeout: false
keep_connections_open_after_policy_installation: false
match_for_any: true
name: New_UDP_Service_1
port: 5669
session_timeout: 0
state: present
sync_connections_on_cluster: true
- name: set-service-udp
cp_mgmt_service_udp:
accept_replies: true
aggressive_aging:
default_timeout: 3600
color: green
name: New_UDP_Service_1
port: 5656
state: present
- name: delete-service-udp
cp_mgmt_service_udp:
name: New_UDP_Service_2
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в этом разделе, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| cp_mgmt_service_udp dictionary | всегда, кроме случая удаления объекта. | Созданный или обновлённый объект Check Point. |
Авторы
- Or Soffer (@chkp-orso)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/check_point/mgmt/cp_mgmt_service_udp_module.html
