Модуль check_point.mgmt.cp_mgmt_access_role — управление объектами ролей доступа 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_role.

Новое в check_point.mgmt 1.0.0

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

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

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

Параметры

Параметр	Комментарии
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	Строка комментария.
details_level string	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полностью подробного представления объекта. Варианты: `"uid"` `"standard"` `"full"`
ignore_errors boolean	Применять изменения, игнорируя ошибки. Такие изменения нельзя будет опубликовать. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты: `false` `true`
ignore_warnings boolean	Применять изменения, игнорируя предупреждения. Варианты: `false` `true`
machines string	Любые или все идентифицированные. Варианты: `"any"` `"all identified"`
machines_list list / elements=dictionary	Компьютеры, которым разрешен доступ к системе.
base_dn string	Если в качестве источника выбрана «Active Directory», используйте «base-dn», чтобы уточнить запрос к базе данных AD.
selection list / elements=string	Имя или UID объекта, выбранного из источника.
source string	Имя или UID Active Directory либо тег Identity Tag.
name string / обязательный	Имя объекта.
networks list / elements=string	Коллекция сетевых объектов, указанных по имени или UID, которым разрешен доступ к системе.
remote_access_clients string	Клиенты удаленного доступа, указанные по имени или UID.
state string	Состояние правила доступа (present или absent). Варианты: `"present"` ← (по умолчанию) `"absent"`
tags list / elements=string	Коллекция идентификаторов тегов.
users string	Любые или все идентифицированные. Варианты: `"any"` `"all identified"`
users_list list / elements=dictionary	Пользователи, которым разрешен доступ к системе.
base_dn string	Если в качестве источника выбрана «Active Directory», используйте «base-dn», чтобы уточнить запрос к базе данных AD.
selection list / elements=string	Имя или UID объекта, выбранного из источника.
source string	Имя или UID Active Directory, тег Identity Tag, внутренние группы пользователей, группы LDAP или гостевые пользователи.
version string	Версия Check Point. Если не указана, используется последняя версия.
wait_for_task boolean	Ожидать завершения задачи, например задачи публикации. Варианты: `false` `true` ← (по умолчанию)
wait_for_task_timeout integer	Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: `30`

Примеры

- name: add-access-role
  cp_mgmt_access_role:
    name: New Access Role 1
    networks: any
    remote_access_clients: any
    state: present
    users: any

- name: set-access-role
  cp_mgmt_access_role:
    users_list:
      - source: "Internal User Groups"
        selection: usersGroup
    name: New Access Role 1
    state: present

- name: delete-access-role
  cp_mgmt_access_role:
    name: New Access Role 1
    state: absent

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

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

Ключ	Описание
cp_mgmt_access_role dictionary	Созданный или обновленный объект Check Point. Возвращается: всегда, кроме случаев удаления объекта.

Авторы

Or Soffer (@chkp-orso)

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

© 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_role_module.html