модуль check_point.mgmt.cp_mgmt_access_rules — управление объектами правил доступа Check Point через 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_access_rules.
Добавлено в check_point.mgmt 2.2.0
Краткое описание
- Управление объектами правил доступа на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
- Доступно начиная с версии R80 системы управления.
Примечание
Для этого модуля существует соответствующий плагин действий.
Параметры
Параметр | Комментарии |
|---|---|
auto_publish_session boolean | Опубликовать текущий сеанс после завершения задачи, если в него вносились изменения. Варианты:
|
details_level string | Уровень детализации некоторых полей в ответе: от отображения только значения UID объекта до его полного представления. Варианты:
|
layer string / обязательный | Слой, к которому относится правило; определяется по имени или UID. |
rules list / элементы=dictionary / обязательный | Список правил. |
|
action string |
«Accept», «Drop», «Ask», «Inform», «Reject», «User Auth», «Client Auth», «Apply Layer». |
|
action_settings dictionary |
Настройки действия. |
|
enable_identity_captive_portal boolean |
Н/Д Варианты:
|
|
limit string |
Н/Д |
|
comments string |
Строка комментария. |
|
content list / элементы=dictionary |
Список типов обрабатываемых файлов, к которым применяется это правило. |
|
content_direction string |
Направление, в котором применяется обработка типов файлов. Варианты:
|
|
content_negate boolean |
Значение True, если для данных задано отрицание. Варианты:
|
|
custom_fields dictionary |
Пользовательские поля. |
|
field_1 string |
Первое пользовательское поле. |
|
field_2 string |
Второе пользовательское поле. |
|
field_3 string |
Третье пользовательское поле. |
|
destination list / элементы=string |
Коллекция сетевых объектов, определяемых по имени или UID. |
|
destination_negate boolean |
Значение True, если для назначения задано отрицание. Варианты:
|
|
details_level string |
Уровень детализации некоторых полей в ответе: от отображения только значения UID объекта до его полного представления. Варианты:
|
|
enabled boolean |
Включить или отключить правило. Варианты:
|
|
ignore_errors boolean |
Применять изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты:
|
|
ignore_warnings boolean |
Применять изменения, игнорируя предупреждения. Варианты:
|
|
inline_layer string |
Встроенный слой, определяемый по имени или UID. Применяется только в том случае, если для «Action» задано значение «Apply Layer». |
|
install_on list / элементы=string |
Шлюзы, на которых следует установить политику; определяются по имени или UID. |
|
name string / обязательный |
Имя объекта. |
|
service list / элементы=string |
Коллекция сетевых объектов, определяемых по имени или UID. |
|
service_negate boolean |
Значение True, если для службы задано отрицание. Варианты:
|
|
source list / элементы=string |
Коллекция сетевых объектов, определяемых по имени или UID. |
|
source_negate boolean |
Значение True, если для источника задано отрицание. Варианты:
|
|
state string |
Состояние правила доступа (present или absent). По умолчанию — present. Варианты:
|
|
time list / элементы=string |
Список временных объектов. Например: «Weekend», «Off-Work», «Every-Day». |
|
track dictionary |
Настройки отслеживания. |
|
accounting boolean |
Включает или отключает учет для отслеживания. Варианты:
|
|
alert string |
Тип оповещения для отслеживания. Варианты:
|
|
enable_firewall_session boolean |
Определяет, следует ли создавать журнал сеансов только для подключений брандмауэра. Варианты:
|
|
per_connection boolean |
Определяет, следует ли вести журнал для каждого подключения. Варианты:
|
|
per_session boolean |
Определяет, следует ли вести журнал для каждого сеанса. Варианты:
|
|
type string |
«Log», «Extended Log», «Detailed Log», «None». |
|
user_check dictionary |
Настройки проверки пользователя. |
|
confirm string |
Н/Д Варианты:
|
|
custom_frequency dictionary |
Н/Д |
|
every integer |
Н/Д |
|
unit string |
Н/Д Варианты:
|
|
frequency string |
Н/Д Варианты:
|
|
interaction string |
Н/Д |
|
vpn string |
Any или All_GwToGw. Варианты:
|
|
vpn_list list / элементы=dictionary |
Сообщества или направленные условия. |
|
community list / элементы=string |
Список имен или UID сообществ. |
|
directional list / элементы=dictionary |
Условие направленного сопоставления сообществ. |
|
from string |
Имя или UID исходного сообщества. |
|
to string |
Имя или UID целевого сообщества. |
version string | Версия Check Point. Если она не указана, используется последняя версия. |
wait_for_task_timeout integer | Сколько минут ожидать до возникновения ошибки тайм-аута. По умолчанию: |
Примеры
- name: add-access-rules
cp_mgmt_access_rules:
rules:
- name: Rule 1
service:
- SMTP
- AOL
state: present
- name: Rule 2
service:
- SMTP
state: present
layer: Network
auto_publish_session: true
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
cp_mgmt_access_rules 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_access_rules_module.html