Spec-Zone.ru › Ansible

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

Публиковать текущий сеанс, если после завершения задачи были внесены изменения.

Варианты:

  • false ← (по умолчанию)
  • true

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>.

Варианты:

  • "none"
  • "log"
  • "popup alert"
  • "mail alert"
  • "snmp trap alert"
  • "user defined alert no.1"
  • "user defined alert no.2"
  • "user defined alert no.3"

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.

Варианты:

  • false
  • true

bypass_on_failure

boolean

Определяет, следует ли обходить или блокировать все запросы в случае ошибок сервера (например, ошибки проверки при аутентификации шлюза на сервере).<br><ul style=”list-style-type,square”><li>true — отказ с пропуском трафика (обходить все запросы).</li><li>false — отказ с блокировкой трафика (блокировать все запросы).</li></ul><br>Значение по умолчанию — true.

Варианты:

  • false
  • 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>.

Варианты:

  • "none"
  • "log"
  • "popup alert"
  • "mail alert"
  • "snmp trap alert"
  • "user defined alert no.1"
  • "user defined alert no.2"
  • "user defined alert no.3"

bypass_update_services

boolean

Установите значение “true”, чтобы обходить трафик к известным службам обновления программного обеспечения.<br>Значение по умолчанию — true.

Варианты:

  • false
  • true

certificate_pinned_apps_action

string

Установите значение “bypass”, чтобы обходить трафик от одобренных Check Point приложений с привязкой к сертификату.<br>Проверка HTTPS не может анализировать соединения, инициированные приложениями с привязкой к сертификату.<br>Установите значение “detect”, чтобы отправлять журналы для трафика от одобренных Check Point приложений с привязкой к сертификату.<br>Значение по умолчанию — bypass.

Варианты:

  • "bypass"
  • "detect"
  • "none"

details_level

string

Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до полного представления объекта.

Варианты:

  • "uid"
  • "standard"
  • "full"

domains_to_process

list / elements=string

Указывает, в каких доменах выполнять команды. Нельзя использовать со значением details-level full. Команду необходимо запускать только из системного домена и с параметром ignore-warnings true. Допустимые значения: CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER.

ignore_errors

boolean

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

Варианты:

  • false
  • true

ignore_warnings

boolean

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

Варианты:

  • false
  • true

log_sessions

boolean

Значение “true” настраивает шлюз безопасности на отправку журналов сеансов проверки HTTPS.<br>Значение по умолчанию — true.

Варианты:

  • false
  • true

retrieve_intermediate_ca_certificates

boolean

Установите значение “true”, чтобы использовать расширение “Certificate Authority Information Access” для получения сертификатов, отсутствующих в цепочке сертификатов.<br>Значение по умолчанию — true.

Варианты:

  • false
  • true

server_certificate_validation_actions

dictionary

Если шлюз безопасности получает от веб-сервера недоверенный сертификат, определите, когда разрывать соединение и как регистрировать событие.

block_expired

boolean

Установите значение true, чтобы отбрасывать трафик от серверов с просроченным сертификатом.

Варианты:

  • false
  • true

block_revoked

boolean

Установите значение true, чтобы отбрасывать трафик от серверов с отозванным сертификатом (проверка CRL).

Варианты:

  • false
  • true

block_untrusted

boolean

Установите значение true, чтобы отбрасывать трафик от серверов с недоверенным сертификатом.

Варианты:

  • false
  • 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>.

Варианты:

  • "none"
  • "log"
  • "popup alert"
  • "mail alert"
  • "snmp trap alert"
  • "user defined alert no.1"
  • "user defined alert no.2"
  • "user defined alert no.3"

site_categorization_allow_mode

string

Определяет, следует ли разрешать или блокировать все запросы до завершения категоризации.<br><ul style=”list-style-type,square”><li>Background — разрешать запросы до завершения категоризации.</li><li>Hold — блокировать запросы до завершения категоризации.</li></ul><br>Значение по умолчанию — hold.

Варианты:

  • "background"
  • "hold"

version

string

Версия Check Point. Если она не указана, используется последняя версия.

wait_for_task

boolean

Ожидать завершения задачи, например задачи публикации.

Варианты:

  • false
  • true ← (по умолчанию)

wait_for_task_timeout

integer

Количество минут ожидания до возникновения ошибки тайм-аута.

По умолчанию: 30

Примеры

- 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.

Возвращается: всегда.

Авторы

  • Eden Brillant (@chkp-edenbr)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

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