Spec-Zone.ru › Ansible

Модуль check_point.mgmt.cp_mgmt_resource_uri — управление объектами resource-uri в Checkpoint через API веб-служб

Примечание

Этот модуль входит в коллекцию 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_resource_uri.

Добавлено в check_point.mgmt 6.0.0

  • Краткое описание
  • Параметры
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управление объектами resource-uri на устройствах Checkpoint, включая создание, обновление и удаление объектов.
  • Все операции выполняются через API веб-служб.
  • Доступно начиная с версии управления R82.

Параметры

Параметр

Комментарии

action

dictionary

Параметры действия.

replacement_uri

string

Если в правиле, использующем этот ресурс, указано действие Drop или Reject, вместо URI, запрошенного пользователем, отображается URI-адрес для перенаправления.

strip_activex_tags

boolean

Удалять теги ActiveX.

Варианты:

  • false
  • true

strip_applet_tags

boolean

Удалять апплеты JAVA.

Варианты:

  • false
  • true

strip_ftp_links

boolean

Удалять FTP-ссылки.

Варианты:

  • false
  • true

strip_port_strings

boolean

Удалять номера портов.

Варианты:

  • false
  • true

strip_script_tags

boolean

Удалять скрипты JAVA.

Варианты:

  • false
  • true

auto_publish_session

boolean

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

Варианты:

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

color

string

Цвет объекта. Должен соответствовать одному из существующих цветов.

Варианты:

  • "aquamarine"
  • "black"
  • "blue"
  • "crete blue"
  • "burlywood"
  • "cyan"
  • "dark green"
  • "khaki"
  • "orchid"
  • "dark orange"
  • "dark sea green"
  • "pink"
  • "turquoise"
  • "dark blue"
  • "firebrick"
  • "brown"
  • "forest green"
  • "gold"
  • "dark gold"
  • "gray"
  • "dark gray"
  • "light green"
  • "lemon chiffon"
  • "coral"
  • "sea green"
  • "sky blue"
  • "magenta"
  • "purple"
  • "slate blue"
  • "violet red"
  • "navy blue"
  • "olive"
  • "orange"
  • "red"
  • "sienna"
  • "yellow"

comments

string

Текст комментария.

connection_methods

dictionary

Методы подключения.

proxy

boolean

Ресурс применяется, когда пользователь указывает Check Point Security Gateway в качестве прокси-сервера в браузере.

Варианты:

  • false
  • true

transparent

boolean

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

Варианты:

  • false
  • true

tunneling

boolean

Ресурс применяется, когда пользователь указывает Security Gateway в качестве прокси-сервера в браузере. Этот метод используется для подключений, при которых Security Gateway не может проверить содержимое пакетов, включая URL.

Варианты:

  • false
  • true

cvp

dictionary

Параметры CVP.

allowed_to_modify_content

boolean

Настраивает сервер CVP на проверку содержимого без возможности его изменения.

Варианты:

  • false
  • true

enable_cvp

boolean

Включить протокол Content Vectoring Protocol.

Варианты:

  • false
  • true

reply_order

string

Указывает, когда сервер CVP возвращает данные серверу безопасности Security Gateway.

Варианты:

  • "return_data_after_content_is_approved"
  • "return_data_before_content_is_approved"

send_http_headers_to_cvp

boolean

Выберите этот параметр, если сервер CVP должен проверять HTTP-заголовки пакетов сообщений.

Варианты:

  • false
  • true

send_http_request_to_cvp

boolean

Используется для защиты от нежелательного содержимого HTTP-запроса, например при проверке одноранговых подключений.

Варианты:

  • false
  • true

send_only_unsafe_file_types

boolean

Повышает производительность сервера CVP. При включении этого параметра на сервер CVP не отправляется трафик, который считается безопасным.

Варианты:

  • false
  • true

server

string

UID или имя сервера CVP. Убедитесь, что сервер CVP уже определен как приложение OPSEC.

details_level

string

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

Варианты:

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

exception_track

string

Настраивает отслеживание подключений, соответствующих этому правилу, но не прошедших проверки безопасности содержимого. Например, исключением может быть подключение с неподдерживаемой схемой или методом.

Варианты:

  • "none"
  • "exception log"
  • "exception alert"

ignore_errors

boolean

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

Варианты:

  • false
  • true

ignore_warnings

boolean

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

Варианты:

  • false
  • true

match_ufp

dictionary

Параметры Match-Ufp.

caching_control

string

Указывает, включено ли кэширование и каким образом.

Варианты:

  • "security_gateway_one_request"
  • "security_gateway_two_requests"
  • "no_caching"
  • "ufp_server"

ignore_ufp_server_after_failure

boolean

Сервер UFP будет игнорироваться после нескольких неудачных попыток подключения к нему.

Варианты:

  • false
  • true

number_of_failures_before_ignore

integer

Задает количество неудачных попыток, после которого сервер UFP следует игнорировать.

server

string

UID или имя сервера UFP — сертифицированного OPSEC стороннего приложения, которое проверяет URL по списку разрешенных категорий.

timeout_before_reconnecting

integer

Время, которое должно пройти перед следующей попыткой подключения к серверу UFP.

match_wildcards

dictionary

Параметры Match-Wildcards.

host

string

Функциональность параметра Host зависит от настроек DNS адресуемого сервера. В качестве хоста следует указывать только IP-адрес или полное DNS-имя.

methods

dictionary

Выберите URI-схемы, к которым применяется этот ресурс.

get

boolean

Метод GET.

Варианты:

  • false
  • true

head

boolean

Метод HEAD.

Варианты:

  • false
  • true

other

string

В поле Other можно указать другой метод. Можно использовать подстановочные знаки.

post

boolean

Метод POST.

Варианты:

  • false
  • true

put

boolean

Метод PUT.

Варианты:

  • false
  • true

path

string

Сопоставление имен выполняется путем добавления имени файла из запроса к текущему рабочему каталогу (если имя файла еще не является полным путем) и сравнения результата с путем, указанным в определении ресурса.

query

string

Параметры, передаваемые URI при обращении к нему.

schemes

dictionary

Выберите URI-схемы, к которым применяется этот ресурс.

ftp

boolean

Схема FTP.

Варианты:

  • false
  • true

gopher

boolean

Схема Gopher.

Варианты:

  • false
  • true

http

boolean

Схема HTTP.

Варианты:

  • false
  • true

mailto

boolean

Схема Mailto.

Варианты:

  • false
  • true

news

boolean

Схема News.

Варианты:

  • false
  • true

other

string

В поле Other можно указать другую схему. Можно использовать подстановочные знаки.

wais

boolean

Схема WAIS.

Варианты:

  • false
  • true

name

string / обязательный

Имя объекта.

soap

dictionary

Параметры SOAP.

file_id

string

Файл, содержащий запросы SOAP.

Варианты:

  • "scheme1"
  • "scheme2"
  • "scheme3"
  • "scheme4"
  • "scheme5"
  • "scheme6"
  • "scheme7"
  • "scheme8"
  • "scheme9"
  • "scheme10"

inspection

string

Разрешить все SOAP-запросы или только SOAP-запросы, указанные в следующем файле.

Варианты:

  • "allow_all_soap_requests"
  • "allow_soap_requests_as_specified_in_file"

track_connections

string

Метод отслеживания SOAP-подключений.

Варианты:

  • "none"
  • "log"
  • "popup_alert"
  • "mail_alert"
  • "snmp_trap_alert"
  • "user_defined_alert_no"
  • "user_defined_alert_no"
  • "user_defined_alert_no"

state

string

Состояние правила доступа (присутствует или отсутствует).

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tags

list / elements=string

Коллекция идентификаторов тегов.

uri_match_specification_type

string

Типом могут быть подстановочные шаблоны или UFP, где сервер UFP хранит категории запрещённых веб-сайтов.

Варианты:

  • "wildcards"
  • "ufp"

use_this_resource_to

string

Выберите назначение ресурса URI.

Варианты:

  • "enforce_uri_capabilities"
  • "optimize_url_logging"
  • "enhance_ufp_performance"

version

string

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

wait_for_task

boolean

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

Варианты:

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

wait_for_task_timeout

integer

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

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

Примеры

- name: add-resource-uri
  cp_mgmt_resource_uri:
    connection_methods:
      transparent: 'false'
      tunneling: 'true'
    match_wildcards:
      host: hostName
      path: pathName
    name: newUriResource
    state: present
    uri_match_specification_type: wildcards
    use_this_resource_to: optimize_url_logging

- name: set-resource-uri
  cp_mgmt_resource_uri:
    connection_methods:
      transparent: 'false'
      tunneling: 'true'
    match_wildcards:
      host: hostName
      path: pathName
    name: newUriResource
    state: present
    uri_match_specification_type: wildcards
    use_this_resource_to: optimize_url_logging

- name: delete-resource-uri
  cp_mgmt_resource_uri:
    name: newUriResource
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

cp_mgmt_resource_uri

dictionary

Созданный или обновлённый объект Check Point.

Возвращается: всегда, кроме случаев удаления объекта.

Авторы

  • 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_resource_uri_module.html

Spec-Zone.ru

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