Как подключиться к REST API Цифрового профиля

1. Зарегистрируйте организацию в ЕСИА.

Потребуется: 
– подтверждённая учётная запись руководителя;
– квалифицированная электронная подпись (КЭП) руководителя.

Подробнее в Руководстве пользователя ЕСИА

---

2. Добавьте ИС в регистр ЕСИА.

2.1. Настройте доступ для сотрудника:

Руководитель или администратор организации должен добавить ответственного сотрудника в группу доступа «Технологический портал».

2.2. Зарегистрируйте ИС:

Ответственный сотрудник должен зарегистрировать ИС через Технологический портал.

Результат: ИС будет добавлена в регистр систем, взаимодействующих с ЕСИА.

Подробнее в Руководстве пользователя Технологического портала

---

3. Получите криптографические ключи и сертификат КЭП.

• Оформите сертификат ключа КЭП в удостоверяющем центре;
• Убедитесь, что сертификат содержит ОГРН вашей организации

---

4. Загрузите сертификат в Технологический портал.

• Сертификат должен быть зарегистрирован в ЕСИА;
• Сертификат должен быть привязан к учётной записи вашей организации в ЕСИА

---

5. Согласуйте подключение ИС в тестовой среде.

5.1. Отправьте заявку:

• Напишите на адрес sd@sc.digital.gov.ru;

• Укажите в заявке перечень областей доступа (scope), которые вам нужны.

5.2. Получите инструкции:

• После подключения вы получите инструкцию по созданию учётных записей в тестовой среде.

Подробнее в разделе 9 Регламента информационного взаимодействия

---

6. Реализуйте интерфейсы подключения, доработайте дизайн и проведите тестирование

---

7. Получите сертификаты для тестовой и промышленной сред ЕСИА.

Сертификаты доступны по ссылке: http://esia.gosuslugi.ru/public/esia.zip

---

8. Реализуйте интерфейсы REST-сервисов ЕСИА.

• Используйте OAuth 2.0 для интерфейсов ИС REST-сервисов ЕСИА и модели контроля доступа;

• Не отображайте страницу аутентификации ЕСИА во фрейме вашего сайта.

Подробнее в Приложениях Методических рекомендаций по использованию ЕСИА

---

9. Обеспечьте информационную безопасность.

Обеспечьте информационную безопасность и защиту персональных данных пользователей, получаемых ИС в процессе взаимодействия с инфраструктурой ЦП, в соответствии с Федеральным законом от 27 июля 2006 г. № 152-ФЗ «О персональных данных»

---

10. Подключитесь к защищённому каналу СМЭВ.

Направляйте запросы REST API к ЦП через защищённый канал СМЭВ

---

11. Синхронизируйте системное время сервера.

Убедитесь, что время на сервере синхронизировано с точным временем. Расхождение более чем на 1 минуту может вызвать ошибки при работе с ЕСИА

---

12. Подключите ИС к промышленной среде ЕСИА и инфраструктуре ЦП.

• Отправьте заявку на адрес: sd@sc.digital.gov.ru;

• Оператор проверит работоспособность интеграции в тестовой среде.

Подробнее в разделе 10 Регламента информационного взаимодействия

---

13. Проверьте работу промышленной версии.

После подключения ИС к промышленной ЕСИА проверьте, как работает промышленная версия ЕСИА с вашей системой

---

Важно:

На всех этапах используйте актуальные документы и регламенты, указанные в инструкции

---

  Среды для интеграционного тестирования:

Ссылка	Описание	Назначение
https://esia-portal1.test.gosuslugi.ru/	Интеграционная среда ЕСИА и ЦП	Для тестирования аутентификации, REST API платформы согласий и ЦП
https://svcdev-betalk.test.gosuslugi.ru/	Интеграционная среда ЕПГУ. Интегрирована с тестовой средой ЕСИА и ЦП в части аутентификации и данных пользователей	Для просмотра и изменения данных пользователя и управления согласиями через интерфейс личного кабинета на Госуслугах