Актуальную версию документа см. на сайте Министерства цифрового развития, связи и массовых коммуникаций Российской Федерации по адресу https://digital.gov.ru/ru/documents/6186/.
"Методические рекомендации по использованию Единой системы идентификации и аутентификации. Версия 2.84" (приложение 17 к протоколу заседания Подкомиссии по использованию информационных технологий при предоставлении государственных и муниципальных...

Таблица 11 - Параметры ответа на запрос о вхождении сотрудников организации в группы

Таблица 11 - Параметры ответа на запрос о вхождении

сотрудников организации в группы

N

URI запрашиваемого ресурса

Описание ресурса

Предоставляемые данные

1.

/orgs/{orgOid}/grps

Перечень групп организации

Перечень групп, владельцем которых является данная организация (в виде перечня строк grp_id - указывающих на мнемонику имеющихся в рамках данной организации групп). Для получения этого перечня групп запрос должен быть добавлен header с маркером доступа на scope http://esia.gosuslugi.ru/org_ful

2.

/orgs/{orgOid}/grps/{grp_id}

Данные о группе организации с мнемоникой {grp-id}

Данные о группе:

<name> - имя;

<description> - описание;

<system> - сведения о том, является ли группа системной (в этом случае имеет значение "true") или нет ("false").

Также при запросе данных о конкретной группе возвращаются ссылки (links) на информационные системы, к которым относятся данные группы

3.

/orgs/{orgOid}/emps/{prn_oid}/grps

Перечень групп, членом которых является данный сотрудник

Перечень групп, членом которых является сотрудник с данным {prn_oid} (в виде перечня строк grp_id - указывающих на мнемонику имеющихся в рамках данной организации групп)

При запросе перечня групп, членом которых является данный сотрудник, отображается перечень ссылок в следующем формате:

/orgs/{orgOid}/emps/{prn_oid}/grps/{grp_id}/{it_sys_id}, где it_sys_id - мнемоника информационной системы, в рамках которой действует данная группа. Пример ссылки на группу:

http://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000224/emps/1000000105/grps/ORG_ADMIN/ESIA

Данная ссылка означает, что пользователь с идентификатором 1000000105 как сотрудник организации 1000000224 включен в группу администраторов профиля организации (ORG_ADMIN) системы ЕСИА (мнемоника ESIA). Выполнив запрос по данной ссылке, можно получить краткую информацию о группе, которая включает в себя:

- мнемонику группы (grp_id);

- название группы (name);

- описание группы (description);

- признак того, что группа является системной (system);

- мнемоника системы-владельца группы (itSystem).

Например:

{

"stateFacts": [

"Identifiable"

],

"grp_id": "ORG_ADMIN",

"name": "Администраторы профиля организации",

"description": "Сотрудники организации, имеющие право приглашать сотрудников, а также включать

сотрудников в группы доступа",

"system": "true",

"itSystem": "ESIA"

}

Если группа не является системной и не привязана ни к какой системе, то ссылка на нее имеет следующий формат:

/orgs/{orgOid}/emps/{prn_oid}/grps/{grp_id}

В кратких данных об этой группе атрибут "system" будет иметь значение "false".

При запросе перечня групп, членом которых является данный сотрудник, имеется возможность получить только те группы, которые относятся к определенной информационной системе. Для этого необходимо добавить условие на отбор групп выбранной системы (itSystemName), равное мнемонике данной системы. Пример запроса на получение групп системы ЕСИА (ESIA), в которые включен сотрудник:

GET /rs/orgs/1000000224/emps/1000000105/grps?itSystemName=ESIA HTTP/1.1\r\n

Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n

Host: esia-portal1.test.gosuslugi.ru\r\n

Accept: */*\r\n

\r\n

Б.6 Предоставление сведений о вхождении пользователя в группы Б.7 Управление данными организации