Модуль 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. Варианты:
|
|
strip_applet_tags boolean |
Удалять апплеты JAVA. Варианты:
|
|
strip_ftp_links boolean |
Удалять FTP-ссылки. Варианты:
|
|
strip_port_strings boolean |
Удалять номера портов. Варианты:
|
|
strip_script_tags boolean |
Удалять скрипты JAVA. Варианты:
|
auto_publish_session boolean | Опубликовать текущий сеанс, если после завершения задачи были внесены изменения. Варианты:
|
color string | Цвет объекта. Должен соответствовать одному из существующих цветов. Варианты:
|
comments string | Текст комментария. |
connection_methods dictionary | Методы подключения. |
|
proxy boolean |
Ресурс применяется, когда пользователь указывает Check Point Security Gateway в качестве прокси-сервера в браузере. Варианты:
|
|
transparent boolean |
Сервер безопасности невидим для клиента, инициирующего подключение, и для сервера. Прозрачный метод подключения является наиболее безопасным. Варианты:
|
|
tunneling boolean |
Ресурс применяется, когда пользователь указывает Security Gateway в качестве прокси-сервера в браузере. Этот метод используется для подключений, при которых Security Gateway не может проверить содержимое пакетов, включая URL. Варианты:
|
cvp dictionary | Параметры CVP. |
|
allowed_to_modify_content boolean |
Настраивает сервер CVP на проверку содержимого без возможности его изменения. Варианты:
|
|
enable_cvp boolean |
Включить протокол Content Vectoring Protocol. Варианты:
|
|
reply_order string |
Указывает, когда сервер CVP возвращает данные серверу безопасности Security Gateway. Варианты:
|
|
send_http_headers_to_cvp boolean |
Выберите этот параметр, если сервер CVP должен проверять HTTP-заголовки пакетов сообщений. Варианты:
|
|
send_http_request_to_cvp boolean |
Используется для защиты от нежелательного содержимого HTTP-запроса, например при проверке одноранговых подключений. Варианты:
|
|
send_only_unsafe_file_types boolean |
Повышает производительность сервера CVP. При включении этого параметра на сервер CVP не отправляется трафик, который считается безопасным. Варианты:
|
|
server string |
UID или имя сервера CVP. Убедитесь, что сервер CVP уже определен как приложение OPSEC. |
details_level string | Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до его полного подробного представления. Варианты:
|
exception_track string | Настраивает отслеживание подключений, соответствующих этому правилу, но не прошедших проверки безопасности содержимого. Например, исключением может быть подключение с неподдерживаемой схемой или методом. Варианты:
|
ignore_errors boolean | Применить изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты:
|
ignore_warnings boolean | Применить изменения, игнорируя предупреждения. Варианты:
|
match_ufp dictionary | Параметры Match-Ufp. |
|
caching_control string |
Указывает, включено ли кэширование и каким образом. Варианты:
|
|
ignore_ufp_server_after_failure boolean |
Сервер UFP будет игнорироваться после нескольких неудачных попыток подключения к нему. Варианты:
|
|
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. Варианты:
|
|
head boolean |
Метод HEAD. Варианты:
|
|
other string |
В поле Other можно указать другой метод. Можно использовать подстановочные знаки. |
|
post boolean |
Метод POST. Варианты:
|
|
put boolean |
Метод PUT. Варианты:
|
|
path string |
Сопоставление имен выполняется путем добавления имени файла из запроса к текущему рабочему каталогу (если имя файла еще не является полным путем) и сравнения результата с путем, указанным в определении ресурса. |
|
query string |
Параметры, передаваемые URI при обращении к нему. |
|
schemes dictionary |
Выберите URI-схемы, к которым применяется этот ресурс. |
|
ftp boolean |
Схема FTP. Варианты:
|
|
gopher boolean |
Схема Gopher. Варианты:
|
|
http boolean |
Схема HTTP. Варианты:
|
|
mailto boolean |
Схема Mailto. Варианты:
|
|
news boolean |
Схема News. Варианты:
|
|
other string |
В поле Other можно указать другую схему. Можно использовать подстановочные знаки. |
|
wais boolean |
Схема WAIS. Варианты:
|
name string / обязательный | Имя объекта. |
soap dictionary | Параметры SOAP. |
|
file_id string |
Файл, содержащий запросы SOAP. Варианты:
|
|
inspection string |
Разрешить все SOAP-запросы или только SOAP-запросы, указанные в следующем файле. Варианты:
|
|
track_connections string |
Метод отслеживания SOAP-подключений. Варианты:
|
state string | Состояние правила доступа (присутствует или отсутствует). Варианты:
|
tags list / elements=string | Коллекция идентификаторов тегов. |
uri_match_specification_type string | Типом могут быть подстановочные шаблоны или UFP, где сервер UFP хранит категории запрещённых веб-сайтов. Варианты:
|
use_this_resource_to string | Выберите назначение ресурса URI. Варианты:
|
version string | Версия Check Point. Если версия не указана, используется последняя. |
wait_for_task boolean | Дождаться завершения задачи, например публикации. Варианты:
|
wait_for_task_timeout integer | Сколько минут ждать до возникновения ошибки тайм-аута. По умолчанию: |
Примеры
- 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. Возвращается: всегда, кроме случаев удаления объекта. |
Ссылки на коллекцию
© 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