Spec-Zone.ru › Ansible

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

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

Варианты:

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

details_level

string

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

Варианты:

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

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

Н/Д

Варианты:

  • false
  • true

limit

string

Н/Д

comments

string

Строка комментария.

content

list / элементы=dictionary

Список типов обрабатываемых файлов, к которым применяется это правило.

content_direction

string

Направление, в котором применяется обработка типов файлов.

Варианты:

  • "any"
  • "up"
  • "down"

content_negate

boolean

Значение True, если для данных задано отрицание.

Варианты:

  • false
  • true

custom_fields

dictionary

Пользовательские поля.

field_1

string

Первое пользовательское поле.

field_2

string

Второе пользовательское поле.

field_3

string

Третье пользовательское поле.

destination

list / элементы=string

Коллекция сетевых объектов, определяемых по имени или UID.

destination_negate

boolean

Значение True, если для назначения задано отрицание.

Варианты:

  • false
  • true

details_level

string

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

Варианты:

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

enabled

boolean

Включить или отключить правило.

Варианты:

  • false
  • true

ignore_errors

boolean

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

Варианты:

  • false
  • true

ignore_warnings

boolean

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

Варианты:

  • false
  • true

inline_layer

string

Встроенный слой, определяемый по имени или UID. Применяется только в том случае, если для «Action» задано значение «Apply Layer».

install_on

list / элементы=string

Шлюзы, на которых следует установить политику; определяются по имени или UID.

name

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

Имя объекта.

service

list / элементы=string

Коллекция сетевых объектов, определяемых по имени или UID.

service_negate

boolean

Значение True, если для службы задано отрицание.

Варианты:

  • false
  • true

source

list / элементы=string

Коллекция сетевых объектов, определяемых по имени или UID.

source_negate

boolean

Значение True, если для источника задано отрицание.

Варианты:

  • false
  • true

state

string

Состояние правила доступа (present или absent). По умолчанию — present.

Варианты:

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

time

list / элементы=string

Список временных объектов. Например: «Weekend», «Off-Work», «Every-Day».

track

dictionary

Настройки отслеживания.

accounting

boolean

Включает или отключает учет для отслеживания.

Варианты:

  • false
  • true

alert

string

Тип оповещения для отслеживания.

Варианты:

  • "none"
  • "alert"
  • "snmp"
  • "mail"
  • "user alert 1"
  • "user alert 2"
  • "user alert 3"

enable_firewall_session

boolean

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

Варианты:

  • false
  • true

per_connection

boolean

Определяет, следует ли вести журнал для каждого подключения.

Варианты:

  • false
  • true

per_session

boolean

Определяет, следует ли вести журнал для каждого сеанса.

Варианты:

  • false
  • true

type

string

«Log», «Extended Log», «Detailed Log», «None».

user_check

dictionary

Настройки проверки пользователя.

confirm

string

Н/Д

Варианты:

  • "per rule"
  • "per category"
  • "per application/site"
  • "per data type"

custom_frequency

dictionary

Н/Д

every

integer

Н/Д

unit

string

Н/Д

Варианты:

  • "hours"
  • "days"
  • "weeks"
  • "months"

frequency

string

Н/Д

Варианты:

  • "once a day"
  • "once a week"
  • "once a month"
  • "custom frequency..."

interaction

string

Н/Д

vpn

string

Any или All_GwToGw.

Варианты:

  • "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

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

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

Примеры

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

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

Авторы

  • Shiran Golzar (@chkp-shirango)

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

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

© 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

Spec-Zone.ru

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