check_point.mgmt.cp_mgmt_service_udp – Управляет объектами service-udp на Check Point через API веб-служб
Примечание
Этот плагин входит в состав коллекции check_point.mgmt (версия 1.0.6).
Для его установки используйте: ansible-galaxy collection install check_point.mgmt.
Для использования в плейбуке укажите: check_point.mgmt.cp_mgmt_service_udp.
Новое в версии 2.9: of 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 |
| Ожидать завершения задачи. Например, задачи публикации. | |
Примеры
- 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 | всегда, за исключением удаления объекта. | Созданный или обновленный объект checkpoint. |
Авторы
- Or Soffer (@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_udp_module.html
