Версия | Дата | Автор | Изменение |
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". |
Сокращение/термин | Наименование/определение |
ЕГРИП | Единый государственный реестр индивидуальных предпринимателей |
ЕГРЮЛ | Единый государственный реестр юридических лиц |
ЕПГУ | Федеральная государственная информационная система "Единый портал государственных и муниципальных услуг (функций)" |
ЕСИА | Федеральная государственная информационная система "Единая система идентификации и аутентификации в инфраструктуре, обеспечивающей информационно-технологическое взаимодействие информационных систем, используемых для предоставления государственных и муниципальных услуг в электронной форме" |
ИНН | Идентификационный номер налогоплательщика |
ИС | Информационная система |
КЭП | Усиленная квалифицированная электронная подпись |
ОГВ | Орган государственной власти. Федеральные органы исполнительной власти, государственные внебюджетные фонды, органы исполнительной власти субъектов Российской Федерации, органы местного самоуправления, государственные и муниципальные учреждения, многофункциональные центры предоставления государственных и муниципальных услуг, а также иные организации, определенные федеральными законами, актами Президента Российской Федерации и актами Правительства Российской Федерации |
ОГРН | Основной государственный регистрационный номер |
ОГРНИП | Основной государственный регистрационный номер индивидуального предпринимателя |
Оператор выдачи ключа ПЭП | Орган или организация, обладающая правом создания (замены) ключа ПЭП в соответствии с постановлением Правительства РФ от 25 января 2013 г. N 33 "Об использовании простой электронной подписи при оказании государственных и муниципальных услуг". В соответствии с указанным постановлением Правительства, в качестве Операторов выдачи ключа ПЭП могут выступать федеральные органы исполнительной власти, государственные внебюджетные фонды, органы исполнительной власти субъектов Российской Федерации, органы местного самоуправления, государственные и муниципальные учреждения, многофункциональные центры предоставления государственных и муниципальных услуг, а также иные организации, определенные федеральными законами, актами Президента Российской Федерации и актами Правительства Российской Федерации (а также уполномоченные ими организации), осуществляющие оказание государственных или муниципальных услуг и подключенные к инфраструктуре, обеспечивающей информационно-технологическое взаимодействие информационных систем, используемых для предоставления государственных и муниципальных услуг в электронной форме |
Оператор ЕСИА | Министерство связи и массовых коммуникаций Российской Федерации |
Оператор ИС | Организация, осуществляющая регистрацию и управление ИС. В качестве операторов ИС, включенных в регистр информационных систем ЕСИА, могут быть организации, обеспечивающие решение следующих задач: - предоставление государственных и муниципальных услуг; - исполнение государственных и муниципальных функций; - формирование БГИР; - межведомственное электронное взаимодействие; - иные задачи, предусмотренные федеральными законами, актами Президента РФ и актами Правительства РФ. |
Пользователь ЕСИА | Пользователь информационно-телекоммуникационной сети "Интернет", зарегистрированный в ЕСИА в качестве физического лица. Может иметь роли индивидуального предпринимателя, сотрудника юридического лица, должностного лица ОГВ |
Поставщик услуг | ИС, интегрированная с ЕСИА и осуществляющая предоставление пользователям ЕСИА данных и услуг, в частности, государственных и муниципальных услуг в электронной форме |
ПЭП | Простая электронная подпись |
Регламент | Регламент взаимодействия участников информационного взаимодействия с оператором ЕСИА и оператором инфраструктуры электронного правительства при организации информационно-технологического взаимодействия информационных систем с использованием ЕСИА |
СМЭВ | Федеральная государственная информационная система "Единая система межведомственного электронного взаимодействия" |
СНИЛС | Страховой номер индивидуального лицевого счета застрахованного лица в системе персонифицированного учета Пенсионного фонда России |
Специалист Центра обслуживания | Сотрудник Оператора выдачи ключа ПЭП, осуществляющий подтверждение личности пользователей ЕСИА |
Технологический портал ЕСИА | Специализированное веб-приложение, размещенное по адресу https://esia.gosuslugi.ru/console/tech. Предназначено, в частности, для управления ИС организаций |
ФИО | Фамилия, имя, отчество |
Центр обслуживания | Центр обслуживания органа или организации, имеющей право создания (замены) и выдачи ключа ПЭП. В Центре обслуживания специалистами Центра обслуживания осуществляется регистрация и/или подтверждение личности пользователей ЕСИА |
ЮЛ | Юридическое лицо |
OAuth | Открытый протокол авторизации |
REST | Передача репрезентативного состояния (Representational State Transfer) |
SAML | Security Assertion Markup Language |
SMS | Служба коротких сообщений (Short Message Service) |
Требования | Рекомендуемое решение |
Требуется знать что-то о пользователе для одного сеанса работы (например, имя, которым подписывать комментарии пользователя). Нет необходимости хранить данные об активности пользователя до следующего сеанса | Давать доступ после получения из ЕСИА ответа на запрос аутентификации, содержащего требуемый набор сведений о пользователе |
Требуется знать что-то о пользователе (например, ФИО, email и др.) и длительно хранить пользовательский контекст (настройки, заявки, комментарии) | Давать доступ после получения из ЕСИА ответа на запрос аутентификации, содержащего требуемый набор сведений о пользователе. При первом входе пользователя регистрировать его идентификатор пользователя (userid). В дальнейшем хранить пользовательский контекст в привязке к этому идентификатору |
Требуется ограничить набор предоставляемых функций в зависимости от типа учетной записи, роли пользователя, использованного метода аутентификации | Давать доступ после получения из ЕСИА ответа на запрос аутентификации, содержащего требуемый набор сведений о пользователе. При попытке пользователя обратиться к функции, для предоставления которой текущие тип учетной записи пользователя, роль пользователя или метод аутентификации являются недостаточными, вывести ему сообщение с пояснениями по дальнейшим действиям. Рекомендуемые сообщения для различных ситуаций приведены в таблице 2. В главе 4.1.1 приведены сведения про типы учетных записей пользователей и роли пользователей |
Ситуация | Как определить ситуацию | Что сообщить и предложить пользователю |
Пользователь с учетной записью с типом упрощенная ("непроверенная") попытался обратиться к функциям, предоставляемым только для стандартных ("проверенных") и/или "подтвержденных" учетных записей | Проанализировать утверждение SAML с именем assuranceLevel или personTrusted (см. таблицу 5) | При доступе к функциям, требующим стандартной (проверенной) учетной записи: "Для доступа вам необходимо пройти процедуру проверки своих данных. Если ваши личные данные только что прошли проверку, то вам нужно войти в систему повторно." Ссылка на проверку данных: https://esia-portal1.test.gosuslugi.ru/validate При доступе к функциям, требующим подтвержденной учетной записи: "Для доступа вам необходимо пройти процедуру проверки своих данных и подтверждения личности. Если вы только что подтвердили свою личность, то вам нужно войти в систему повторно." Ссылка на проверку данных: https://esia-portal1.test.gosuslugi.ru/validate |
Пользователь с учетной записью с типом стандартная (проверенная) попытался обратиться к функциям, предоставляемым только для "подтвержденных" учетных записей | Проанализировать утверждение SAML с именем assuranceLevel (см. таблицу 5) | "Для доступа вам необходимо пройти процедуру подтверждения личности. Если вы только что подтвердили свою личность, то вам нужно войти в систему повторно." Ссылка на подтверждение личности: https://esia-portal1.test.gosuslugi.ru/confirm |
Пользователь с учетной записью с ролью физического лица попытался обратиться к функциям, предоставляемым только для ИП/должностных лиц ЮЛ/должностных лиц ОГВ | Проанализировать утверждение SAML с именем globalRole и orgType (см. таблицу 5) <13> | Если необходима роль сотрудника ЮЛ и текущая учетная запись имеет тип "подтверждена": "Для доступа вам необходимо войти в систему в качестве сотрудника юридического лица. Если вы являетесь руководителем юридического лица, вы также можете зарегистрировать учетную запись юридического лица" Ссылка для регистрации ЮЛ: https://esia-portal1.test.gosuslugi.ru/org Если необходима роль ИП и текущая учетная запись имеет тип "подтверждена": "Для доступа вам необходимо войти в систему в качестве индивидуального предпринимателя. Вы также можете зарегистрировать учетную запись индивидуального предпринимателя." Ссылка: https://esia-portal1.test.gosuslugi.ru/orgs Если необходима роль должностного лица ОГВ и текущая учетная запись имеет тип "подтверждена": "Для доступа вам необходимо войти в систему в качестве должностного лица органа государственной власти." Если пользователь имеет упрощенную (непроверенную)/стандартную (проверенную) учетную запись, то необходимо его проинформировать о необходимости подтверждения личности. Это является необходимым предварительным условием для возможности получения пользователем роли должностного лица ЮЛ, ОГВ или роли ИП |
Пользователь, аутентифицировавшийся по паролю, попытался получить доступ к функции, требующей аутентификации по электронной подписи <14> | Проанализировать утверждение SAML с именем authnMethod (см. таблицу 5) | "Для доступа вам необходимо использовать средство квалифицированной электронной подписи. Если у вас имеется средство электронной подписи, войдите заново, использовав это средство." После этого сообщения рекомендуется разместить кнопку вызова единого завершения сессии |
Процесс | Регистр | Механизм | Ссылка на раздел документа |
Регистрация | Регистр физических лиц | Веб-интерфейс | 4.1.1 |
Программный интерфейс, доступный через СМЭВ | Приложение Г | ||
Регистр юридических лиц | Веб-интерфейс | 4.1.2 | |
Регистр ОГВ | Веб-интерфейс | 4.1.3 | |
Регистр ИС | Веб-интерфейс | 4.1.4, 4.1.5 | |
Управление данными | Регистр физических лиц | Веб-интерфейс | 4.2.1 |
Регистр юридических лиц | Веб-интерфейс | 4.2.2 | |
Программный интерфейс на основе REST | Приложение Б | ||
Регистр ОГВ | Веб-интерфейс | 4.2.3 | |
Программный интерфейс на основе REST | Приложение Б | ||
Регистр ИС | Веб-интерфейс | 4.2.4 | |
Получение данных | Регистр физических лиц | Программный интерфейс на основе SAML | 4.3, Приложение А |
Программный интерфейс на основе REST | 4.3, Приложение Б | ||
Регистр юридических лиц | Программный интерфейс на основе SAML | 4.3, Приложение А | |
Программный интерфейс на основе REST | 4.3, Приложение Б | ||
Регистр ОГВ | Программный интерфейс на основе SAML | 4.3, Приложение А | |
Регистр ИС | Программный интерфейс на основе REST | 4.3, Приложение Б |
Роль | Способ назначения роли |
Индивидуальный предприниматель | Самостоятельно через веб-интерфейс ЕСИА с помощью направления заявки с данными ИП, включающей в себя: - ФИО; - ИНН физического лица; - ОГРНИП. Заявка проходит проверку в БГИР. Если в ЕГРИП действительно существует запись с указанными данными, то пользователь получает роль индивидуального предпринимателя |
Должностное лицо юридического лица | Получение роли должностного лица ЮЛ в ЕСИА происходит в результате: - регистрации ЮЛ в ЕСИА, в этом случае регистрирующий ЮЛ пользователь получает роль должностного лица ЮЛ с правами руководителя (см. п. 4.1.2); - приглашения руководителем или администратором профиля ЮЛ в ЕСИА сотрудника. Процедура приглашения сотрудника для присоединения к организации выполняется с помощью веб-интерфейса ЕСИА <18>. Включает в себя следующие шаги: 1. Руководитель или администратор учетной записи ЮЛ в ЕСИА формирует с помощью веб-интерфейса ЕСИА приглашение на присоединение к организации, включающее в себя: - адрес электронной почты пользователя; - ФИО пользователя; - СНИЛС пользователя (опционально). 2. ЕСИА отправляет на указанный адрес электронной почты пользователя приглашение со ссылкой для присоединения к организации. 3. Пользователь, имеющий подтвержденную учетную запись, входит в ЕСИА по ссылке в приглашении. Если его ФИО и СНИЛС совпадает с данными в приглашении, то он присоединяется к учетной записи ЮЛ. Физическое лицо получает роль должностного лица ЮЛ. |
Должностное лицо ОГВ | Получение роли должностного лица ОГВ в ЕСИА происходит в результате: - регистрации ОГВ в ЕСИА, в этом случае регистрирующий ОГВ пользователь получает роль должностного лица ОГВ с правами руководителя (см. п. 4.1.3); - приглашения руководителем или администратором профиля ОГВ в ЕСИА сотрудника. Процедура приглашения сотрудника для присоединения к ОГВ выполняется с помощью веб-интерфейса ЕСИА <19> и аналогична процессу присоединения сотрудника к учетной записи ЮЛ |
<?xml version="1.0" encoding="UTF-8"?>
<saml2p:AuthnRequest
xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
AssertionConsumerServiceURL="https://atc-
504:7002/oiosaml/saml/SAMLAssertionConsumer"
Destination="https://esia-
portal1.test.gosuslugi.ru/idp/profile/SAML2/Redirect/SSO"
ForceAuthn="false"
ID="_054240e4-b2a8-48e9-b4c6-e0b5e84d3a35"
IsPassive="false"
IssueInstant="2012-02-28T06:43:35.704Z"
ProtocolBinding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-
POST"
Version="2.0">
<saml2:Issuer
xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">sia_test</saml2:Issuer>
</saml2p:AuthnRequest>
https://esia- portal1.test.gosuslugi.ru/idp/profile/SAML2/Redirect/SSO?SAMLRequest=fZJBa%2BMwEIX%2FitBdlqzYWyPilLSlbK FLQ%2BzuYS9FkSepwJGyGtn051dxEtpS6EUg9Oabmfc0v37b92SEgNa7muaZoASc8Z11u5o%2Bt%2FesoteLOep9Lw9qOcRXt4b%2FA 2AkqdChOr3UdAhOeY0WldN7QBWNapZ%2FHpXMhDoEH73xPSVLRAgxtbr1Doc9hAbCaA08rx9r%2BhrjARXnOhpWikJdCSG5t%2F7Ygk %2FHkfgNQcldGsc6HacVLhS0mnUwZrDzY6YjM0d5n3S7LAzcdgeextraHiaq5GvobAATedM8UXLvg4Fp3ZpudY9AycNdTV9EIcy22JR sVpYVK%2FIrzTYm75j%2BVVVFJTeiK02S4koj2hE%2BihEHeHAYtYs1lSKXTEgmq1ZUKp%2BpvMhmVfGPktXZqhvrThH85OvmJEL1u2 1XbPXUtJT8vUSZBPQcnJq6h8%2BJ%2FQzWF4%2FpItn4EpO%2Fc%2F4ZtThfv36JxTs%3D&RelayState=_12db488a-a516-41e3- 801c-3e8f23547314&SigAlg=http%3A%2F%2Fwww.w3.org%2F2000%2F09%2Fxmldsig%23rsa- sha1&Signature=k1XL2WfE1KMHzaJtjjaL2O1soweYNM06Xt50E20QgwRzVOBZ0T79HJEjPMu3jBhDdmM47zlrswbhUFPV22oDbk5K uXJ%2F5FVPwXCTefnVCZGXHU8b1SWuC%2FoKlTSxum6enoommHN5S%2FeYAP9S0KNNW5yEP3eJQHkcsTYuTKPmyP8%3D
<?xml version="1.0" encoding="UTF-8"?>
<saml2p:LogoutRequest xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
Destination="https://esia-portal1.test.gosuslugi.ru/idp/profile/SAML2/Redirect/SLO"
ID="_f51e2082-f899-476d-b88b-6dc743cb4969"
IssueInstant="2012-03-01T13:46:01.984Z"
Reason="urn:oasis:names:tc:SAML:2.0:logout:user"
Version="2.0"
xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
<saml2:Issuer>sia_test</saml2:Issuer>
<saml2:NameID Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient">
_4b58555ef34da11fae0aa08e8987dbb3
</saml2:NameID>
<saml2p:SessionIndex>
86e46a8d455acd02f5a9ef4072f7b66c46b4422bfc38631aa6e50b8d3f032c43
</saml2p:SessionIndex>
</saml2p:LogoutRequest>
<?xml version="1.0" encoding="UTF-8"?>
<saml2p:LogoutRequest xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
Destination="https://atc-504:7002/oiosaml/saml/LogoutServiceHTTPRedirect"
ID="_5741a3cde023a8a669dd720e283642df"
IssueInstant="2012-03-01T13:51:41.711Z"
Version="2.0">
<saml2:Issuer xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
https://esia-portal1.test.gosuslugi.ru/idp/shibboleth
</saml2:Issuer>
<saml2:NameID xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion" Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient">
_4b58555ef34da11fae0aa08e8987dbb3
</saml2:NameID>
</saml2p:LogoutRequest>
<?xml version="1.0" encoding="UTF-8"?>
<saml2p:LogoutResponse xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
Destination="https://atc-504:7002/oiosaml/saml/LogoutServiceHTTPRedirectResponse"
ID="_a0b3a5b88cf9b96d509ee7b9d497f693"
InResponseTo="_f51e2082-f899-476d-b88b-6dc743cb4969"
IssueInstant="2012-03-01T13:45:41.041Z"
Version="2.0">
<saml2:Issuer xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion"
Format="urn:oasis:names:tc:SAML:2.0:nameid-format:entity">
https://esia-portal1.test.gosuslugi.ru/idp/shibboleth
</saml2:Issuer>
<saml2p:Status>
<saml2p:StatusCode Value="urn:oasis:names:tc:SAML:2.0:status:Success"/>
</saml2p:Status>
</saml2p:LogoutResponse>
<?xml version="1.0" encoding="UTF-8"?>
<saml2p:LogoutResponse xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
Destination="https://esia-portal1.test.gosuslugi.ru/idp/profile/SAML2/POST/SLO"
ID="_472d992a-1e50-40ef-8207-fb556eee4893"
InResponseTo="_5741a3cde023a8a669dd720e283642df"
IssueInstant="2012-03-01T13:52:08.177Z"
Version="2.0">
<saml2:Issuer xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
sia_test
</saml2:Issuer>
<saml2p:Status>
<saml2p:StatusCode Value="urn:oasis:names:tc:SAML:2.0:status:Success"/>
</saml2p:Status>
</saml2p:LogoutResponse>
N | Атрибут | Описание | Примечание |
1. | assuranceLevel | Уровень достоверности идентификации пользователя. Возможны следующие значения: AL10 - упрощенная (непроверенная) учетная запись; AL15 - стандартная (проверенная) учетная запись; AL20 - подтвержденная учетная запись; AL30 - подтвержденная учетная запись (аутентификация по КЭП). | Рекомендуется использовать атрибуты: - personTrusted - для определения подтвержденных учетных записей; - authnMethod - для определения метода аутентификации. |
2. | attachedToOrg | Признак включенности (присоединения) к организации | Необходимо использовать globalRole |
3. | authnMethod | Метод аутентификации. Принимает следующие возможные значения: PWD - аутентификации по логину и паролю; DS - аутентификации по ЭП. | |
4. | authToken | Идентификатор сессии пользователя в системе ЕСИА | |
5. | birthDate | Дата рождения пользователя. Передается в формате DD-MM-YYYY | |
6. | firstName | Имя пользователя. Не более 256 символов | |
7. | gender | Пол пользователя. Принимает значения: MALE - мужской; FEMALE - женский. | |
8. | globalRole | Роль пользователя. Принимает следующие возможные значения: P - физическое лицо (Physical person); E - должностное лицо организации (Employee). | |
9. | inn | ИНН пользователя | Сохранен для обеспечения совместимости. Вместо него необходимо использовать personINN |
10. | lastName | Фамилия пользователя. Не более 256 символов | |
11. | middleName | Отчество пользователя. Не более 256 символов | |
12. | memberOfGroups | Принадлежность пользователя к группам доступа ИС, осуществляющей идентификацию и аутентификацию должностных лиц ЮЛ. Передается в виде мнемоник системных групп через запятую | Использовать для определения принадлежности должностных лиц ЮЛ к группам доступа ИС |
13. | name | Имя пользователя | Сохранен для обеспечения совместимости. Необходимо использовать lastName/firstName/middleName |
14. | nsiId | Мнемоника ОГВ | Сохранен для обеспечения совместимости. Необходимо использовать orgOGRN и orgType |
15. | orgAddresses | Адрес организации. Передается в виде XML документа | Каждый адрес в настоящее время описывается следующими атрибутами: <addressType> - тип адреса, в настоящее время может принимать значения: - ORG_LEGAL - юридический адрес; - ORG_POSTAL - почтовый адрес. <contryChar3Code> - код страны из трех символов (для России - RUS); <index> - индекс; <region> - субъект РФ; <district> - внутригородской район; <settlement> - населенный пункт; <street> - улица; <house> - дом; <corpus> - корпус; <structure> - строение; <flat> - квартира. Все атрибуты, начиная с индекса, - не более 256 символов. |
16. | orgBranchKPP | КПП филиала, передается в формате XXXXXXXX, где X - цифры | |
17. | orgBranchName | Имя филиала | |
18. | orgContacts | Телефон и Email организации. Передается в виде XML документа | Каждый контакт в настоящее время описывается следующими атрибутами: <contactType> - тип контакта, в настоящее время может принимать значения: - OPH (телефон); - EML (адрес электронной почты); - FAX (факс). <value> - значение контакта, для телефона и факса имеет формат +7(XXX)XXXXXXX*YYYYYY, где *YYYYYY - добавочный номер (только для OPH, опционально, не более 6 цифр), для адреса электронной почты - не более 2000 символов; <verificationStatus> -- статус подтверждения контакта, где S - подтверждено, N - не подтверждено |
19. | orgId | Идентификатор организации. | Сохранен для обеспечения совместимости. Для вновь подключаемых ИС необходимо использовать orgOid |
20. | orgOid | Идентификатор организации. Любое положительное число | |
21. | orgKPP | КПП организации, передается в формате XXXXXXXX, где X - цифры | |
22. | orgLegalForm | Организационно-правовая форма организации. Передается название формы по справочнику ОКОПФ | |
23. | orgINN | ИНН организации пользователя. Передается в формате XXXXXXXXXX, где X - цифры. Данный атрибут устанавливается только для случая, когда атрибут globalRole = E | |
24. | orgName | Наименование организации пользователя. Не более 4000 символов. Данный атрибут устанавливается только для случая, когда атрибут globalRole = E | |
25. | orgShortName | Краткое наименование организации. Не более 500 символов | |
26. | orgOGRN | ОГРН организации пользователя. Передается в формате XXXXXXXXXXXXX, где X - цифры. Данный атрибут устанавливается только для случая, когда атрибут globalRole = E | |
27. | orgPosition | Должность пользователя в организации. Не более 256 символов | |
28. | orgType | Тип организации. Принимает следующие возможные значения: B - индивидуальный предприниматель (Businessman); L - юридическое лицо (Legal entity); A - орган исполнительной власти (Agency). Данный атрибут устанавливается только для случая, когда атрибут globalRole = E | |
29. | personCitizenship | Гражданство пользователя. Гражданство передается по справочнику ОКСМ. Значение для России - "RUS" | |
30. | personEMail | Адрес электронной почты пользователя. Не более 2000 символов | |
31. | personINN | ИНН пользователя. Передается в формате XXXXXXXXXXXX, где X - цифры. Данный атрибут устанавливается только для случая, когда атрибут personType = R | |
32. | personMobilePhone | Номер мобильного телефона пользователя. Передается в формате +7(XXX)XXXXXXX, где X - цифры | |
33. | personOGRN | ОГРНИП пользователя. Передается в формате XXXXXXXXXXXXXXX, где X - цифры. Данный атрибут устанавливается только для случая, когда атрибут orgType = B | |
34. | personSNILS | СНИЛС пользователя. Передается в формате XXX-XXX-XXX XX, где X - цифры. Данный атрибут устанавливается только для стандартных (проверенных) и подтвержденных учетных записей | |
35. | personTrusted | Подтвержденная или неподтвержденная (упрощенная или стандартная) учетная запись пользователя Y - подтвержденная учетная запись; N - неподтвержденная (упрощенная или стандартная) учетная запись | |
36. | personType | Категория пользователя. | Сохранен для обеспечения совместимости. Необходимо использовать personCitizenship |
37. | principalContacts | Контактные данные пользователя. Передается в виде XML документа | Каждый контакт в настоящее время описывается следующими атрибутами: <contactType> - тип контакта, в настоящее время может принимать значения: - EML (адрес электронной почты); - MBT (мобильный телефон); - PHN (домашний телефон); - CEM (служебный адрес электронной почты пользователя, только для случая, когда атрибут globalRole = E); - CPH (служебный номер телефона пользователя, только для случая, когда атрибут globalRole = E). <value> - значение контакта, для телефонов имеет формат +7(XXX)XXXXXXX, для адреса электронной почты - не более 2000 символов; <verificationStatus> - статус подтверждения контакта, где S - подтверждено, N - не подтверждено |
38. | principalDocuments | Документы пользователя. Передается в виде XML документа | Каждый документ в настоящее время описывается следующими атрибутами: <documentType> - тип документа, в настоящее время это: 01 - паспорт гражданина РФ; 02 - документ иностранного гражданина; 05 - водительское удостоверение; 06 - полис ОМС; 07 - загранпаспорт; <xx> - свидетельство о рождении: - 08 - свидетельство о рождении (без типизации документа); - 18 - свидетельство о рождении РФ; - 28 - свидетельство о рождении иностранного государства; - 38 - свидетельство о рождении СССР; 09 - вид на жительство; 10 - разрешение на временное проживание; 11 - военный билет. <series> - серия документа, 4 символа для паспорта гражданина РФ; <number> - номер документа, 6 символов для паспорта гражданина РФ; <issueDate> - дата выдачи документа в формате YYYY-MM-DDT00:00:00; <verificationStatus> - статус подтверждения документа, где S - подтверждено, N - не подтверждено; <issuedBy> - орган, выдавший документ, строка не более чем из 2000 символов |
39. | principalAddresses | Адрес пользователя. Передается в виде XML документа | Каждый адрес в настоящее время описывается следующими атрибутами: <addressType> - тип адреса, в настоящее время это "PERSON_REGISTRATION" - адрес регистрации, "PERSON_LIVE" - адрес проживания. <contryChar3Code> - трехбуквенный код страны. <index> - индекс. <house> - номер дома. <corpus> - корпус. <flat> - корпус. |
40. | snils | СНИЛС пользователя. Данный атрибут устанавливается только для случая, когда атрибут personType = R | Сохранен для обеспечения совместимости. Необходимо использовать personSNILS |
41. | systemAuthority | Полномочия должностного лица ОГВ. Передается в виде XML с указанием мнемоники полномочия и мнемоники системы | Использовать для определения полномочий должностных лиц ОГВ и ЮЛ. Для определения принадлежности представителей юридических лиц к группам доступа использовать memberOfGroups <28> |
42. | userId | Числовой идентификатор учетной записи пользователя в системе ЕСИА. Любое положительное число | |
43. | userName | Логин пользователя. | Сохранен для обеспечения совместимости. Необходимо использовать userId, personSNILS |
44. | userType | Тип пользователя | Сохранен для обеспечения совместимости. Необходимо использовать globalRole |
<?xml version="1.0" encoding="UTF-8"?>
<!--TODO
Необходимо указать уникальный (в рамках поставщика идентификации) entityID сервис провайдера.
Рекомендуется, чтобы значение атрибута entityID соответствовало домену информационной системы.
Уникальный идентификатор системы в ЕСИА (entity_id) не должен содержать символов кириллицы. Например,
http://moscow.rt.ru
-->
<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"
xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:esia="urn:esia:shibboleth:2.0:mdext"
entityID="http://moscow.rt.ru">
<md:SPSSODescriptor AuthnRequestsSigned="true" WantAssertionsSigned="true"
protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
<md:KeyDescriptor use="signing">
<ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<ds:X509Data>
<ds:X509Certificate>
<!--TODO
Сюда необходимо вставить сертификат электронной подписи X509 сервис провайдера
формата DER в кодировке Base64
-->
</ds:X509Certificate>
</ds:X509Data>
</ds:KeyInfo>
</md:KeyDescriptor>
<md:KeyDescriptor use="encryption">
<ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<ds:X509Data>
<ds:X509Certificate>
<!--TODO
Сюда необходимо вставить сертификат ключа электронной подписи X509
сервис провайдера формата DER в кодировке Base64
-->
</ds:X509Certificate>
</ds:X509Data>
</ds:KeyInfo>
</md:KeyDescriptor>
<!--TODO
Необходимо заполнить атрибуты вызова обработчика сервис провайдера (тег SingleLogoutService),
отвечающего за обработку событий завершения сессий (logout):
- Location - endpoint обработчика событий сервис провайдера, отвечающего за обработку
сообщений от поставщика идентификации о том, что пользователь инициировал событие завершения сессии
пользователя;
- ResponseLocation - endpoint URL обработчика событий сервис провайдера, отвечающего за
обработку сообщений от поставщика идентификации об успешном выполнении операции завершения сессии
пользователя.
-->
<md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"
Location="endpoint URL" ResponseLocation="endpoint URL"/>
<!--TODO
Необходимо заполнить атрибут Location тега AssertionConsumerService, определяющий endpoint
обработчика событий сервис провайдера, отвечающего за обработку ответа от поставщика идентификации на
AuthnRequest запрос сервис провайдера.
-->
<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"
Location="endpoint URL" index="0" isDefault="true"/>
</md:SPSSODescriptor>
<md:AttributeAuthorityDescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:1.1:protocol
urn:oasis:names:tc:SAML:2.0:protocol">
<saml:Attribute NameFormat="urn:mace:shibboleth:1.0:nameIdentifier" Name="transientId"><!--
Сессионный идентификатор запроса сервис провайдера--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="authToken" Name="urn:mace:dir:attribute:authToken"><!--Идентификатор сессии поставщика
идентификации--></saml:Attribute>
<!--TODO
Далее следует список дополнительных атрибутов пользователя, которые могут быть включены в ответ
поставщика идентификации на AuthnRequest запрос сервис провайдера.
Необходимо оставить только те атрибуты, которые необходимы ИС.
-->
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="userId" Name="urn:mace:dir:attribute:userId"><!--Уникальный идентификатор пользователя в
рамках поставщика идентификации--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="authnMethod" Name="urn:esia:authnMethod"><!--Метод аутентификации с помощью которого
пользователь прошел аутентификацию--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="globalRole" Name="urn:esia:globalRole"><!--Роль под которой аутентифицировался
пользователь--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="lastName" Name="urn:mace:dir:attribute:lastName"><!--Фамилия пользователя--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="firstName" Name="urn:mace:dir:attribute:firstName"><!--Имя пользователя--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="middleName" Name="urn:mace:dir:attribute:middleName"><!--Отчество пользователя--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="personINN" Name="urn:esia:personINN"><!--ИНН пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="personSNILS" Name="urn:esia:personSNILS"><!--СНИЛС пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="personOGRN" Name="urn:esia:personOGRN"><!--ОГРНИП пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="personEMail" Name="urn:esia:personEMail"><!--Электронный адрес пользователя--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="assuranceLevel" Name="urn:esia:assuranceLevel"><!--Уровень достоверности идентификации
пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="birthDate" Name="urn:esia:birthDate"><!--Дата рождения пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="gender" Name="urn:esia:gender"><!--Пол пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="memberOfGroups" Name="urn:esia:memberOfGroups"><!--Принадлежность пользователя к группам
доступа--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="systemAuthority" Name="urn:esia:systemAuthority"><!--Полномочия должностного лица--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="personCitizenship" Name="urn:esia:personCitizenship"><!--Гражданство пользователя--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="personMobilePhone" Name="urn:esia:personMobilePhone"><!--Номер мобильного телефона
пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="personTrusted" Name="urn:esia:personTrusted"><!--Подтвержденная или неподтвержденная
учетная запись пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="principalAddresses" Name="urn:esia:principalAddresses"><!--Адреса пользователя--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="principalContacts" Name="urn:esia:principalContacts"><!--Контактные данные пользователя--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="principalDocuments" Name="urn:esia:principalDocuments"><!--Документы пользователя--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgType" Name="urn:esia:orgType"><!--Тип организации пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgName" Name="urn:esia:orgName"><!--Имя организации пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgOGRN" Name="urn:esia:orgOGRN"><!--ОГРН организации пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgINN" Name="urn:esia:orgINN"><!--ИНН организации пользователя--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgPosition" Name="urn:esia:orgPosition"><!--Должность пользователя в организации--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgAddresses" Name="urn:esia:orgAddresses"><!--Адрес организации--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgBranchKPP" Name="urn:esia:orgBranchKPP"><!--КПП филиала--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgContacts" Name="urn:esia:orgContacts"><!--Телефон и Email организации--
></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgOid" Name="urn:esia:orgOid"><!--Идентификатор организации--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgKPP" Name="urn:esia:orgKPP"><!--КПП организации--></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgLegalForm" Name="urn:esia:orgLegalForm"><!--Организационно-правовая форма организации-
-></saml:Attribute>
<saml:Attribute NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
friendlyName="orgShortName" Name="urn:esia:orgShortName"><!--Краткое наименование организации--
></saml:Attribute>
</md:AttributeAuthorityDescriptor>
<md:Organization>
<!--TODO
Необходимо заполнить описание организации, к которой относится интегрируемая с ЕСИА ИС:
- OrganizationName - имя организации;
- OrganizationDisplayName - имя организации, которая может отображаться пользователям при
проведении процедуры аутентификации;
- OrganizationURL - URL web-сайт компании.
-->
<md:OrganizationName xml:lang="ru">ОАО "Ростелеком"</md:OrganizationName>
<md:OrganizationDisplayName xml:lang="ru">Ростелеком</md:OrganizationDisplayName>
<md:OrganizationURL xml:lang="en">http://www.rt.ru</md:OrganizationURL>
</md:Organization>
<!--TODO
Необходимо заполнить атрибуты организации, к которой относится интегрируемая с ЕСИА информационная
система:
- Company - имя организации, которая осуществляет эксплуатацию ИС;
- EmailAddress - электронная почта эксплуатации ИС.
-->
<md:ContactPerson contactType="technical">
<md:Company>ОАО "Ростелеком"</md:Company>
<md:EmailAddress>support@rt.ru</md:EmailAddress>
</md:ContactPerson>
<!--*********-->
<!--EXTENSIONS-->
<!--*********-->
<md:Extensions>
<!--TODO
Далее следует список поддерживаемых поставщиком услуг глобальных ролей пользователей, а также
поддерживаемые типы организаций (для роли должностное лицо организации).
Необходимо оставить только те роли и типы организации, которые поддерживаются поставщиком
услуг.
Примечание. В случае некорректной обработки тега <md:Extensions> вашей реализацией поставщика
услуг, данный тег можно закомментировать.
-->
<!--TODO
В случае, если ИС не поддерживает работу с ролью "Должностное лицо организации", данный тег не
обязателен.
В случае, если ИС поддерживает глобальную роль "Должностное лицо организации", необходимо также
указать, работу с должностными лицами каких типов организации ИС поддерживает.
В случае, если ИС поддерживает глобальную роль "Должностное лицо организации" (этот случай
включает отсутствие тега SupportedGlobalRoles), но тег SupportedOrgTypes отсутствует - ЕСИА будет
считать, что ИС поддерживает все типы организации.
-->
<!--В случае отсутствия тега SupportedGlobalRoles, ЕСИА будет считать, что ИС поддерживает все
глобальные роли-->
<esia:SupportedGlobalRoles>
<esia:GlobalRole ID="P"></esia:GlobalRole> <!-- Физическое лицо -->
<esia:GlobalRole ID="E"> <!-- Должностное лицо организации -->
<esia:SupportedOrgTypes>
<esia:OrgType ID="L"/> <!-- Юридическое лицо -->
<esia:OrgType ID="B"/> <!-- Индивидуальный предприниматель-->
<esia:OrgType ID="A"/> <!-- Орган исполнительной власти -->
</esia:SupportedOrgTypes>
</esia:GlobalRole>
</esia:SupportedGlobalRoles>
<esia:SupportedAuthnMethods>
<esia:AuthnMethod ID="PWD"/> <!-- Авторизация по паролю -->
<esia:AuthnMethod ID="DS"/> <!-- Авторизация по КЭП -->
</esia:SupportedAuthnMethods>
<esia:SupportedAccTypes>
<esia:AccType ID="T"/> <!-- Авторизация только подтвержденных УЗ -->
<esia:AccType ID="L"/> <!-- Авторизация упрощенных УЗ, но включая подтвержденные -->
</esia:SupportedAccTypes>
</md:Extensions>
</md:EntityDescriptor>
<md:SingleLogoutService ResponseLocation="http://www.gosuslugi.ru/pgu/saml/LogoutServiceHTTPRedirectResponse" Location="https://www.gosuslugi.ru/pgu/saml/LogoutServiceHTTPRedirect" Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"/> <md:AssertionConsumerService Location="https://www.gosuslugi.ru/pgu/saml/SAMLAssertionConsumer" Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" isDefault="true" index="0"/>
<md:SingleLogoutService ResponseLocation="http://109.207.1.97/pgu/saml/LogoutServiceHTTPRedirectResponse" Location="https://109.207.1.97/pgu/saml/LogoutServiceHTTPRedirect" Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"/> <md:AssertionConsumerService Location="https://109.207.1.97/pgu/saml/SAMLAssertionConsumer" Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" isDefault="true" index="0"/>
public class Resource extends HttpServlet {
private static SamlConsumer consumer = new SamlConsumer();
public void doGet(HttpServletRequest request, HttpServletResponse response)
{
requestMessage = consumer.buildRequestMessage();
response.sendRedirect(requestMessage);
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
{
responseMessage = request.getParameter("SAMLResponse").toString();
result = consumer.processResponseMessage(responseMessage);
}
}
// Создание элемента <Issuer>
// issuerUrl - это url сервис-провайдера, который генерирует сообщение <authnRequest>
String issuerUrl = "http://localhost:8080/saml-demo/resource";
IssuerBuilder issuerBuilder = new IssuerBuilder();
Issuer issuer = issuerBuilder.buildObject("urn:oasis:names:tc:SAML:2.0:assertion","Issuer","samlp");
issuer.setValue(issuerUrl);
// создание запроса <AutnRequest>
DateTime issueInstant = new DateTime();
AuthnRequestBuilder authRequestBuilder = new AuthnRequestBuilder();
AuthnRequest authRequest = authRequestBuilder.buildObject("urn:oasis:names:tc:SAML:2.0:protocol",
"AuthnRequest", "samlp");
authRequest.setForceAuthn(new Boolean(false));
authRequest.setIsPassive(new Boolean(false));
authRequest.setIssueInstant(issueInstant);
authRequest.setProtocolBinding("urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST");
authRequest.setAssertionConsumerServiceURL(issuerUrl);
authRequest.setIssuer(issuer);
authRequest.setID(aRandomId);
authRequest.setVersion(SAMLVersion.VERSION_20);
responseMessage = request.getParameter("SAMLResponse").toString();
DocumentBuilderFactory documentBuilderFactory = DocumentBuilderFactory.newInstance(); documentBuilderFactory.setNamespaceAware(true); DocumentBuilder docBuilder = documentBuilderFactory.newDocumentBuilder(); Document document = docBuilder.parse(new ByteArrayInputStream(authReqStr.trim().getBytes())); Element element = document.getDocumentElement(); UnmarshallerFactory unmarshallerFactory = Configuration.getUnmarshallerFactory(); Unmarshaller unmarshaller = unmarshallerFactory.getUnmarshaller(element); Response response = (Response) unmarshaller.unmarshall(element);
String subject = response.getAssertions().get(0).getSubject().getNameID().getValue(); String certificate = response.getSignature().getKeyInfo().getX509Datas().get(0).getX509Certificates().get(0).getValue();
<?xml version="1.0" encoding="UTF-8"?>
<saml2:Assertion xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion"
ID="_f634a1edd5a52c852641c0943475edd7" IssueInstant="2012-03-01T06:30:00.307Z" Version="2.0"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<saml2:Issuer Format="urn:oasis:names:tc:SAML:2.0:nameid-format:entity">https://esia-
portal1.test.gosuslugi.ru/idp/shibboleth</saml2:Issuer>
<ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
<ds:SignedInfo>
<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>
<ds:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<ds:Reference URI="#_f634a1edd5a52c852641c0943475edd7">
<ds:Transforms>
<ds:Transform
Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
<ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#">
<ec:InclusiveNamespaces
xmlns:ec="http://www.w3.org/2001/10/xml-exc-c14n#" PrefixList="xs"/>
</ds:Transform>
</ds:Transforms>
<ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<ds:DigestValue>6p7pdI3FulCoSG2kZbGOtW1GCag=</ds:DigestValue>
</ds:Reference>
</ds:SignedInfo>
<ds:SignatureValue>
</ds:SignatureValue>
<ds:KeyInfo>
<ds:X509Data>
<ds:X509Certificate>
</ds:X509Certificate>
</ds:X509Data>
</ds:KeyInfo>
</ds:Signature>
<saml2:Subject>
<saml2:NameID Format="urn:oasis:names:tc:SAML:2.0:nameid-
format:transient">_a8e8800fa174f41782184cbbd21ee05f</saml2:NameID>
<saml2:SubjectConfirmation Method="urn:oasis:names:tc:SAML:2.0:cm:bearer">
<saml2:SubjectConfirmationData Address="127.0.0.1" InResponseTo="_34efa5b7-47e6-
41bb-b51b-fcb57b7a3f87" NotOnOrAfter="2012-03-01T06:35:00.307Z" Recipient="https://atc-
504:7002/oiosaml/saml/SAMLAssertionConsumer"/>
</saml2:SubjectConfirmation>
</saml2:Subject>
<saml2:Conditions NotBefore="2012-03-01T06:30:00.307Z" NotOnOrAfter="2012-03-01T06:35:00.307Z">
<saml2:AudienceRestriction>
<saml2:Audience>sia_test</saml2:Audience>
</saml2:AudienceRestriction>
</saml2:Conditions>
<saml2:AuthnStatement AuthnInstant="2012-03-01T06:30:00.182Z"
SessionIndex="211f42f443924066aec4d5bc8740bce17a93ba3358d9e7003333db957540116b">
<saml2:SubjectLocality Address="127.0.0.1"/>
<saml2:AuthnContext>
<saml2:AuthnContextClassRef>urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport</
saml2:AuthnContextClassRef>
</saml2:AuthnContext>
</saml2:AuthnStatement>
<saml2:AttributeStatement>
<saml2:Attribute FriendlyName="personSNILS" Name="urn:esia:personSNILS"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">000-000-000 00</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="userId" Name="urn:mace:dir:attribute:userId"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">2006101</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="snils" Name="urn:mace:dir:attribute:snils"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">000-000-000 00</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="authnMethod" Name="urn:esia:authnMethod"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">PWD</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="principalStatus"
Name="urn:mace:dir:attribute:principalStatus" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-
format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">A</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="globalRole" Name="urn:esia:globalRole"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">P</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="personEMail" Name="urn:esia:personEMail"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">sdf@ddd.ru</saml2:AttributeValue>
</saml2:Attribute>
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">SNILS</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="personType" Name="urn:esia:personType"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">R</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="authToken" Name="urn:mace:dir:attribute:authToken"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">b0db6fd1-d674-47bb-8f22-9f8291e59255</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="userName" Name="urn:esia:userName"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">000-000-000 00</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="middleName" Name="urn:mace:dir:attribute:middleName"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">Дмитриевич</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="attachedToOrg" Name="urn:esia:attachedToOrg"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">1</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="firstName" Name="urn:mace:dir:attribute:firstName"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">Дмитрий</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="lastName" Name="urn:mace:dir:attribute:lastName"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">Дмитриев</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="portalVersion"
Name="urn:mace:dir:attribute:portalVersion" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-
format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">P</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute FriendlyName="userType" Name="urn:mace:dir:attribute:userType"
NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">P</saml2:AttributeValue>
</saml2:Attribute>
</saml2:AttributeStatement>
</saml2:Assertion>
GET /rs/orgs/1000000000 HTTP/1.1\r\n Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
GET /rs/orgs?pageIndex=0&pageSize=15 HTTP/1.1\r\n Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
GET /rs/prns/402 HTTP/1.1\r\n Authorization: Bearer 75b2c7cbd9db403489c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: application/json; schema="https://esia-portal1.test.gosuslugi.ru/rs/model/prn/Person-1"\r\n
Link:
[<https://esia-portal1.test.gosuslugi.ru/rs/prns/402/docs>;rel=documents;schema="https://esia-
portal1.test.gosuslugi.ru/rs/model/docs/Documents-1",
<https://esia-portal1.test.gosuslugi.ru/rs/prns/402/addrs>;rel=addresses;schema="https://esia-
portal1.test.gosuslugi.ru/rs/model/addrs/Addresses-1",
<https://esia-portal1.test.gosuslugi.ru/rs/prns/402/ctts>;rel=contacts;schema="https://esia-
portal1.test.gosuslugi.ru/rs/model/ctts/Contacts-1",
<https://esia-portal1.test.gosuslugi.ru/rs/prns/>;rel=parent;schema="https://esia-
portal1.test.gosuslugi.ru/rs/model/prns/Persons-1"]
Date: [Tue, 26 Nov 2013 10:04:24 GMT]
Transfer-Encoding: [chunked]
Location: [http://esia-portal1.test.gosuslugi.ru/rs/prns/402]
server: [grizzly/2.2.16]
Content-Type: [application/json; q=.2; schema="https://esia-
portal1.test.gosuslugi.ru/rs/model/prn/Person-1"]
{
"stateFacts": ["Identifiable"],
"firstName":"Петр",
"lastName":"Петров",
"birthDate": "19.03.1996",
"gender":"M",
"trusted":"true",
"citizenship":"RUS",
"snils":"111-111-111 11",
"updatedOn":"1385460263"
}
{
"stateFacts": ["Paginated","FirstPage"],
"elements":[
"https://esia-portal1.test.gosuslugi.ru/rs/prns/400",
"https://esia-portal1.test.gosuslugi.ru/rs/prns/401"
],
"pageSize":"2",
"pageIndex":"1"
}
https://esia-portal1.test.gosuslugi.ru/rs/prns/100000/ctts
https://esia-portal1.test.gosuslugi.ru/rs/prns/100000/ctts?embed=(elements)
{
"stateFacts": ["hasSize"],
"elements": [
{
"stateFacts": [
"Identifiable"
],
"id": 194,
"type": "MBT",
"vrfStu": "VERIFIED",
"value": "+7(910)1234567"
}
],
"size": 1
}
https://esia-portal1.test.gosuslugi.ru/rs/prns/100000/ctts?embed=(elements-1)
https://esia-portal1.test.gosuslugi.ru/rs/orgs/100000/emps?embed=(elements.person)
https://esia-portal1.test.gosuslugi.ru/rs/orgs/100000/emps?embed=(elements-1.person-1)
GET /rs/prns/6924 HTTP/1.1\r\n Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
N | URI запрашиваемого ресурса | Описание ресурса | Предоставляемые данные |
1. | /prns/{oid} | Данные о пользователе с идентификатором prn-id | Данные о физическом лице: <rIdDoc> - идентификатор текущего документа пользователя; <firstName> - имя; <lastName> - фамилия; <middleName> - отчество; <birthDate> - дата рождения (в формате "ДД.ММ.ГГГГ"); <birthPlace> - место рождения пользователя; <gender> - пол; <trusted> - тип учетной записи (подтверждена ("true")/не подтверждена ("false")); <citizenship> - гражданство (идентификатор страны гражданства); <snils> - СНИЛС; <inn> - ИНН; <updatedOn> - дата последнего изменения учетной записи пользователя (задается как количество секунд, прошедших с 00:00:00 UTC 1 января 1970 года); <verifying> - процесс проверки данных (true/false); <status> - статус УЗ (Registered - зарегистрирована/Deleted - удалена); <selfEmployed> - информация о самозанятом: - <confirmed> - значение "true" - признак самозанятого есть, "false" - признака самозанятого нет; - <confirmDate> - дата обновления статуса самозанятого; <fmsValid> - валидность документа в ФМС (false - документ неактуален, в таком случае, к параметрам добавляется fmsState; true - документ актуален); <fmsState> - статус документа в ФМС, может иметь значения: - "PERSON_NOT_FOUND" - по указанному в запросе СНИЛС пользователь в БД ИС МВД не найден; - "PASSPORT_NOT_FOUND" - в случае, если в полученном досье есть паспорт гражданина РФ и он имеет DOC_STATUS = 302 и в досье нет паспорта гражданина РФ с DOC_STATUS = 300; - "PASSPORT_INVALID" - в случае, если в полученном досье есть паспорт гражданина РФ и он имеет DOC_STATUS = 301 и его данные (серия, номер) совпадают с указанными в УЗ пользователя, при этом в досье нет паспорта гражданина РФ с DOC_STATUS = 300; - "AUTO_UPDATE_SUCCESS" - в случае успешного завершения автоматического обновления |
2. | /prns/{oid}/ctts | Перечень контактов физического лица | Перечень контактов физического лица (в виде ссылок на ресурс с указанием {ctt_id}, содержащий данные о каждом контакте) |
3. | /prns/{oid}/ctts/{ctt_id} | Сведения об отдельной записи в перечне контактов физического лица | Контактные данные: <type> - тип записи, может иметь значения: - "MBT" - мобильный телефон; - "PHN" - домашний телефон; - "EML" - электронная почта. <vrfStu> - сведения о "подтвержденности" контактов, может иметь значения: - "NOT_VERIFIED" - не подтвержден; - "VERIFIED" - подтвержден. В настоящее время статус "VERIFIED" может быть только у мобильного телефона ("MBT") и адреса электронной почты ("EML"). <value> - значение контакта; <vrfValStu> - необязательный параметр, указывается в случае, если контакт находится в процессе подтверждения. Может принимать следующее значение: - "VERIFYING" - в процессе подтверждения. В настоящее время статус "VERIFYING" может быть только у мобильного телефона ("MBT") и адреса электронной почты ("EML"). <verifyingValue> - значение контакта, находящегося в процессе подтверждения. |
4. | /prns/{oid}/addrs | Перечень адресов физического лица | Перечень адресов физического лица (в виде ссылок на ресурс с указанием {addr_id}, содержащий данные о каждом адресе) |
5. | /prns/{oid}/addrs/{addr_id} | Сведения об отдельной записи в перечне адресов физического лица | Адреса: <type> - тип записи, может иметь значения: - "PLV" - адрес места проживания; - "PTA" - адрес временной регистрации; - "PRG" - адрес постоянной регистрации. <zipCode> - индекс; <countryId> - идентификатор страны; <addressStr> - адрес в виде строки (не включая дом, строение, корпус, номер квартиры); <building> - строение; <frame> - корпус; <house> - дом; <flat> - квартира; <fiasCode> - код КЛАДР; <region> - регион; <city> - город; <district> - внутригородской район; <area> - район; <settlement> - поселение; <additionArea> - доп. территория; <additionAreaStreet> - улица на доп. территории; <street> - улица. |
6. | /prns/{oid}/docs | Перечень документов физического лица | Перечень документов физического лица (в виде ссылок на ресурс с указанием {doc_id}, содержащий данные о каждом документе); |
7. | /prns/{oid}/docs/{doc_id} | Сведения об отдельной записи в перечне документов физического лица | Документы: <type> - тип записи, может иметь значения: - "RF_PASSPORT" - паспорт гражданина РФ; - "FID_DOC" - документ иностранного гражданина; - "RF_DRIVING_LICENSE" - водительское удостоверение. - "MLTR_ID" - военный билет; - "FRGN_PASS" - заграничный паспорт; - "MDCL_PLCY" - полис ОМС; - "RF_BRTH_CERT" - свидетельство о рождении - Россия; - "FID_BRTH_CERT" - свидетельство о рождении - другая страна; - "OLD_BRTH_CERT" - свидетельство о рождении - СССР. <vrfStu> - сведения о "подтвержденности" документов, может иметь значения: - "NOT_VERIFIED" - не подтвержден; - "VERIFIED" - подтвержден. <actNo> - номер актовой записи (для свидетельства о рождении РФ и СССР); <actDate> - дата актовой записи (только для свидетельства о рождении ребенка РФ); <series> - серия документа; <number> - номер документа; <issueDate> - дата выдачи документа; <issueId> - код подразделения; <issuedBy> - кем выдан; <expiryDate> - срок действия документа; <lastName> - фамилия (для заграничного паспорта); <firstName> - имя (для заграничного паспорта). <vrfValStu> - необязательный параметр, указывается в случае, если документ находится в процессе подтверждения. Может принимать следующее значение: - "VERIFYING" - в процессе подтверждения; - "VERIFICATION_FAILED" - ошибки проверки. "vrfReqId" - идентификатор заявки; <eTag> - тег изменяемого объекта; <fmsValid> - валидность документа в ФМС (false - документ неактуален, в таком случае, к параметрам добавляется fmsState; true - документ актуален); <fmsState> - статус документа в ФМС, может иметь значения: - "PERSON_NOT_FOUND" - по указанному в запросе СНИЛС пользователь в БД ИС МВД не найден; - "PASSPORT_NOT_FOUND" - в случае, если в полученном досье есть паспорт гражданина РФ и он имеет DOC_STATUS = 302 и в досье нет паспорта гражданина РФ с DOC_STATUS = 300; - "PASSPORT_INVALID" - в случае, если в полученном досье есть паспорт гражданина РФ и он имеет DOC_STATUS = 301 и его данные (серия, номер) совпадают с указанными в УЗ пользователя, при этом в досье нет паспорта гражданина РФ с DOC_STATUS = 300; - "AUTO_UPDATE_SUCCESS" - в случае успешного завершения автоматического обновления |
8. | /prns/{oid}/orgs | Перечень организаций, сотрудником которых является данное физическое лицо | Перечень организаций, сотрудником которых является физическое лицо с данным {oid} (в виде ссылок на ресурс с указанием {oid}, содержащий данные о каждой организации) |
9. | /prns/{oid}/kids | Перечень записей о детях физического лица | Перечень детей физического лица (в виде ссылок на ресурс с указанием {kid_id}, содержащий данные о каждом ребенке) |
10. | /prns/{oid}/kids/{kid_id} | Сведения об отдельной записи в перечне детей физического лица | Дети: <firstName> - имя ребенка; <lastName> - фамилия ребенка; <middleName> - отчество ребенка; <birthDate> - дата рождения; <gender> - пол; <snils> - СНИЛС; <inn> - ИНН; <trusted> - признак подтвержденности данных о ребенке (подтверждены ("true")/не подтверждены ("false")); <updatedOn> - дата последнего изменения данных о ребенке (задается как количество секунд, прошедших с 00:00:00 UTC 1 января 1970 года) |
11. | /prns/{oid}/kids/{kid_id}/docs | Перечень документов ребенка физического лица | Перечень документов ребенка данного физического лица (в виде ссылок на ресурс с указанием {doc_id}, содержащий данные о каждом документе) |
12. | /prns/{oid}/kids/{kid_id}/docs/{doc_id} | Сведения об отдельной записи в перечне документов ребенка физического лица | Документы ребенка описываются по аналогии с документами физического лица. Для детей предусмотрены следующие типы (<type>) документов: - "MDCL_PLCY" - полис ОМС; - "RF_BRTH_CERT" - свидетельство о рождении - Россия; - "FID_BRTH_CERT" - свидетельство о рождении - другая страна; - "OLD_BRTH_CERT" - свидетельство о рождении - СССР <31>. |
13. | /prns/{oid}/vhls | Перечень транспортных средств | Перечень транспортных средств, которыми владеет данный пользователь |
14. | prns/{oid}/vhls?embed=(vehi cles.elements) | Перечень транспортных средств с данными о каждом транспортном средстве | Перечень транспортных средств, которыми владеет данный пользователь, содержащий информацию о каждом транспортном средстве |
15. | /prns/{oid}/vhls/{vhl-id} | Транспортное средство пользователя | <name> - имя автомобиля (например, марка или другое пользовательское описание); <numberPlate> - государственный регистрационный знак; <regCertificate> - данные свидетельства о государственной регистрации, включает в себя атрибуты: - <series> - серия свидетельства; - <number> - номер свидетельства. |
{
"stateFacts": ["Identifiable"],
"type":"MBT",
"vrfStu":"VERIFIED",
"value":"+7(777)7777777"
}
{
"stateFacts":["Identifiable"],
"eTag": "672951A704B88A0063A35C3F49409152B087A49A",
"id": 21423,
"type": "PRG",
"region": "Воронежская Область",
"addressStr": "Воронежская область, Воронеж город, ПКрл Маяк-1 территория",
"frame": "5",
"fiasCode": "5bf5ddff-6353-4a3d-80c4-6fb27f00c6c1",
"city": "Воронеж Город",
"countryId": "RUS",
{
"stateFacts": ["Identifiable"],
"type":"RF_PASSPORT",
"vrfStu":"VERIFIED",
"series":"3333",
"number":"333333",
"issueDate":"1383249600",
"issueId":"333333"
}
{
"stateFacts": ["Identifiable"],
"name": "Хонда",
"numberPlate": "А133ОН177",
"regCertificate": {
"series": "77УЕ",
"number": "204623"
}
}
{
"stateFacts": ["Paginated"],
"size": 5,
"pageSize": 5,
"pageIndex": 2,
"totalSize": 12,
"eTag": "E6DAE96DADE1CA29F5C50979BBB7C8BF4422FD62",
"elements": [{
"stateFacts": ["Identifiable"],
"id": 6590,
"name": "TOYOTA",
"numberPlate": "А111АА136",
"regCertificate": {"series": "1234","number": "123456"},
"eTag": "F69EEA8910E298E97C8E6249A130A7195DFE7F1A"},
............. }
GET /categories/prns/1077128402 HTTP/1.1\r\n Authorization: Bearer eyJ2ZXIiOjEsInR5cCI6IkpXVCIsInNidCI6ImFjY2VzcyIsImFsZyI6IlJTMjU2In0.eyJuYmYiOjE2MDAzNDE5NzEsInNjb3B lIjoic2VsZl9lbXBsb3llZD9vaWQ9MTA3NzEyNzk1NSIsImlzcyI6Imh0dHA6XC9cL2VzaWEuZ29zdXNsdWdpLnJ1XC8iLCJ1cm 46ZXNpYTpzaWQiOiJjYWRhOTE5N2Q2MDAzZTVmZTI0MDIxOGMyODA1NDc1ZGM4YjIxNTFiZTQ0MGQ1YWQzMTQ3ODFiMDUxNGNmZ WM2IiwidXJuOmVzaWE6c2JqX2lkIjoxMDc3MTI3OTU1LCJleHAiOjE2MDAzNDU1NzEsImlhdCI6MTYwMDM0MTk3MSwiY2xpZW50 X2lkIjoiUEdVIn0.VySaaGxci6XpwL7V0Df3yLIBENGP7R6ki9sQ4MqdHoc2ItkI4ObI7sClWNaaSQxE_vNXUqszYWUPde_vOWM oNSbjSUbITPrXr9tgb6LuZbCpKSFxwnu8WAjqQfWfcssNWn9- MxpAJHrEfVUu6eMpVfcME_qFDc4YtKVLmWQ8viPpL0E2gokn_E67EibHevnJY13H7GpKL0UYzNV40rr4O8Ai2zaGG8WZ3GM_ZRE FMMbH3aW3mfoCSF_QDKqPiZI6OhhvNtgo6VKarverbFo4y1hqQD7p3KTSXjukoeQ2OYnNHQj9V01mJtxXrTxXIcnkyq8Fj60FCB uX6bhtgwBQ9Q Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
N | URI запрашиваемого ресурса | Описание ресурса | Предоставляемые данные |
1. | /categories/prns/{oid} | Данные о категориях организации с идентификатором {orgOid} | Данные о категориях организации: <stateFacts> - параметр, указывающий на факты о предоставляемых сведениях (постраничный список, имеет размер и т.п.); <size> - кол-во категорий в коллекции; <pageSize> - параметр пагинации (размер страницы - количество элементов на странице); <pageIndex> - параметр пагинации (номер страницы); <elements> - массив, содержащий информацию о категориях: <parentName> - наименование родительской категории; <parentId> - идентификатор родительской категории; <catName> - наименование категории; <catId> - идентификатор категории; <catConfirm> - признак того, что категория является подтверждаемой (N - категория не подтверждаемая, Y - категория является подтверждаемой); <status> - статус подтверждения категории. OK - Категория присвоена и содержится в справочнике ЕСНСИ и в ЕСИА; <confirmDate> - дата и время подтверждения категории в формате timestamp; <confirmOrgName> - наименование организации, подтверждающей категорию (указывается только для подтверждаемых категорий (catConfirm=Y)); <confirmOrgOid> - OID организации в ЕСИА, которая подтверждает данную категорию (указывается только для подтверждаемых категорий (catConfirm=Y)); <confirmOrgValueType> - тип идентификатора организации, которая подтверждает данную категорию (указывается только для подтверждаемых категорий (catConfirm=Y)). Может принимать следующие значения: - OGRN; <confirmOrgVal> - значение идентификатора организации, которая подтверждает данную категорию (указывается только для подтверждаемых категорий (catConfirm=Y)). |
{
"stateFacts":[
"FirstPage",
"Paginated"
],
"size": 2,
"pageSize": 100,
"pageIndex": 1,
"elements":[
{
"parentName": "Ремонт",
"parentId": "1001",
"catName": "Сантехник",
"catId": "1005",
"catConfirm": "N",
"status": "OK",
"confirmDate": 1599078238000
},
{
"parentName": "Развлечения",
"parentId": "1121",
"catName": "Торговля фруктовой, ягодной, овощной продукцией, выращенной самостоятельно",
"catId": "44",
"catConfirm": "N",
"status": "OK",
"confirmDate": 1599077915000
}
]
}
GET /rs/prns?status=DELETED&updatedSince=1384218061 HTTP/1.1\r\n Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
GET /rs/orgs/1000000000 HTTP/1.1\r\n Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
N | URI запрашиваемого ресурса | Описание ресурса | Предоставляемые данные |
1. | /orgs/{orgOid} | Данные об организации с идентификатором {orgOid} | Данные об организации: <shortName> - сокращенное наименование организации; <fullName> - полное наименование организации; <type> - тип организации. Для государственных организаций - "AGENCY", для юридических лиц - "LEGAL"; <ogrn> - ОГРН организации; <inn> - ИНН организации; <leg> - код организационно-правовой формы по общероссийскому классификатору организационно-правовых форм; <kpp> - КПП организации; <agencyTerRange> - территориальная принадлежность ОГВ (только для государственных организаций, код по справочнику "Субъекты Российской Федерации" (ССРФ), для Российской Федерации используется код 00; <agencyType> - тип ОГВ (только для государственных организаций) <34>; <staffCount> - количество сотрудников организации; <branchesCount> - количество филиалов организации (только для ЮЛ и ОГВ). |
2. | /orgs/{orgOid}/brhs | Перечень филиалов организации | Перечень филиалов организации (в виде ссылок на ресурс с указанием {branch_id}, содержащий данные о каждом филиале) |
3. | /orgs/{orgOid}/brhs/{branch_id} | Сведения о филиале организации | Данные о филиале: <name> - имя филиала; <kpp> - КПП филиала; <leg> - код организационно-правовой формы по общероссийскому классификатору организационно-правовых форм; <staffCount> - количество сотрудников филиала. Для просмотра контактных данных и адресов филиала следует воспользоваться ресурсами /orgs/{orgOid}/brhs/{branch_id}/ctts и /orgs/{orgOid}/brhs/{branch_id}/addrs соответственно. Структура этих ресурсов аналогична ресурсам головной организации |
4. | /orgs/{orgOid}/ctts | Перечень контактов организации | Перечень контактов организации (в виде ссылок на ресурс с указанием {ctt_id}, содержащий данные о каждом контакте) |
5. | /orgs/{orgOid}/ctts/{ctt_id} | Сведения об отдельной записи в перечне контактов организации | Контактные данные: <type> - тип записи, может иметь значения: - "OPH" - телефон; - "OFX" - факс; - "OEM" - электронная почта. <vrfStu> - сведения о "подтвержденности" контактов, может иметь значения: - "NOT_VERIFIED" - не подтвержден; - "VERIFIED" - подтвержден. <value> - значение контакта |
6. | /orgs/{orgOid}/addrs | Перечень адресов организации | Перечень адресов организации (в виде ссылок на ресурс с указанием {addr_id}, содержащий данные о каждом адресе) |
7. | /otg/{orgOid}/addrs/{addr_id} | Сведения об отдельной записи в перечне адресов организации | Контактные данные: <type> - тип записи, может иметь значения: - "OLG" - юридический адрес; - "OPS" - фактический адрес; <zipCode> - индекс; <countryId> - идентификатор страны; <addressStr> - адрес в виде строки (не включая дом, строение, корпус, номер квартиры); <building> - строение; <frame> - корпус; <house> - дом; <flat> - квартира; <fiasCode> - код ФИАС; <region> - регион; <city> - город; <district> - внутригородской район; <area> - район; <settlement> - поселение; <additionArea> - доп. территория; <additionAreaStreet> - улица на доп. территории; <street> - улица. |
8. | /orgs/{orgOid}/vhls | Перечень транспортных средств | Перечень транспортных средств, которыми владеет данная организация |
9. | orgs/{orgOid}/vhls ?embed=(vehicles) | Перечень транспортных средств с данными о каждом транспортном средстве | Перечень транспортных средств, которыми владеет данная организация, содержащий информацию о каждом транспортном средстве |
orgs/{orgOid}/vhls ?embed=(elements-1) | |||
10. | /orgs/{orgOid}/vhls/{vhl-id} | Транспортное средство организации | <name> - имя автомобиля (например, марка или другое пользовательское описание); <numberPlate> - государственный регистрационный знак; <regCertificate> - данные свидетельства о государственной регистрации, включает в себя атрибуты: - <series> - серия свидетельства; - <number> - номер свидетельства. |
{
"stateFacts": ["Identifiable"],
"shortName": "Банк"
}
{
"stateFacts": ["hasSize"],
"elements": [
{
"stateFacts": ["Identifiable"],
"id": 62,
"type": "OLG",
"region": "Москва Город",
"addressStr": "Москва Город, Ангарская улица",
"countryId": "RUS",
"zipCode": "125635",
"street": "Ангарская улица",
"house": "10",
"flat": "96"
}
],
"size": 1
}
{
"stateFacts": ["Paginated"],
"size": 5,
"pageSize": 5,
"pageIndex": 2,
"totalSize": 12,
"eTag": "E6DAE96DADE1CA29F5C50979BBB7C8BF4422FD62",
"elements": [{
"stateFacts": ["Identifiable"],
"id": 6590,
"name": "TOYOTA",
"numberPlate": "А111АА136",
"regCertificate": {"series": "1234","number": "123456"},
"eTag": "F69EEA8910E298E97C8E6249A130A7195DFE7F1A"},
.............
}
GET categories/orgs/1000364913 HTTP/1.1\r\n Authorization: Bearer eyJ2ZXIiOjEsInR5cCI6IkpXVCIsInNidCI6ImFjY2VzcyIsImFsZyI6IkdPU1QzNDEwXzIwMTJfMjU2In0.eyJuYmYiOjE1OTk 1NTQ1MDEsInNjb3BlIjoib3BlbmlkIGNhdGVnb3JpZXM_b2lkPTEwMDAzNjQ5MTMiLCJpc3MiOiJodHRwOlwvXC9lc2lhLmdvc3 VzbHVnaS5ydVwvIiwidXJuOmVzaWE6c2lkIjoiMWQ0OWQ5ZGMzY2FiZThhMjJjNDRhODdlODMyNzMzMDRlOWI1YjE1ODJkNTlkN 2E2N2VhZGJjODg5OWM5MjBjZSIsInVybjplc2lhOnNial9pZCI6MTAwMDM2NjU4NywiZXhwIjoxNTk5NTU4MTAxLCJpYXQiOjE1 OTk1NTQ1MDEsImNsaWVudF9pZCI6IlJBX1RPT0wifQ.eBzsv8_x6DG5kP- D1Jx2ODUkYJlC71m6aCOum7Q6ufrnu110JrBs9HF1_iO_2GovSnfHH8VZ2U4RkF8wGR3_nA\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
N | URI запрашиваемого ресурса | Описание ресурса | Предоставляемые данные |
1. | /categories/orgs/{orgOid} | Данные о категориях организации с идентификатором {orgOid} | Данные о категориях организации: <stateFacts> - параметр, указывающий на факты о предоставляемых сведениях (постраничный список, имеет размер и т.п.); <size> - кол-во категорий в коллекции; <pageSize> - параметр пагинации (размер страницы - количество элементов на странице); <pageIndex> - параметр пагинации (номер страницы); <elements> - массив, содержащий информацию о категориях: <parentName> - наименование родительской категории; <parentId> - идентификатор родительской категории; <catName> - наименование категории; <catId> - идентификатор категории; <catConfirm> - признак того, что категория является подтверждаемой (N - категория не подтверждаемая, Y - категория является подтверждаемой); <status> - статус подтверждения категории. OK - Категория присвоена и содержится в справочнике ЕСНСИ и в ЕСИА; <confirmDate> - дата и время подтверждения категории в формате timestamp; <confirmOrgName> - наименование организации, подтверждающей категорию (указывается только для подтверждаемых категорий (catConfirm=Y)); <confirmOrgOid> - OID организации в ЕСИА, которая подтверждает данную категорию (указывается только для подтверждаемых категорий (catConfirm=Y)); <confirmOrgValueType> - тип идентификатора организации, которая подтверждает данную категорию (указывается только для подтверждаемых категорий (catConfirm=Y)). Может принимать следующие значения: - OGRN; <confirmOrgVal> - значение идентификатора организации, которая подтверждает данную категорию (указывается только для подтверждаемых категорий (catConfirm=Y)). |
{
"stateFacts": [
"Paginated",
"FirstPage"
],
"size": 4,
"pageSize": 100,
"pageIndex": 1,
"elements": [
{
"parentName": "Тестовая родительская категория 1",
"parentId": "1",
"catName": "Категория 1",
"catId": "109",
"catConfirm": "N",
"status": "OK",
"confirmDate": 1594760400000
},
{
"parentName": "Тестовая родительская категория 2",
"parentId": "2",
"catName": "Иные организации",
"catId": "24",
"catConfirm": "N",
"status": "OK",
"confirmDate": 1593637200000
},
{
"parentName": "Тестовая родительская категория 2",
"parentId": "2",
"catName": "Банки (Банковские кредитные организации)",
"catId": "6",
"catConfirm": "Y",
"confirmOrgName": "Федеральная налоговая служба",
"confirmOrgOid": 1000298999,
"confirmOrgValueType": "OGRN",
"confirmOrgVal": "1047707030513",
"status": "OK",
"confirmDate": 1593464400000
},
{
"parentName": "Тестовая родительская категория 2",
"parentId": "2",
"catName": "Категория 2",
"catId": "67",
"catConfirm": "Y",
"confirmOrgName": "Федеральная налоговая служба",
"confirmOrgOid": 1000298999,
"confirmOrgValueType": "OGRN",
"confirmOrgVal": "1047707030513",
"status": "OK",
"confirmDate": 1593637200000
}
]
}
GET /rs/orgs/1000000000/emps HTTP/1.1\r\n Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
N | URI запрашиваемого ресурса | Описание ресурса | Предоставляемые данные |
1. | /orgs/{orgOid}/emps | Перечень сотрудников организации | Перечень сотрудников данной организации (в виде ссылок на ресурс с указанием {prn_oid}, содержащий данные о каждом сотруднике). При наличии филиалов у организации, при запросе будет возвращаться перечень сотрудников только головной организации. |
2. | /orgs/{orgOid}/emps/{prn_oid} | Данные о сотруднике организации с идентификатором {prn_oid} | Данные о сотруднике: <position> - должность; <chief> - сведения о том, является ли сотрудник руководителем организации (в этом случае имеет значение "true") или нет ("false"); <orgOid> - идентификатор организации, сотрудником которой является пользователь; <brhOid> - идентификатор филиала организации, сотрудником которой является пользователь (если сотрудник присоединен к филиалу); <blocked> - признак блокировки сотрудника (имеет значение "true" или "false"). |
https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000001/emps?brhOid=1004082214
{
"stateFacts": ["hasSize"],
"elements":[
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/222896320",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/240612402",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/243280304",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/243280305",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/243280312",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/1000000008",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/1000000009",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/1000000385"
],
"size":"8"
}
{
"stateFacts": ["Paginated", "FirstPage", "LastPage"],
"elements": [
{
"stateFacts": ["Identifiable"],
"prnOid": 1000000125,
"orgOid": 100000,
"chief": false,
"corporateContact": "mail@example.com",
"person": {
"stateFacts": ["Identifiable"],
"firstName": "Петр",
"lastName": "Петров",
"middleName": "Петрович",
"gender": "M",
"updatedOn": 1387519441
}
},
{
"stateFacts": ["Identifiable"],
"prnOid": 1000004892,
"orgOid": 100000,
"position": "Руководитель",
"chief": true,
"person": {
"stateFacts": ["Identifiable"],
"firstName": "Иван",
"lastName": "Иванов",
"middleName": "Иванович",
"gender": "M",
"updatedOn": 1387466948
}
}
],
"pageSize": 100,
"pageIndex": 1
}
GET /rs/orgs/1000000000/grps HTTP/1.1\r\n Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
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 - указывающих на мнемонику имеющихся в рамках данной организации групп) |
http://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000224/emps/1000000105/grps/ORG_ADMIN/ESIA
{
"stateFacts": [
"Identifiable"
],
"grp_id": "ORG_ADMIN",
"name": "Администраторы профиля организации",
"description": "Сотрудники организации, имеющие право приглашать сотрудников, а также включать
сотрудников в группы доступа",
"system": "true",
"itSystem": "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
{
"stateFacts": [
"Identifiable"
],
"eTag": "4C50511FD3F404974C9AC8AB9C15683378DC05F8" *,
"oid": 1000000001,
"shortName": "Тестовая организация",
"fullName": " Тестовая организация ",
"type": "LEGAL",
"ogrn": "1047702026701",
"inn": "0000000000",
"leg": "65142"
}
POST /rs/orgs/1000000001 HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer
eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0.HeKYMBlwx4LAE-dEnAw9cDLrky-
g5133Q827J-pOiNC6Zct-KrZerA3AE6MTaHMicgqJrJls4LBg
Content-Type: application/json
If-Match: "DC48A40EEEE25605ED940193398AF417EE752055"
Cache-Control: no-cache
{"eTag": "DC48A40EEEE25605ED940193398AF417EE752055",
"leg": "65142"}
POST /rs/orgs/1000000001/ctts HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer
eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0.HeKYMBlwx4LAE-dEnAw9cDLrky-
g5133Q827J-pOiNC6Zct-KrZerA3AE6MTaHMicgqJrJls4LBg
Content-Type: application/json
If-Match: "DC48A40EEEE25605ED940193398AF417EE752055"
Cache-Control: no-cache
{"type": "OEM",
"value": "test@test.com"}
POST /rs/orgs/1000000001/ctts/58099 HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer
eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0.HeKYMBlwx4LAE-dEnAw9cDLrky-
g5133Q827J-pOiNC6Zct-KrZerA3AE6MTaHMicgqJrJls4LBg
Content-Type: application/json
If-Match: "011EAB0AB1B69D4178158841E8096AE5DD9A233C "
Cache-Control: no-cache
{ "eTag": "011EAB0AB1B69D4178158841E8096AE5DD9A233C",
"type": "OPH",
"value": "+7(999)9999888" }
DELETE /rs/orgs/1000000001/ctts/58099 HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0.HeKYMBlwx4LAE-dEnAw9cDLrky- g5133Q827J-pOiNC6Zct-KrZerA3AE6MTaHMicgqJrJls4LBg Content-Type: application/json If-Match: "DC48A40EEEE25605ED940193398AF417EE752055" Cache-Control: no-cache
POST /rs/orgs/1000000001/addrs HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0
Content-Type: application/json
If-Match: "DE3372D5A4E2499C38C24E03C1919C9CA97FCF78"
Cache-Control: no-cache
{
"type": "OPS",
"region": "Псковская Область",
"fiasCode": "5bf5ddff-6353-4a3d-80c4-6fb27f00c6c1",
"addressStr": "Псковская область, Невельский район, Невель город, Невель 1 поселок и(при)
станция(и)",
"city": "Невель Город",
"area": "Невельский Район",
"countryId": "RUS",
"zipCode": "182500",
"street": "Невель 1 Поселок и(при) станция(и)",
"house": "5",
"flat": "5"
}
DELETE /rs/orgs/1000000001/addrs/13854 HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0 Content-Type: application/json If-Match: "DE3372D5A4E2499C38C24E03C1919C9CA97FCF78" Cache-Control: no-cache
POST /rs/orgs/1000000001/vhls HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc
Content-Type: application/json
If-Match: "3FEA16CB36AFC793234553C1C7CAAF89CD79A32D"
{
"name": "ВАЗ",
"numberPlate": "А133ОН199",
"regCertificate":{
"series": "1234",
"number": "123456"
}
}
POST /rs/orgs/1000000001/vhls/1000037688 HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc
If-Match: "3FEA16CB36AFC793234553C1C7CAAF89CD79A32D"
{
"eTag": "3FEA16CB36AFC793234553C1C7CAAF89CD79A32D",
"name": "Новый ВАЗ",
"numberPlate": "А144ОН199",
"regCertificate":{
"series": "1234",
"number": "123456"
}
}
DELETE /rs/orgs/1000000001/vhls/1000037688 HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc Content-Type: application/json If-Match: "F040CD4DD62478E6843177FF33BB6BA1AF8ECF8F" Cache-Control: no-cache
GET /rs/orgs/1000000001/invts HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc
{
"stateFacts": [
"LastPage",
"Paginated",
"FirstPage"
],
"pageSize": 10,
"pageIndex": 1,
"elements": [
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000001/invts/671621",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000001/invts/671620",
"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000001/invts/671600"
]
}
{
"stateFacts": [
"Identifiable"
],
"eTag": "E4EFE25E314136A0EB0DC4EB68DF4B5C185D3E4E",
"invtId": 671600,
"email": "test@mail.ru",
"firstName": "Иван",
"lastName": "Иванов",
"middleName": "Владимирович",
"status": "A",
"createdOn": "23.10.2015",
"groups": [
"ORG_ADMIN"
]
}
PUT /rs/orgs/1000000001/invts HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer
eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0eyJleHAiOjE0NDYyMTU2ND
Content-Type: application/json
Cache-Control: no-cache
{
"email": "test@yandex.ru",
"snils": "000-333-333 66",
"firstName": "Михаил",
"lastName": "Иванов",
"middleName": "Иванович"
}
DELETE /rs/orgs/1000000001/invts/671774 HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0eyJleHAiOjE0NDYyMTU2ND Content-Type: application/json Cache-Control: no-cache
POST /rs/orgs/1000000001/emps/1000000128 HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer
eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0eyJleHAiOjE0NDYyMTU2ND
Content-Type: application/json
If-Match: "523E509CBEB781E992EFC503CBC878AC67BAD414"
Cache-Control: no-cache
{
"eTag": "523E509CBEB781E992EFC503CBC878AC67BAD414",
"position": "должность",
"corporateContact": "test@example3.com",
"blocked": false
}
DELETE /rs/orgs/1000000001/emps/1000000128 HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc Content-Type: application/json
https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000001/emps/{emp_id}/grps/{grp_id}/{it_sys_id}
PUT /rs/orgs/1000000001/emps/1000023747/grps/ORG_ADMIN/ESIA HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc
DELETE /rs/orgs/1000000001/emps/1000023747/grps/ORG_ADMIN/ESIA HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc
GET /rs/orgs/1000000001/emps/1000023747/grps/RA.USR_CFM/perms?embed=(elements) HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc Cache-Control: no-cache
{
"stateFacts": [
"hasSize"
],
"size": 4,
"elements": [
{
"stateFacts": [
"Identifiable"
],
"permId": 732,
"ogrn": "1047707030513"
},
{
"stateFacts": [
"Identifiable"
],
"permId": 21,
"ogrn": "1023101651154"
},
{
"stateFacts": [
"Identifiable"
],
"permId": 104,
"ogrn": "1027700367507"
},
{
"stateFacts": [
"Identifiable"
],
"permId": 107,
"ogrn": "1027802761282"
}
]
}
POST /rs/orgs/1000000001/grps/RA.USR_CFM/perms/ HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc
Content-Type: application/json
Cache-Control: no-cache
{ "ogrn": "1047796940465",
"rqCfm": false }
DELETE/rs/orgs/1000000001/grps/RA.USR_CFM/perms/1103 HTTP/1.1 Host: esia-portal1.test.gosuslugi.ru Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc Cache-Control: no-cache
POST /rs/orgs/1000000001/brhs HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc
Content-Type: application/json
If-Match: "3FEA16CB36AFC793234553C1C7CAAF89CD79A32D"
{ "name": "Филиал КПП 111111112",
"kpp": "111111112" }
POST /rs/orgs/1000000001/brhs/1004083064 HTTP/1.1
Host: esia-portal1.test.gosuslugi.ru
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlc
If-Match: "3FEA16CB36AFC793234553C1C7CAAF89CD79A32D"
{ "name": "Новый филиал",
"kpp": "111111113" }
GET /rs/prns?updatedSince=1384218061 HTTP/1.1\r\n Authorization: Bearer 75b2c7cbb8da403491c224c9e431cef9\r\n Host: esia-portal1.test.gosuslugi.ru\r\n Accept: */*\r\n \r\n
N | Наименование параметра | Описание параметра | Обязательность параметра | Примечания |
1. | firstName | Имя | Y | Текстовая строка, содержащая не более 60 символов. |
2. | lastName | Фамилия | Y | Текстовая строка, содержащая не более 60 символов. |
3. | middleName | Отчество | Y | Текстовая строка, содержащая не более 60 символов. Необязательно, в случае если отчество отсутствует в паспорте. |
4. | birthDate | Дата рождения | Y | Формат: ДД.ММ.ГГГГ |
5. | birthPlace | Место рождения | N | Текстовая строка, содержащая не более 700 символов. |
6. | citizenship | Гражданство по классификатору ОКСМ | N/Y | Используется трехбуквенный код страны, например, для России он должен принимать значение RUS. По умолчанию принимается значение "RUS". Обязателен в случае, если указанный документ отличен от паспорта РФ. |
7. | gender | Пол | Y | Перечень допустимых значений: - "M" - мужской; - "F" - женский. |
8. | snils | СНИЛС | Y | Формат: "XXX-XXX-XXX XX" |
9. | контакт | Y | ||
9.1. | type | Тип контакта | Y | Перечень допустимых значений: - "MBT" - мобильный телефон (обязательный параметр); - "EML" - электронная почта (необязательный параметр). |
9.2. | value | Значение | Y | Формат: - "+X(XXX)XXXXXXX" (для type = "MBT"); - текстовая строка в формате адреса электронной почты (для type = "EML"). |
10. | документ | Y | ||
10.1. | type | Тип документа | Y | Перечень допустимых значений: - "RF_PASSPORT" - паспорт гражданина РФ; - "FID_DOC" - документ иностранного гражданина, удостоверяющий личность на территории РФ; - "FRGN_PASS" - заграничный паспорт гражданина РФ. |
10.2. | series | серия | Y/N | Для паспорта гражданина РФ в формате XXXX. Для заграничного паспорта гражданина РФ в формате XX. Необязательный для документа иностранного гражданина. |
10.3. | number | номер | Y | Для паспорта гражданина РФ в формате XXXXXX. Для заграничного паспорта гражданина РФ в формате XXXXXXX. |
10.4. | latinLastName | Фамилия (латиницей) | Y/N | Только для заграничного паспорта гражданина РФ. Текстовая строка, содержащая не более 60 символов. |
10.5. | latinFirstName | Имя (латиницей) | Y/N | Только для заграничного паспорта гражданина РФ. Текстовая строка, содержащая не более 60 символов. |
10.6. | issueId | Номер подразделения, выдавшего паспорт | Y/N | Только для паспорта гражданина РФ. Необязательный для документа иностранного гражданина и заграничного паспорта гражданина РФ. Строка, 6 символов. |
10.7. | issuedBy | Наименование подразделения, выдавшего паспорт | Y/N | Только для паспорта гражданина РФ. Необязательно для документа иностранного гражданина и заграничного паспорта гражданина РФ. Текстовая строка, содержащая не более 233 символа. |
10.8. | issueDate | Дата выдачи паспорта | Y | Формат: ДД.ММ.ГГГГ |
10.9. | expireDate | Дата окончания срока действия документа | Y/N | Только для заграничного паспорта гражданина РФ. Формат: ДД.ММ.ГГГГ |
11. | адрес | N | ||
11.1. | type | Тип адреса | Y | Перечень допустимых значений: - "PLV" - адрес проживания; - "PRG" - адрес регистрации. |
11.2. | addressStr | Адресная строка | Y | Текстовая строка, содержащая элементы адреса (перечисляются через разделитель ",", не более 2000 символов) |
11.3. | countryId | Трехбуквенный код страны | N | В формате XXX. |
11.4. | zipCode | Индекс | N | Текстовая строка, содержащая не более 256 символов. |
11.5. | region | Область | N | Текстовая строка, содержащая не более 256 символов. |
11.6. | area | Район | N | Текстовая строка, содержащая не более 256 символов. |
11.7. | city | Город | N | Текстовая строка, содержащая не более 256 символов. |
11.8. | district | Округ | N | Текстовая строка, содержащая не более 256 символов. |
11.9. | settlement | Населенный пункт | N | Текстовая строка, содержащая не более 256 символов. |
11.10. | street | Улица | N | Текстовая строка, содержащая не более 256 символов. |
11.11. | additionArea | Уточнение по региону проживания | N | Текстовая строка, содержащая не более 256 символов. |
11.12. | additionAreaStreet | Уточнение по улице | N | Текстовая строка, содержащая не более 256 символов. |
11.13. | house | Дом | N | Текстовая строка, содержащая не более 256 символов. |
11.14. | building | Строение | N | Текстовая строка, содержащая не более 256 символов. |
11.15. | frame | Корпус | N | Текстовая строка, содержащая не более 256 символов. |
11.16. | flat | Квартира | N | Текстовая строка, содержащая не более 256 символов. |
11.17. | fiasCode | Код ФИАС | N | Формат: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" |
POST https://esia.gosuslugi.ru/esia-rs/api/public/v2/prns/import HTTP/1.1 Accept-Encoding: gzip,deflate Content-Type: application/json Authorization: Bearer eyJ2ZXIiOjEsInR5cCI6IkpXVCIsInNidCI6ImFjY2VzcyIsImFsZyI6IlJTMjU2In0.eyJuYmYiOjE1OTYwMjI3NDM sInNjb3BlIjoiaHR0cDpcL1wvZXNpYS5nb3N1c2x1Z2kucnVcL2V4dF9pbXAiLCJpc3MiOiJodHRwOlwvXC9lc2lhLm dvc3VzbHVnaS5ydVwvIiwidXJuOmVzaWE6c2lkIjoiY2NjYTExZWUwOGY1MDM4NzE2NzY2ODMyNDdjNzU3ODAwNTFmO DRhNGExMWQxMDY5YTEwNmIzNjUyZjgxNjUxNSIsInVybjplc2lhOnNial9pZCI6MTA3NzExNDA1NCwiZXhwIjoxNTk2 MDI0NTQzLCJpYXQiOjE1OTYwMjI3NDMsImNsaWVudF9pZCI6IlRFU1RfU1lTIn0.ZG4e0Hs_hHwubfYLc94ph1bPaof 3opfeLjw8GczXfI- CKD683KFvPE_mqGo0WjgtarM4Cd1zRU_FitqXQl4DsmZW94aVHjfyS6ti4ERtEwby3ifQfY_8qefnzIpZ2EtlAbGNaj 7jWpdJlhKQcigBKi_60eOinrUYwcEy1EdnRKIHDyrrydfh- MN3ZQSEx8aMYMm3IATPrktJPZ8LryD2wlkWq3PuxFAxFLEaLo0r- F8FRU1hPlNyUrTCRp6vNmlLO_TVe2l28gRdcxZJKAdHggXmRXVceT7cMGUOY4b2VnTID3G_w7FuVIjURQZy46HQ3X5t H9IiGfoqi2dhD5y3AQ Request-Data-Sign: MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwEAAKCAMIIDJTCCAg0CBFhKg5U wDQYJKoZIhvcNAQELBQAwVzELMAkGA1UEBhMCUlUxDzANBgNVBAgMBk1vc2NvdzENMAsGA1UECgwEVGVzdDENMAsGA1 UECwwEVGVzdDEZMBcGA1UEAwwQVGVzdCBSZXN0IFN5c3RlbTAeFw0xNjEyMDkxMDEyMzdaFw0xNzEyMDkxMDEyMzdaM FcxCzAJBgNVBAYTAlJVMQ8wDQYDVQQIDAZNb3Njb3cxDTALBgNVBAoMBFRlc3QxDTALBgNVBAsMBFRlc3QxGTAXBgNV BAMMEFRlc3QgUmVzdCBTeXN0ZW0wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCByEsM2_R1BrtltyJ15Aw CW_tChh2euZC3FEqWDY6TFAlVyy9yO4qM_5P1WruplhA9dCCbft5JFsz4n_nE7lMMRaI34tqTyyo24xzX_VrhgTIi05 mt1Y5dbldfEiPVNT3aUCjFlbFzDXoUbc8nfQizkPa_CHGO0MBhuVuQWOVzw3FufAlExDjNPUoRRvaYoBWOK_3SnyS7_ 88xJn-_yQQVwu0TQkSuqpOsylfBM- Wq10U5x4bJ2NSeL71AzZjCL_mh1daQTQxEwBlVLuMlc5srMyw_QHQ1McsNrqrnx3zhFFNLS5Sk_LrSxqxOsC4sgBw1o udVayUUvGbqe_nxu7P3AgMBAAEwDQYJKoZIhvcNAQELBQADggEBABxK0C1NjQMyvtJvZNRyM21GwQOklaBZuqRErJmp LAR7auYLbZnwEdt1I8KEJBQW6pTb99rnQs-T- qZiChh0PYlbCxXGeVCXk5dJWSiGE_SdrjWvSOH83iUA2Lv8Pi3NlVW2GcNOlFySlzE9HvGYJTIr5I_X-dw64- 2NYETLIYPQ7HWwAEwy09ucL9LMjGKYBe5FrwiulAyD20-lnIpYtXdLSpflKangPlPd1xmxEBXMQUmoKg7dTE- q2gYfZLNUKsAezrattHGHTPRnqwWQHmwly_rXXodlgcNxeilT_dvc0o_JfkNmqGCc09RXSx1BWSWGynLeBBjYMy9VN8 XYQpQAADGCAfUwggHxAgEBMF8wVzELMAkGA1UEBhMCUlUxDzANBgNVBAgMBk1vc2NvdzENMAsGA1UECgwEVGVzdDENM AsGA1UECwwEVGVzdDEZMBcGA1UEAwwQVGVzdCBSZXN0IFN5c3RlbQIEWEqDlTANBglghkgBZQMEAgEFAKBpMBgGCSqG SIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTE3MDYyMDE1NTA1NVowLwYJKoZIhvcNAQkEMSIEIOp wKJnoLommyNRoKDDlWVsWuBdYfowQ4byOiN- gSPe2MA0GCSqGSIb3DQEBAQUABIIBADlNWxdZeqGBq8_4WqRs9H4SLde_Sukc1AG6hNj1cbTqxzthzzm1n_JQEZOTYa P9bQdTEhOvKZXxFXC_JjPBMQauZPJc1eOR5DDB_7X4MAgGpMQbhpTQz3Sg7acJuJdWuYxL92BDk4qyzuwgJdQJplVJi ckBvC78XeJVo1w4_jx5CVEn3pUIPdKxib6da0evB6CsxD98JcsvWZ3u- H3LQ0_ApUOUHeF84r3AZ5mtILYj2w6o8rMAmsTDe7CAUXvDUAp9o5cTPk57rDNaW96d5J3SUtmZdx2nGBS41kJYWJND iqyfHJ7X4nZVOS0glbT_JnaXtxrZTWp9BJo6NKJaagQAAAAAAAA Request-Data: ew0KICAiZmlyc3ROYW1lIjoiw5DCmMOQwrLDkMKww5DCvcOQwr7DkMKyIiwNCiAgImxhc3ROYW1lIjoiw5DCmMOQwrL DkMKww5DCvSIsDQogICJtaWRkbGVOYW1lIjoiw5DCmMOQwrLDkMKww5DCvcOQwr7DkMKyw5DCuMORwociLA0KICAiYm lydGhEYXRlIjoiMDEuMDEuMTk5OSIsDQogICJiaXJ0aFBsYWNlIjoiw5DCnMOQwr7DkcKBw5DCusOQwrLDkMKwIiwNC iAgImdlbmRlciI6Ik0iLA0KICAic25pbHMiOiIwMDAtMDAwLTAwMCAwNyIsDQogICJjb250YWN0cyI6IHsNCiAgICAi ZWxlbWVudHMiOiBbDQogICAgICB7DQogICAgICAgICJ0eXBlIjogIk1CVCIsDQogICAgICAgICJ2YWx1ZSI6ICIrNyg 5OTkpOTk5OTk5OSINCiAgICAgIH0sDQogICAgICB7DQogICAgICAgICJ0eXBlIjogIkVNTCIsDQogICAgICAgICJ2YW x1ZSI6ICJ0ZXN0QHRlc3QudHMiDQogICAgICB9DQogICAgXQ0KICB9LA0KICAiZG9jdW1lbnRzIjogew0KICAgICJlb GVtZW50cyI6IFsNCiAgICAgIHsNCiAgICAgICAgInR5cGUiOiJSRl9QQVNTUE9SVCIsDQogICAgICAgICJzZXJpZXMi OiIyMjIyIiwNCiAgICAgICAgIm51bWJlciI6Ijg4OTk5OSIsDQogICAgICAgICJpc3N1ZUlkIjoiMTExMDAxIiwNCiA gICAgICAgImlzc3VlZEJ5Ijoiw5DCoMOQwqPDkMKSw5DClCDDkMKzLsOQwpzDkMK- w5HCgcOQwrrDkMKyw5HCiyIsDQogICAgICAgICJpc3N1ZURhdGUiOiIxOC4wMy4yMDE2Ig0KICAgICAgfQ0KICAgIF0 NCiAgfSwNCiAgImFkZHJlc3NlcyI6ew0KICAgICJlbGVtZW50cyI6IFsNCiAgICAgIHsNCiAgICAgICJ0eXBlIjogIl BMViIsDQogICAgICAiYWRkcmVzc1N0ciI6IsOQwprDkMK1w5DCvMOQwrXDkcKAw5DCvsOQwrLDkcKBw5DCusOQwrDDk cKPIMOQwp7DkMKxw5DCu8OQwrDDkcKBw5HCgsORwowsIMOQwqLDkMKww5HCiMORwoLDkMKww5DCs8OQwr7DkMK7w5HC jMORwoHDkMK6w5DCuMOQwrkgw5DCoMOQwrDDkMK5w5DCvsOQwr0sIMOQwqjDkMK1w5HCgMOQwrXDkMKzw5DCtcORwog gw5DCn8OQwr7DkcKBw5DCtcOQwrvDkMK-w5DCuiDDkMKzw5DCvsORwoDDkMK- w5DCtMORwoHDkMK6w5DCvsOQwrPDkMK- ICAgICDDkcKCw5DCuMOQwr_DkMKwIiwNCiAgICAgICJjb3VudHJ5SWQiOiAiUlVTIiwNCiAgICAgICJ6aXBDb2RlIjo gIjM5NDAwMCIsDQogICAgICAicmVnaW9uIjogIsOQwprDkMK1w5DCvMOQwrXDkcKAw5DCvsOQwrLDkcKBw5DCusOQwr DDkcKPIMOQwp7DkMKxw5DCu8OQwrDDkcKBw5HCgsORwowiLA0KICAgICAgImFyZWEiOiAiw5DCosOQwrDDkcKIw5HCg sOQwrDDkMKzw5DCvsOQwrvDkcKMw5HCgcOQwrrDkMK4w5DCuSDDkMKgw5DCsMOQwrnDkMK- w5DCvSIsDQogICAgICAiY2l0eSI6ICLDkMKow5DCtcORwoDDkMK1w5DCs8OQwrXDkcKIIMOQwp_DkMK- w5HCgcOQwrXDkMK7w5DCvsOQwrogw5DCs8OQwr7DkcKAw5DCvsOQwrTDkcKBw5DCusOQwr7DkMKzw5DCviDDkcKCw5D CuMOQwr_DkMKwIiwNCiAgICAgICJkaXN0cmljdCI6ICLDkMK9w5DCtcORwoIiLA0KICAgICAgInNldHRsZW1lbnQiOi Aiw5DCo8ORwoHDkcKCw5HCjC3DkMKQw5DCvcOQwrfDkMKww5HCgSDDkMKfw5DCvsORwoHDkMK1w5DCu8OQwr7DkMK6I iwNCiAgICAgICJzdHJlZXQiOiAiw5DCocOQwr7DkMKyw5DCtcORwoLDkcKBw5DCusOQwrDDkcKPIMOQwqPDkMK7w5DC uMORwobDkMKwIiwNCiAgICAgICJhZGRpdGlvbkFyZWEiOiAiw5DCoMOQwrXDkMKzw5DCuMOQwr7DkMK9IMOQwqHDkMK ww5DCtMOQwr7DkMKyw5DCvsOQwrUgw5DCvcOQwrXDkMK6w5DCvsOQwrwtw5DCtSDDkcKCw5DCvsOQwrLDkMKww5HCgM OQwrjDkcKJw5DCtcORwoHDkcKCw5DCssOQwr4iLA0KICAgICAgImFkZGl0aW9uQXJlYVN0cmVldCI6ICLDkMKiw5DCt cORwoHDkcKCIiwNCiAgICAgICJob3VzZSI6ICI4Ni8xIiwNCiAgICAgICJidWlsZGluZyI6ICJlIiwNCiAgICAgICJm cmFtZSI6ICIyMDTDkcKDIiwNCiAgICAgICJmbGF0IjogIsOQwr_DkMK- w5DCvC40MTkiLA0KICAgICAgImZpYXNDb2RlIjogIjc3LTAtMDAwLTAwMC0wMDAtMDAwLTQyMzYtMDAwMC0wMDAiDQo NCiAgICAgICAgfQ0KICAgICAgfQ0KICAgIF0NCiAgfQ0KfQ Cache-Control: no-cache Content-Length: 1476 Host: esia-portal1.test.gosuslugi.ru Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5)
{
"firstName":"Иванов",
"lastName":"Иван",
"middleName":"Иванович",
"birthDate":"01.01.1999",
"birthPlace":"Москва",
"gender":"M",
"snils":"000-000-000 07",
"contacts": {
"elements": [
{
"type": "MBT",
"value": "+7(999)9999999"
},
{
"type": "EML",
"value": "test@test.ts"
}
]
},
"documents": {
"elements": [
{
"type":"RF_PASSPORT",
"series":"2222",
"number":"889999",
"issueId":"111001",
"issuedBy":"РУВД г.Москвы",
"issueDate":"18.03.2016"
}
]
},
"addresses":{
"elements": [
{
"type": "PLV",
"addressStr": "Кемеровская область, Таштагольский район, Шерегеш поселок городского
типа, Усть-Анзас поселок, Советская улица",
"countryId": "RUS",
"zipCode": "652975",
"region": "Кемеровская Область",
"area": "Таштагольский Район",
"city": "Шерегеш Поселок городского типа",
"settlement": "Усть-Анзас Поселок",
"house": "Дом 19",
"fiasCode": "5bf5ddff-6353-4a3d-80c4-6fb27f00c6c1"
}
]
}
}
N | Наименование параметра | Описание параметра | Примечания |
1. | requestId | Код заявки на регистрацию | Возвращается в случае создания заявки на регистрацию. |
2. | code | Код завершения операции | Может быть возвращен в виде значений: - 0 или 1 - выполнен импорт учетной записи; - 2 - создана заявка на импорт (регистрацию) учетной записи; - 3 - создана заявка на импорт (подтверждение) учетной записи; - код ошибки, варианты приведены в Таблице 12. |
3. | description | Текстовое описание кода завершения операции | Описание для кодов успешного импорта учетной записи в ЕСИА (code = 0, 1 или 2) и для code = ESIA-03200. |
4. | message | Текстовое описание кода ошибки выполнения операции | Описание для кодов ошибок при импорте учетной записи в ЕСИА (за исключением кода ESIA-03200) Варианты ошибок приведены в Таблица 12 |
HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 21 Apr 2016 13:43:37 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: Servlet/3.0 JSP/2.2
{"code":"0", "description":"Person already has trusted account in ESIA"}
HTTP/1.1 400 Bad Request
Server: nginx/1.4.6 (Ubuntu)
Date: Mon, 26 Apr 2021 06:54:13 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: Servlet/3.0 JSP/2.2
{"code":"ESIA-033102", "message": "Номер паспорта должен состоять из 6 цифр"}
HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 21 Apr 2016 13:43:37 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: Servlet/3.0 JSP/2.2
{"code":"1", "description":"Person already has trusted account in ESIA"}
HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 21 Apr 2016 13:43:37 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: Servlet/3.0 JSP/2.2
{"code":"1", "description":"Person successfully reconfirmed as trusted in ESIA"}
HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 21 Apr 2016 13:43:37 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: Servlet/3.0 JSP/2.2
{"requestId":"AAAAF3A1379F965664CB56FCE55BD8CCA2F38368985607E75E23", "code":"2",
"description":"Request to register person as trusted in ESIA has been accepted
successfully."}
HTTP/1.1 200 OK
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 21 Apr 2016 13:43:37 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: Servlet/3.0 JSP/2.2
{"requestId":"AAAAF3A1379F965664CB56FCE55BD8CCA2F38368985607E75E23", "code":"3",
"description":"Request to conform simplified person as trusted in ESIA has been accepted
successfully."}
HTTP/1.1 400 Bad Request
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 21 Apr 2016 13:43:37 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: Servlet/3.0 JSP/2.2
{"code":"ESIA-03200", "description":"Import account error. Person have to check entered
data or fill in the data in his account in ESIA."}
N | Код возврата | Описание кода возврата | Комментарии |
1. | ESIA-000001 | Внутренняя ошибка | Данный код возврата соответствует ситуации, когда обнаружена неизвестная ошибка |
2. | ESIA-005029 | Scope is not allowed | У системы, осуществляющей запрос к сервису импорта, отсутствует разрешение на доступ к скоупу ext_imp (например, указанный в запросе маркер доступа не дает право доступа к скоупу ext_imp) |
3. | ESIA-030002 | Заполните поле | Одно из полей "Фамилия", "Имя", "Отчество" пришло с пустым значением |
4. | ESIA-030003 | Неверно указаны параметры запроса | |
5. | ESIA-030007 | Недопустимые символы в полях запроса | Поля запроса содержат недопустимые символы "<", ">" или "&" |
6. | ESIA-030504 | Сертификат электронной подписи имеет некорректную структуру. Обратитесь в удостоверяющий центр | |
7. | ESIA-03200 | Возможно, что пользователь зарегистрирован, необходимо проверить введенные данные паспорта (серию, номер, дату выдачи) или заполнить их в ЕСИА | Необходимо скорректировать данные пользователя в параметрах запроса (серию, номер, дату выдачи) или параметры учетной записи в ЕСИА |
8. | ESIA-032006 | Указан некорректный тип контакта | |
9. | ESIA-032101 | Указан некорректный адрес электронной почты | |
10. | ESIA-032102 | В структуре адреса электронной почты (в имени и домене) должны отсутствовать точки в начале и конце. Например, mymail.mymail@example.com - верно; mymail.@.example.com - неверно | |
11. | ESIA-032103 | Указан некорректный формат имени для адреса электронной почты. Доступные символы: латинские буквы a - z и A - Z, цифры 0 - 9 и знаки пунктуации (#$%*+-=? |