check_point.mgmt.cp_mgmt_access_rule – Управляет объектами правил доступа на Check Point через API веб-служб
Примечание
Этот плагин входит в коллекцию check_point.mgmt (версия 1.0.6).
Для установки используйте: ansible-galaxy collection install check_point.mgmt.
Для использования в плейбуке укажите: check_point.mgmt.cp_mgmt_access_rule.
Введено в версии 2.9: of check_point.mgmt
Описание
- Управляет объектами правил доступа на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | ||
|---|---|---|---|---|
| action строка | «Принять», «Отклонить», «Запрос», «Информация», «Отказ», «Авторизация пользователя», «Авторизация клиента», «Применить слой». | |||
| action_settings словарь | Настройки действия. | |||
| enable_identity_captive_portal логическое значение |
| Н/Д | ||
| limit строка | Н/Д | |||
| auto_publish_session логическое значение |
| Опубликовать текущую сессию, если после завершения задачи были внесены изменения. | ||
| comments строка | Строка комментариев. | |||
| content список / элементы=строка | Список обработанных типов файлов, на которые распространяется это правило. | |||
| content_direction строка |
| В каком направлении применяются обработка типов файлов. | ||
| content_negate логическое значение |
| Истина, если для данных установлено отрицание. | ||
| custom_fields словарь | Пользовательские поля. | |||
| field_1 строка | Первое пользовательское поле. | |||
| field_2 строка | Второе пользовательское поле. | |||
| field_3 строка | Третье пользовательское поле. | |||
| destination список / элементы=строка | Коллекция объектов сети, определенных по имени или идентификатору. | |||
| destination_negate логическое значение |
| Истина, если для назначения установлено отрицание. | ||
| details_level строка |
| Уровень детализации для некоторых полей в ответе может варьироваться от отображения только значения идентификатора объекта до полностью детализированного представления объекта. | ||
| enabled логическое значение |
| Включить/выключить правило. | ||
| ignore_errors логическое значение |
| Применить изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен — предупреждения также будут проигнорированы. | ||
| ignore_warnings логическое значение |
| Применить изменения, игнорируя предупреждения. | ||
| inline_layer строка | Встроенный слой, определенный по имени или идентификатору. Актуально только если «Действие» было установлено как «Применить слой». | |||
| install_on список / элементы=строка | Какие шлюзы, определенные по имени или идентификатору, должны установить политику. | |||
| layer строка | Слой, к которому относится правило, определенный по имени или идентификатору. | |||
| name строка / обязательно | Имя объекта. | |||
| position строка | Позиция в базе правил. | |||
| service список / элементы=строка | Коллекция объектов сети, определенных по имени или идентификатору. | |||
| service_negate логическое значение |
| Истина, если для службы установлено отрицание. | ||
| source список / элементы=строка | Коллекция объектов сети, определенных по имени или идентификатору. | |||
| source_negate логическое значение |
| Истина, если для источника установлено отрицание. | ||
| state строка |
| Состояние правила доступа (наличие или отсутствие). По умолчанию — наличие. | ||
| time список / элементы=строка | Список объектов времени. Например, «Выходные», «Вне рабочего времени», «Каждый день». | |||
| track словарь | Настройки отслеживания. | |||
| accounting логическое значение |
| Включает/выключает учёт для отслеживания. | ||
| alert строка |
| Тип оповещения для отслеживания. | ||
| enable_firewall_session логическое значение |
| Определяет, нужно ли генерировать журнал сессий только для подключений через брандмауэр. | ||
| per_connection логическое значение |
| Определяет, нужно ли выполнять протоколирование по каждому подключению. | ||
| per_session логическое значение |
| Определяет, нужно ли выполнять протоколирование по каждой сессии. | ||
| type строка | «Журнал», «Расширенный журнал», «Подробный журнал», «Нет». | |||
| user_check словарь | Настройки проверки пользователя. | |||
| confirm строка |
| Н/Д | ||
| custom_frequency словарь | Н/Д | |||
| every целое число | Н/Д | |||
| unit строка |
| Н/Д | ||
| frequency строка |
| Н/Д | ||
| interaction строка | Н/Д | |||
| version строка | Версия checkpoint. Если не указана, используется последняя версия. | |||
| vpn список / элементы=строка | Сообщества или Направления. | |||
| community список / элементы=строка | Список имен сообществ или идентификаторов. | |||
| directional список / элементы=строка | Условия соответствия направлению сообществ. | |||
| from строка | Имя сообщества или идентификатор «от». | |||
| to строка | Имя сообщества или идентификатор «до». | |||
| wait_for_task логическое значение |
| Ожидать завершения задачи. Например, задачи публикации. | ||
Примеры
- name: add-access-rule
cp_mgmt_access_rule:
layer: Network
name: Rule 1
position: 1
service:
- SMTP
- AOL
state: present
- name: set-access-rule
cp_mgmt_access_rule:
action: Ask
action_settings:
enable_identity_captive_portal: true
limit: Upload_1Gbps
layer: Network
name: Rule 1
state: present
- name: delete-access-rule
cp_mgmt_access_rule:
layer: Network
name: Rule 2
state: absent
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| cp_mgmt_access_rule словарь | всегда, кроме удаления объекта. | Созданный или обновлённый объект checkpoint. |
Авторы
- Or Soffer (@chkp-orso)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/check_point/mgmt/cp_mgmt_access_rule_module.html
