Управление доступом к КЕ
Раздел описывает функции контроля доступа к конфигурационным единицам, включающие получение перечня рабочих групп, назначение и корректировку разрешений, а также их отзыв с учетом расширенных настроек.
Общие функции
GetWorkGroups
Назначение: Получение доступных рабочих групп
Описание: Функция выполняет запрос к API [GET] /api/public/sm/v2/rsm/work-groups и возвращает список доступных рабочих групп.
Inputs
| Название | Тип | Описание |
|---|---|---|
| In, BearerToken | Общие параметры для функций |
Outputs
| Название | Тип | Описание |
|---|---|---|
| Ok, Failed, Response | Общие параметры для функций | |
| WorkGroups | Struct: Automaton.CMDB.WorkGroup (array) | Возвращает список моделей доступных рабочих групп |
Функции управления доступом
Для использования функций предоставления доступа к КЕ потребуется указать BearerToken пользователя, у которого:
- Есть доступ на редактирование КЕ, к которой нужно предоставить доступ
- Есть доступ к РГ, которой планируется предоставить доступ
GrantAccessToConfigItem
Назначение: Предоставление доступа к КЕ
Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/{id}/work-groups для предоставления доступа к КЕ рабочей группе.
Inputs
| Название | Тип | Описание |
|---|---|---|
| In, BearerToken | Общие параметры для функций | |
| ConfigItemId | Integer64 | Идентификатор обновляемой КЕ |
| WorkGroupGrant | Struct: Automaton.CMDB.WorkGroupGrantModel | Модель запроса |
Outputs
| Название | Тип | Описание |
|---|---|---|
| Ok, Failed, Response | Общие параметры для функций | |
| ConfigItem | Struct: Automaton.CMDB.ConfigItem | Модель обновленной КЕ |
GrantAccessToConfigItemExpanded
Назначение: Предоставление доступа к КЕ (Expanded)
Описание: Функция аналогична функции GrantAccessToConfigItem за исключением входящих в нее пинов.
Inputs
| Название | Тип | Описание |
|---|---|---|
| In, BearerToken | Общие параметры для функций | |
| ConfigItemId | Integer64 | Идентификатор обновляемой КЕ |
| WorkGroupId | Integer64 | Идентификатор рабочей группы, которой предоставляется доступ к КЕ |
| ShareType | String | Тип предоставляемых прав |
| Grants | String (array) | Предоставляемые рабочим группам права |
Тип предоставляемых прав
- ConfigItem - Предоставить права доступа только для КЕ
- Tree - Предоставить права доступа для КЕ и подчиненного ей дерева
- ChildrenTree - Предоставить права доступа только для подчиненного данной КЕ дерева
Уровень доступа
- read - Право на полное чтение КЕ
- write - Право на полное управление КЕ
Outputs
| Название | Тип | Описание |
|---|---|---|
| Ok, Failed, Response | Общие параметры для функций | |
| ConfigItem | Struct: Automaton.CMDB.ConfigItem | Модель обновленной КЕ |
UpdateAccessToConfigItem
Назначение: Обновление предоставленного доступа к КЕ
Описание: Функция выполняет запрос к API [PUT] /api/public/sm/v2/rsm/config-items/{id}/work-groups для обновления предоставленного доступа к КЕ.
Inputs
| Название | Тип | Описание |
|---|---|---|
| In, BearerToken | Общие параметры для функций | |
| ConfigItemId | Integer64 | Идентификатор обновляемой КЕ |
| SharedId | Integer64 | Идентификатор модели предоставления доступа к КЕ |
| WorkGroupGrant | Struct: Automaton.CMDB.WorkGroupGrantModel | Модель запроса |
Outputs
| Название | Тип | Описание |
|---|---|---|
| Ok, Failed, Response | Общие параметры для функций | |
| ConfigItem | Struct: Automaton.CMDB.ConfigItem | Модель обновленной КЕ |
UpdateAccessToConfigItemExpanded
Назначение: Обновление предоставленного доступа к КЕ (Expanded)
Описание: Функция аналогична функции UpdateAccessToConfigItem за исключением входящих в нее пинов.
Inputs
| Название | Тип | Описание |
|---|---|---|
| In, BearerToken | Общие параметры для функций | |
| ConfigItemId | Integer64 | Идентификатор обновляемой КЕ |
| SharedId | Integer64 | Идентификатор модели предоставления доступа к КЕ |
| WorkGroupId | Integer64 | Идентификатор рабочей группы, которой предоставляется доступ к КЕ |
| ShareType | String | Тип предоставляемых прав |
| Grants | String (array) | Предоставляемые рабочим группам права |
Outputs
| Название | Тип | Описание |
|---|---|---|
| Ok, Failed, Response | Общие параметры для функций | |
| ConfigItem | Struct: Automaton.CMDB.ConfigItem | Модель обновленной КЕ |
DeleteAccessToConfigItem
Назначение: Удаление предоставленного доступа к КЕ
Описание: Функция выполняет запрос к API [DELETE] /api/public/sm/v2/rsm/config-items/{id}/work-groups/{sharedId} для удаления предоставленного доступа к КЕ.
Inputs
| Название | Тип | Описание |
|---|---|---|
| In, BearerToken | Общие параметры для функций | |
| ConfigItemId | Integer64 | Идентификатор обновляемой КЕ |
| SharedId | Integer64 | Идентификатор модели предоставления доступа к КЕ |
Outputs
| Название | Тип | Описание |
|---|---|---|
| Ok, Failed, Response | Общие параметры для функций | |
| ConfigItem | Struct: Automaton.CMDB.ConfigItem | Модель обновленной КЕ |