Модуль check_point.mgmt.cp_mgmt_set_https_advanced_settings — настройка расширенных параметров проверки HTTPS.
Примечание
Этот модуль входит в коллекцию 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_set_https_advanced_settings.
Добавлено в check_point.mgmt 6.1.0
Краткое описание
- Настройка расширенных параметров проверки HTTPS.
- Все операции выполняются через API веб-служб.
- Доступно начиная с версии R82.
Параметры
Параметр | Комментарии |
|---|---|
auto_publish_session boolean | Публиковать текущий сеанс, если после завершения задачи были внесены изменения. Варианты:
|
blocked_certificate_tracking string | Определяет, следует ли регистрировать событие и отправлять уведомление об отброшенном трафике.<br><ul style=”list-style-type,square”><li>None — не регистрировать событие.</li><li>Log — записывать сведения о событии в SmartView.</li><li>Alert — записывать событие в журнал и выполнять команду.</li><li>Mail — отправлять электронное письмо администратору.</li><li>SNMP Trap — отправлять оповещение SNMP в SNMP GU.</li><li>User Defined Alert — отправлять настраиваемые оповещения.</li></ul>. Варианты:
|
blocked_certificates list / elements=dictionary | Список объектов сертификатов, идентифицируемых по серийному номеру.<br>Отбрасывать трафик от серверов, использующих заблокированный сертификат. |
|
cert_serial_number string |
Серийный номер сертификата (уникальный) в шестнадцатеричном формате HH,HH. |
|
comments string |
По умолчанию содержит описание сертификата; его можно заменить любым текстом. |
|
name string |
Содержит описание имени, которое нельзя заменить. |
bypass_on_client_failure boolean | Определяет, следует ли обходить или блокировать все запросы в случае ошибок клиента (клиент закрывает соединение из-за проблем с аутентификацией во время рукопожатия).<br><ul style=”list-style-type,square”><li>true — отказ с пропуском трафика (обходить все запросы).</li><li>false — отказ с блокировкой трафика (блокировать все запросы).</li></ul><br>Значение по умолчанию — true. Варианты:
|
bypass_on_failure boolean | Определяет, следует ли обходить или блокировать все запросы в случае ошибок сервера (например, ошибки проверки при аутентификации шлюза на сервере).<br><ul style=”list-style-type,square”><li>true — отказ с пропуском трафика (обходить все запросы).</li><li>false — отказ с блокировкой трафика (блокировать все запросы).</li></ul><br>Значение по умолчанию — true. Варианты:
|
bypass_under_load dictionary | Временно обходить проверку HTTPS для улучшения связи при высокой нагрузке на шлюз безопасности. Проверка HTTPS возобновится, как только нагрузка снизится. |
|
track string |
Определяет, следует ли регистрировать событие обхода при высокой нагрузке и отправлять уведомление.<ul style=”list-style-type,square”><li>None — не регистрировать событие.</li><li>Log — записывать сведения о событии. Просматривайте журналы в SmartConsole или SmartView.</li><li>Alert — записывать событие в журнал и выполнять настроенную команду.</li><li>Mail — отправлять электронное письмо администратору.</li><li>SNMP Trap — отправлять оповещение SNMP на настроенный сервер управления SNMP.</li><li>User Defined Alert — отправлять пользовательское оповещение.</li></ul>. Варианты:
|
bypass_update_services boolean | Установите значение “true”, чтобы обходить трафик к известным службам обновления программного обеспечения.<br>Значение по умолчанию — true. Варианты:
|
certificate_pinned_apps_action string | Установите значение “bypass”, чтобы обходить трафик от одобренных Check Point приложений с привязкой к сертификату.<br>Проверка HTTPS не может анализировать соединения, инициированные приложениями с привязкой к сертификату.<br>Установите значение “detect”, чтобы отправлять журналы для трафика от одобренных Check Point приложений с привязкой к сертификату.<br>Значение по умолчанию — bypass. Варианты:
|
details_level string | Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до полного представления объекта. Варианты:
|
domains_to_process list / elements=string | Указывает, в каких доменах выполнять команды. Нельзя использовать со значением details-level full. Команду необходимо запускать только из системного домена и с параметром ignore-warnings true. Допустимые значения: CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER. |
ignore_errors boolean | Применить изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты:
|
ignore_warnings boolean | Применить изменения, игнорируя предупреждения. Варианты:
|
log_sessions boolean | Значение “true” настраивает шлюз безопасности на отправку журналов сеансов проверки HTTPS.<br>Значение по умолчанию — true. Варианты:
|
retrieve_intermediate_ca_certificates boolean | Установите значение “true”, чтобы использовать расширение “Certificate Authority Information Access” для получения сертификатов, отсутствующих в цепочке сертификатов.<br>Значение по умолчанию — true. Варианты:
|
server_certificate_validation_actions dictionary | Если шлюз безопасности получает от веб-сервера недоверенный сертификат, определите, когда разрывать соединение и как регистрировать событие. |
|
block_expired boolean |
Установите значение true, чтобы отбрасывать трафик от серверов с просроченным сертификатом. Варианты:
|
|
block_revoked boolean |
Установите значение true, чтобы отбрасывать трафик от серверов с отозванным сертификатом (проверка CRL). Варианты:
|
|
block_untrusted boolean |
Установите значение true, чтобы отбрасывать трафик от серверов с недоверенным сертификатом. Варианты:
|
|
track_errors string |
Определяет, следует ли регистрировать ошибки проверки сервера и отправлять уведомление.<br><ul style=”list-style-type,square”><li>None — не регистрировать событие.</li><li>Log — записывать сведения о событии в SmartView.</li><li>Alert — записывать событие в журнал и выполнять команду.</li><li>Mail — отправлять электронное письмо администратору.</li><li>SNMP Trap — отправлять оповещение SNMP в SNMP GU.</li><li>User Defined Alert — отправлять настраиваемые оповещения.</li></ul>. Варианты:
|
site_categorization_allow_mode string | Определяет, следует ли разрешать или блокировать все запросы до завершения категоризации.<br><ul style=”list-style-type,square”><li>Background — разрешать запросы до завершения категоризации.</li><li>Hold — блокировать запросы до завершения категоризации.</li></ul><br>Значение по умолчанию — hold. Варианты:
|
version string | Версия Check Point. Если она не указана, используется последняя версия. |
wait_for_task boolean | Ожидать завершения задачи, например задачи публикации. Варианты:
|
wait_for_task_timeout integer | Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: |
Примеры
- name: set-https-advanced-settings
cp_mgmt_set_https_advanced_settings:
blocked_certificate_tracking: popup alert
bypass_on_client_failure: 'false'
bypass_on_failure: 'false'
bypass_under_load:
track: log
bypass_update_services: 'true'
certificate_pinned_apps_action: bypass
log_sessions: 'true'
retrieve_intermediate_ca_certificates: 'true'
server_certificate_validation_actions:
block_expired: 'true'
block_revoked: 'false'
block_untrusted: 'true'
track_errors: snmp trap alert
site_categorization_allow_mode: background
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
cp_mgmt_set_https_advanced_settings dictionary | Результат выполнения команды Check Point set-https-advanced-settings. Возвращается: всегда. |
Ссылки на коллекцию
© 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_set_https_advanced_settings_module.html