ТАБЛИЦА ИЗМЕНЕНИЙ

Версия

Дата

Автор

Изменение

1.0

-

-

Документ создан

2.0

-

-

Создана новая версия документа в рамках развития ЕСИА в 2013 г.

2.1

-

-

Внесены исправления в документ:

- уточнено описание процедуры подписания запроса при аутентификации с помощью протокола SAML;

- уточнено описание перечня SAML-атрибутов;

- уточнено описание электронного сервиса по регистрации пользователей ЕСИА, опубликованного в СМЭВ (добавлено описание процедуры получения доступа к сервису, добавлены идентификаторы сервиса ЕСИА в СМЭВ, уточнено описание метода восстановления доступа);

- уточнено описание областей доступа (scope), используемых программными интерфейсами на основе REST.

2.2

-

-

Исключено приложение с описанием электронных сервисов ЕСИА для работы с должностными лицами ОГВ. Произведена перенумерация остальных приложений. Внесены уточнения и детализации в технические описания во всех приложениях

2.3

-

-

Детализация описания механизма аутентификации с использованием OpenID Connect 1.0

2.4

-

-

Добавлено описание программного интерфейса на основе REST по получению данных о филиалах и ОГВ.

Уточнено описание программного интерфейса на основе REST по получению данных о системных группах.

Изменено обозначение типов учетных записей.

Добавлены ссылки на Технологический портал ЕСИА.

Уточнено описание redirect_uri при использовании сервиса авторизации ЕСИА на основе OAuth 2.0.

Уточнено описание сервиса получения данных о субъекте (Приложение Б.7).

Уточнен формат адреса, используемый в REST-сервисе ЕСИА

2.4.1

-

-

Уточнен формат запроса на получение маркера доступа при реализации модели контроля доступа на основе полномочий системы-клиента.

Уточнен процесс завершения активной сессии пользователя при использовании протокола SAML

2.5

-

-

Добавлено описание:

- новых типов документов физических лиц, получаемых через REST API ЕСИА;

- данных о детях, получаемых через REST API ЕСИА;

- новых возможностей по использованию аутентификации с использованием OpenID Connect 1.0 (проверка аутентификации в фоновом режиме и открытие страницы аутентификации во всплывающем окне);

- возможностей по управлению данными организации;

- новых разрешений на доступ к данным (scope);

- возможности возврата пользователя в систему, направившую пользователя в ЕСИА для выполнения операций.

2.6

-

-

Добавлено описание сервиса "Единый сервис упрощенной идентификации пользователей Единой системы идентификации и аутентификации"

2.7

-

-

Добавлено описание использования разрешения (scope) для передачи сведений о детях.

2.8

-

-

Добавлено описание использования разрешения (scope) "openid" для интеграции информационных систем

2.9

-

-

Добавлено в Таблицу 11 "Состав набора данных" пункт - место рождения, при вызове скоупа id_doc и foreign_passport_doc

2.10

-

-

Из Таблицы 11 исключен пункт место рождения.

Добавлено описание сервиса УПРИД.

Уточнена информация по сервису регистрации.

Добавлен раздел Б.9 Предоставление списка измененных пользователей или организаций за период времени

В таблице 6 добавлены параметры ответа на запрос о персональных данных пользователя: verifying и status.

2.11

-

-

К Таблице 11 в примечании добавлено описание scope, позволяющих получить Гражданство пользователя.

2.12

-

-

Уточнено описание структуры маркера идентификации (Приложение В.7).

2.13

-

-

В Таблице 11 добавлен скоуп "birthplace".

2.14

-

-

В Таблице 10 исправлены коды ошибок.

2.15

-

-

В Таблице 11 добавлен скоуп usr_org.

2.16

-

-

Добавлено описание полей "district" и "settlement" для атрибута orgAddresses (Таблица 5).

2.17

17.01.2017

Пригарина Д.А.

В Таблице 10 добавлен новый код ошибки при отсутствии разрешения на доступ к указанному скоупу.

В таблице 6 добавлены параметры ответа на запрос о контактах пользователя: vrfValStu и verifyingValue.

2.18

31.01.2017

Пригарина Д.А.

Добавлен раздел с описанием метода импорта учетной записи пользователя (Приложение Б.9).

2.19

08.02.2017

Маслова Г.В.

В таблице 6 изменен параметр fiasCode ответа на запрос о сведениях об отдельной записи в перечне адресов физического лица.

2.20

09.03.2017

Пригарина Д.А.

Обновлен алгоритм импорта УЗ, пример ответа на запрос, обязательность полей адреса (Приложение Б.9).

2.21

10.04.2017

Пригарина Д.А.

Добавлено описание получения информации для скоупа usr_org (Приложение В.4).

В Приложении Б.9 добавлено описание заголовков запроса (Request-Data, Request-Data Sign). Обновлено описание параметров series и number для документа, удостоверяющего личность.

2.22

02.05.2017

Горбунова О.Е.

В Приложении В.4 в перечень скоупов добавлен скоуп usr_avt.

Добавлено описание получения информации для скоупа usr_avt (Приложение Б.9.2).

2.23

04.05.2017

Пригарина Д.А.

Добавлено описание ошибок для параметра errorStatusInfo (Приложение Б.9).

Обновлено описание ответа для запроса: https://esia-portal1.test.gosuslugi.ru/rs/orgs/100000/emps?embed=(elements.person) (Приложение Б.1).

2.24

20.06.2017

Маслова Г.В.

Обновлен пример запроса (вызов сервиса в среде разработки) в Приложении Б.11 (добавлен параметр "birthplace").

2.25

03.07.2017

Пригарина Д.А.

В разделе 3.1.1 добавлена информация о прекращении поддержки SAML 2.0 в ЕСИА.

В разделах Б.2, В.2.2, В.4, В.5 обновлены примеры, касающиеся скоупа id_doc.

В разделах В.6.2.2, В.6.2.3 обновлены примеры запросов.

2.26

18.07.2017

Маслова Г.В.

Добавлена Таблица 10 с кодами ошибок от сервиса импорта.

Для параметров запроса импорта актуализированы форматы данных и значение обязательности для отправки в запросе.

В Приложениях Б8, В 3.2, В4 удалена информация о скоупе sbj_inf.

Добавлено приложение Д4 по устаревшим скоупам ЕСИА.

2.27

17.08.2017

Пригарина Д.А.

Обновлена обязательность следующих полей запроса метода импорта (Б.9): birthplace, series, number, issuedBy.

2.28

29.08.2017

Пригарина Д.А.

В описании метода импорта (Б.9) добавлен новый тип документа - FRGN_PASS (заграничный паспорт гражданина РФ), обновлено описание параметров запроса для документа, удостоверяющего личность.

В Таблице 13 для параметра flowDetails в поле name добавлено новое значение - raRegistrationEndorsement (подтверждение регистрации пользователем по СМС).

2.29

08.11.2017

Пригарина Д.А.

Обновлена обязательность поля middleName запроса метода импорта (Б.9).

2.30

19.12.2017

Маслова Г.В.

Обновлена обязательность поля middleName запроса метода импорта (Б.9).

2.31

26.12.2017

Жукова Д.А.

Добавлены новые параметры в ответе на запрос при получении данных организации (rs/orgs, Б.4).

Добавлены новые параметры при ответе на запрос при получении списка организация пользователя (rs/prns/{prn_oid}/roles, В.4).

2.32

30.01.2018

Маслова Г.В.

Внесены уточнения в таблицу 10.

2.33

02.02.2018

Маслова Г.В.

Внесены изменения в раздел 3.5 "Возврат пользователя в систему, вызвавшую профиль пользователя в ЕСИА или регистрацию пользователя в ЕСИА".

2.34

09.02.2018

Маслова Г.В.

Исправлены опечатки.

2.35

01.03.2018

Цирихов А.М.

Внесены изменения в Приложение Б.9 Импорт учетной записи пользователя:

- в таблице с описанием параметров запроса: обязательность параметра документа issuedBy - наименование подразделения, выдавшего паспорт - указана как Y/N (обязателен только для паспорта гражданина РФ);

- в примере запроса импорта УЗ скорректировано содержимое элемента addresses;

- скорректированы примеры ответов на запрос импорта УЗ;

- Таблица 10 - Коды и описание ошибок от сервиса импорта: добавлены коды ESIA-030007, ESIA-032205, ESIA-039812, ESIA-039815, и их описания;

- Таблица 11 - Параметры ответа на запрос о статусе проверки данных пользователя: в описание добавлен параметр personOid - идентификатор зарегистрированной учетной записи;

- Таблица 11 - Параметры ответа на запрос о статусе проверки данных пользователя: в перечень возможных значений атрибута name параметра flowDetails добавлено значение "C" - операция отменена;

- Скорректирован основной и добавлены дополнительные примеры ответов на запрос о статусе выполнения заявки.

2.36

07.03.2018

Жукова Д.А.

Добавлен раздел "Удаленная идентификация с использованием биометрической идентификации" (Приложение В.8).

2.37

12.03.2018

Маслова Г.В.

Исправлены опечатки.

2.37

13.03.2018

Цирихов А.М.

Выполнены доработки и внесены изменения в Приложение Б.9 Импорт учетной записи пользователя:

- обновлена схема, представленная на рисунке 14 - Алгоритм импорта учетной записи в ЕСИА;

- скорректирована таблица с параметрами ответа на запрос импорта УЗ в ЕСИА:

- в примечаниях добавлено описание возможных значений возвращаемого параметра code (Код завершения операции);

- в примечаниях добавлено описание назначения возвращаемого параметра description (Текстовое описание кода завершения операции);

- в примечаниях добавлено описание назначения возвращаемого параметра message (Текстовое описание кода ошибки выполнения операции);

- Таблица 10 - Коды и описание ошибок от сервиса импорта:

- скорректировано содержимое столбца с описанием кодов возврата для некоторых кодов ошибок;

- добавлен код ошибки ESIA-910307 и его описание.

2.38

10.04.2018

Цирихов А.М.

Выполнены доработки и внесены изменения в Приложение Б.9 Импорт учетной записи пользователя:

- Таблица 11 - Параметры ответа на запрос о статусе проверки данных пользователя: перечень возможных значений атрибута name параметра flowDetails разделен на две возвращаемые группы:

- задачи и статусы их выполнения до момента завершения проверки СНИЛС;

- задачи и статусы их выполнения после успешного завершения проверки СНИЛС и создания упрощенной УЗ;

- скорректированы примеры ответов на запрос о статусе выполнения заявки - в соответствии с разделением статусов на две возвращаемые группы (до и после проверки СНИЛС).

2.39

28.04.2018

Маслова Г.В.

Внесены изменения в Приложение Б.1 Общие сведения о программном интерфейсе ЕСИА.

2.40

29.06.2018

Жукова Д.А.

Обновление описания информации о получении аватара пользователя (Приложение Б.9.2).

Дополнение раздела об удаленной идентификации с использованием биометрической идентификации примерами получаемых маркеров доступа (Приложение В.8) и общей схемой взаимодействия участников.

2.41

04.07.2018

Жукова Д.А.

Добавлено описание нового scope - "ext_auth_result" (Приложение В.4).

Обновлена информация о структуре маркера доступа, выдаваемого ЕСИА, в частности об алгоритме шифрования (Приложение В.5).

2.42

17.07.2018

Жукова Д.А.

Добавлены новые типы свидетельства о рождении и новый параметр (номер актовой записи) при получении информации о документах пользователя и о документах детей пользователя (Приложение Б.2).

2.43

30.07.2018

Жукова Д.А.

Добавлена информация о необходимости наличия подтвержденного мобильного телефона в профиле пользователя при изменении основных данных в стандартной и подтвержденной УЗ (п. 4.2.1).

2.44

26.09.2018

Жукова Д.А.

Обновлена информация о завершении удаленной идентификации пользователя (получение пользовательского маркера доступа) (Приложение В.8, п. 2).

Добавлен новый код ошибки в Таблицу 12 - ESIA-032110 (Приложение Б.9).

Добавлена информация о завершении сессии ЕСИА при закрытии браузера (п. 3.2.1, п. 3.3).

Добавлена информация о возможности обмена авторизационного кода на один маркер доступа (Приложения В.2.3 и В.6.3).

2.45

05.10.2018

Жукова Д.А.

Добавлена информация о настройке сроков жизни маркера доступа и маркера обновления (Приложение Б.1).

Добавлена информация о дополнительных возможных кодах ошибок при получении маркера доступа в обмен на маркер обновления (Приложение В.2.4).

2.45

22.10.2018

Цирихов А.М.

Приложение В.7 - в подраздел Сведения о структуре маркера идентификации: добавлено описание возможных типов субъекта ("urn:esia:sbj:typ").

Приложение В.8 - Удаленная идентификация с использованием биометрической идентификации: в подразделе "2. Завершение удаленной идентификации пользователя, получение пользовательского маркера доступа" скорректирован пример состава расширенного маркера доступа (PAYLOAD-часть)

2.46

26.11.2018

Маслова Г.В.

В Приложении Б.2 REST-API /prns/{oid}/ctts/{ctt_id} удалена информация о служебной электронной почте.

2.47

27.11.2018

Мезин Д.А.

В таблице 10 скорректировано описание кодов возврата для кодов ошибок:

- ESIA-032205;

- ESIA-039815.

2.48

06.12.2018

Маслова Г.В.

Добавлена информация о поддержке ГОСТ Р 34.10-2012.

2.49

18.12.2018

Мезин Д.А.

В таблице 10 скорректировано описание кода возврата для кода ошибки: ESIA-032205.

2.50

21.12.2018

Мезин Д.А.

В таблице 10 удалена информация о коде ошибки: ESIA-039815.

2.51

26.12.2018

Маслова Г.В.

В Приложении В.5 скорректированы сведения о структуре и проверке маркера доступа: добавлено описание информации о наличии делегирования полномочий.

2.51

26.12.2018

Мезин Д.А.

Добавлено описание областей доступа (scopes): gosbar и gosbar_org (Приложение В.4).

2.51

28.12.2018

Цирихов А.М.

1. В Приложении А.5 Описание метаданных поставщика услуг в таблице 5 расширено описание атрибута principalDocuments в части типов документа "Свидетельство о рождении".

2. В Приложения Б.2 и Б.4 (сервисы ЕСИА на базе подхода REST, предоставление персональных данных пользователей и предоставление данных из профиля организации) добавлено описание методов REST API ЕСИА для получения данных о транспортных средствах пользователей и организаций в соответствии с выполненными доработками (параметры пагинации, общее количество транспортных средств, полная информация о транспортном средстве).

2.52

11.01.2019

Жукова Д.А.

Обновлено описание метода импорта учетной записи пользователя:

1. Текущее описание перенесено в Приложение Д.5 как устаревшее. Добавлен новый код ошибки ESIA-039600;

2. Приложение Б.9 было обновлено: добавлена информация об адресе новой версии метода импорта, новых кодах ошибок (ESIA-039601, ESIA-039602, ESIA-039603, ESIA-039815), новой функции подтверждения упрощенных учетных записей. Обновлен алгоритм работы метода импорта.

2.53

18.01.2019

Маслова Г.В.

В таблице 18 в состав набора данных для scope "id_doc" и "foreign_passport_doc" добавлено значение "гражданство".

В разделе Б.9 добавлен код ошибки ESIA-035116.

2.54

30.01.2019

Мезин Д.А.

В разделе Б.9 добавлен код ошибки ESIA-039805, скорректировано описание кода возврата для кода ошибки ESIA-035116.

2.54

13.02.2019

Цирихов А.М.

Приложение В.7 - в подразделе "Сведения о структуре маркера идентификации" скорректировано описание возможных типов субъекта ("urn:esia:sbj:typ"): "P" - физическое лицо.

2.55

13.03.2019

Цирихов А.М.

Приложение В.8 "Удаленная идентификация с использованием биометрической идентификации" - добавлена ссылка на раздел документа "Методические рекомендации по работе с Единой биометрической системой", описывающий интеграцию внешних систем с Единой биометрической системой, в том числе содержащий указания по использованию защищенных сетей передачи данных при использовании методов REST API Биометрической верификации.

Исправлено описание формата параметра "17irthdate" (Таблица 6).

2.56

11.04.2019

Мезин Д.А.

В таблицу 10 добавлен код ошибки ESIA-039810

2.57

26.04.2019

Жукова Д.А.

Указание информации о scope "bio" в Приложениях В.4 и В.8

2.58

05.06.2019

Мезин Д.А.

В Приложение Г. Добавлен новый раздел Г.9.5 Рекомендации по взаимодействию с видами сведений в СМЭВ 3.X

2.59

11.06.2019

Цирихов А.М.

1. В документ добавлено Приложение Б.11 - Сервис управления внешними ИС центрами обслуживания организаций.

2. В подразделы 3.1.1 и 3.1.2 добавлена информация и ссылка на сертификаты тестовой и продуктивной сред ЕСИА, используемые для формирования электронных подписей ответов как поставщика.

2.60

16.07.2019

Мезин Д.А.

В пункте Б.11 скорректировано описание сервиса REST API.

2.61

07.08.2019

Мезин Д.А.

В Приложение Б. Обновлен формат fiasCode.

2.61

08.10.2019

Цирихов А.М.

1. Исключено указание на возможность использования ИС самоподписанных сертификатов электронных подписей.

2. Исключено указание на возможность использования сертификатов электронных подписей, выпущенных с использованием криптографических алгоритмов, отличных от ГОСТ Р 34.10-2012 и ГОСТ Р 34.11-2012 (кроме раздела 3.1.1 Аутентификация с использованием стандарта SAML и приложения А. Использование ЕСИА в целях идентификации и аутентификации посредством стандарта SAML 2.0).

2.62

23.10.2019

Мезин Д.А.

В приложении В.3.2 скорректировано описание получения маркера доступа.

2.63

02.12.2019

Мезин Д.А.

В приложении В.3.1.1 и В.3.1.2 скорректировано описание.

2.64

24.12.2019

Мезин Д.А.

В приложении Б.11.3 актуализирован пример ответа метода сервиса REST API получения списка ЦО организации.

2.65

26.12.2019

Мезин Д.А.

В приложение Б.11 Сервис управления внешними ИС центрами добавлено описание для поля opnModes.

2.66

26.02.2019

Мезин Д.А.

1) Добавлено новое приложение Б.10 Сервис подтверждения операций по регистрации УЗ через интеграционный модуль ЕПГУ;

2) В приложение Б.9 добавлен код ошибки ESIA-032010;

3) В разделы 3.2.2 и В.6.5 добавлена информация об обязательности вызова Logout.

2.67

26.03.2020

Петраков С.В.

В приложение Б.12.2 Сервис REST API безусловного добавления сотрудников в организацию в перечень возвращаемых ошибок добавлено описание ошибки ESIA-036102

2.68

14.04.2020

Мезин Д.А.

В приложении Б.4 Предоставление данных из профиля организации актуализированы коды типов ОГВ.

2.69

28.05.2020

Тихонова Е.Н.

1. В разделе Б.9 добавлен код ошибки ESIA-039803, скорректировано описание кода возврата для кода ошибки ESIA-032010;

2. В разделе Б.9 добавлено описание способа формирования подписи запроса (Request-Data-Sign) для метода импорта.

2.70

15.07.2020

Цирихов А.М.

В документ добавлено Приложение Б.13 - Сервис получения маркера доступа по идентификационному ключу

2.71

17.08.2020

Жукова Д.А.

В Таблицу 6 добавлен новый параметр <actDate> - дата актовой записи (только для свидетельства о рождении ребенка РФ) для свидетельства о рождении РФ ребенка.

2.72

21.08.2020

Мезин Д.А.

В приложении Б. - Сервисы ЕСИА на базе подхода REST скорректировано описание для метода "Сведения об отдельной записи в перечне документов физического лица"

2.73

08.09.2020

Маркелова М.Н.

1. В приложение Б.4 добавлено описание методов REST API ЕСИА для получения данных о категориях организации;

2. В Приложение В.4 в перечень скоупов добавлен скоуп categories.

2.74

17.09.2020

Тихонова Е.Н. Маркелова М.Н.

1. В приложение Б.2 добавлена информация о самозанятых и добавлено описание методов REST API ЕСИА для получения данных о категориях самозанятого;

2. В приложение В.4 в перечень скоупов добавлен скоуп self_employed.

3. В приложении Б. - Сервисы ЕСИА на базе подхода REST скорректировано описание для методов "Данные о пользователе с идентификатором prn-id" и "Сведения об отдельной записи в перечне документов физического лица"

2.75

05.10.2020

Мезин Д.А.

В приложение Б добавлен новый раздел Б.9.1 Модернизированный сервис импорта учетных записей пользователя из внешних информационных систем

2.76

27.10.2020

Мезин Д.А.

В приложение Б.12.4 Сервис REST API прикрепления сотрудников к ЦО добавлен код ошибки: ESIA-039961

2.77

03.12.2020

Цветкова Г.А.

1. В приложении Б.9 в таблице 13 добавлено описание кодов ошибок ESIA-910100 и ESIA-910001

2. В приложении Б.9 скорректировано описание примера с ошибкой ESIА-910100

2.78

08.12.2020

Тихонова М.А.

В приложении В4 - для получения информации об организациях, в которые включен пользователь - к данному REST-API добавлен атрибут <admin> с его значением.

2.79

25.12.2020

Маркелова М.Н.

В приложении А.5 и Б.4 изменено наименование параметра телефон с "PHN" на "OPH" в контактах организации

2.80

19.03.2021

Тихонова М.А.

В приложении Б.9:

1. Актуализирована схема импорта (Рисунок 14 - Обобщенный алгоритм импорта в ЕСИА)

2. Внесены изменения в таблицу ФЛК - Параметры ответа на запрос о статусе проверки данных пользователя для полей: ФИО, наименование подразделения, выдавшего документ, и номер подразделения для паспорта РФ; фамилия и имя на латинице и наименование подразделения, выдавшего документ для заграничного паспорта

3. Внесены изменения в таблицу с параметрами ответа. В параметр "code" добавлено примечание по возвращению значения ответа.

4. Удален параметр "message" из таблицы, которая хранит в себе параметры, передающиеся в ответе от вызова метода импорта

5. Добавлены коды ответов на запрос о статусе выполнения заявки (Таблица 12 - Коды и описание ошибок от сервиса импорта)

В приложении Б.2:

- Изменено описание https-адреса REST-API, добавлено описание версии v2

- Добавлена информация об адресе временной регистрации (Таблица 6)

В приложении В.4:

- Добавлен скоуп addresses, удален скоуп contacts (Таблица 18)

В приложении Д.4:

- Добавлен скоуп contacts (Таблица 24)

2.81

14.04.2021

Тихонова М.А.

В приложении В.4:

Добавлен пункт 7 "Перечень scope для предоставления доступа к API ЕПГУ"

2.82

21.04.2021

Тихонова М.А.

В приложении Б.9:

1. Добавлены коды ESIA-020016, ESIA-033448, ESIA-033445 и описание ошибок от сервиса импорта (Таблица 12 - Коды и описание ошибок от сервиса импорта).

2. Актуализирована схема импорта (Рисунок 14).

В конце документа приложен архив со схемой импорта в rar-формате.

В приложении В.6.2.2 добавлено описание реализации механизма бесшовной аутентификации.

2.83

23.04.2021

Жукова Д.А.

В Таблице 16 добавлен новый код ошибки - ESIA-007023.

2.84

27.04.2021

Тихонова М.А.

В приложении Б.9

1. Добавлен параметр "message" в таблицу, которая хранит в себе параметры, передающиеся в ответе от вызова метода импорта.

2. Добавлено описание условий отображения параметром "message" и "decription".