Апісанне

Авторизация через Госуслуги (ЕСИА)

Модуль добавляет кнопку «Войти через Госуслуги». Пользователи входят через единый аккаунт государственных сервисов.

Что умеет

OAuth 2.0 / OpenID Connect через ЕСИА.
Подписанный client_secret JWT на стороне модуля (RSA-2048).
Тестовый и боевой контуры ЕСИА.
Подтверждённые данные профиля. ФИО, дата рождения, e-mail, телефон, СНИЛС, ИНН, паспорт по запрошенным правам.
Гибкий выбор scope. Включайте только те данные, которые действительно нужны.

Как подключить

Зарегистрируйте Информационную Систему (ИС) на технологическом портале ЕСИА и получите мнемонику (Client ID).
Сгенерируйте ключевую пару RSA-2048: openssl genrsa -out esia.key 2048 && openssl rsa -in esia.key -pubout -out esia.pub.
Передайте публичный ключ оператору ЕСИА (Минцифра) и подождите активации ИС в тестовом контуре.
Скопируйте Client ID, выберите контур (тест / прод), выберите запрашиваемые scope.
Загрузите приватный ключ. На проде безопаснее монтировать ключ как файл (ESIA_PRIVATE_KEY_PATH), а в поле оставлять отметку «ключ смонтирован».

Важно: redirect URL в консоли ЕСИА

В консоли ЕСИА регистрируйте ТОЧНЫЙ redirect URL включая суффикс ?provider=gosuslugi-auth — то есть значение из поля Redirect URI ниже плюс ?provider=gosuslugi-auth. ЕСИА сверяет redirect_uri байт-в-байт на шагах authorize и token: без суффикса запросы будут отвергнуты.

Усе →