Виджет для услуги «Получение загранпаспорта гражданина РФ»
Размещение кода встраивания виджета производится типовым для Открытой Платформы Госуслуг способом. Для встраивания виджета на портал необходимо подключить библиотеку виджетов на страницу портала и вызвать javascript-функцию «rooxWidgetStart», указав необходимые параметры запроса.
Параметры функции rooxWidgetStart для виджета
Типовые параметры
Следующие параметры являются общими для виджетов Открытой платформы:
Параметр
|
Обязательность
|
Назначение
|
features_loaded
|
Нет
|
Указывается значение 'org.jquery.core-1.7.2', если на странице уже присутствует библиотека jquery. Если библиотека на странице не используется, то параметр можно не указывать.
|
st: "esia_1.0_"
|
Нет
|
в параметре указать маркер доступа ЕСИА, выданный пользователю (указывается только для renderType: 'inline')
|
rt: "esia_1.0_"
|
Да
|
в параметре указать маркер доступа ЕСИА, выданный на систему
|
Пользовательский и системный токены
При вызове виджетов, портал должен передать в параметры функции rooxWidgetStart пользовательский и системный токен ЕСИА:
Системный токен (маркер доступа ЕСИА, выданный на систему) должен содержать scope http://sf.gosuslugi.ru/sf_api
Пользовательский токен (маркер доступа ЕСИА, выданный пользователю) должен содержать scopе http://sf.gosuslugi.ru/data, а также набор атомарных scope, соответствующие запрашиваемой посредством виджета услуге.
Для услуги, описанной в данной инструкции, требуется следующий набор атомарных scope:
fullname;
birthdate;
gender;
contacts;
id_doc;
foreign_passport_doc;
kid_fullname;
kid_birthdate;
kid_gender;
kid_birth_cert_doc.
Код встраивания виджета для тестового контура (inline)
="https://widget-svcdev.test.gosuslugi.ru/widgets/res/js/embed/addwidget-1.2.5.min.js">
="foreign-passport">
подключение скрипта addwidget, который регистрирует функцию rooxWidgetStart для CSI-встраивания;
скрипт, содержащий функции для авторизации (переписывает метод com.rooxteam.auth.requestAuthentification), код должен добавляться на страницу после загрузки виджета, можно вынести в отдельный файл или вписать внутри кода встраивания;
элемент, в который будет встроен виджет;
путь к дескриптору виджета;
параметры запроса;
параметры авторизации (где – токен, полученный при авторизации пользователя через ЕСИА, – токен, полученный при авторизации системы);
обработка ошибки загрузки (на стороне портала).
Код встраивания виджета для тестового контура (iframe)
="https://widget-svcdev.test.gosuslugi.ru/widgets/res/js/embed/addwidget-1.2.5.min.js">
="foreign-passport">
подключение скрипта addwidget, который регистрирует функцию rooxWidgetStart для CSI-встраивания;
скрипт, содержащий функции для авторизации (переписывает метод com.rooxteam.auth.requestAuthentification), код должен добавляться на страницу после загрузки виджета, можно вынести в отдельный файл или вписать внутри кода встраивания;
элемент, в который будет встроен виджет;
путь к дескриптору виджета;
параметры запроса;
параметры авторизации ( – токен, полученный при авторизации системы);
обработка ошибки загрузки (на стороне портала);
Изменение стилей виджета ( – путь до файла со стилями).
Код встраивания виджета для продуктивного контура (inline)
="https://widget.gosuslugi.ru/widgets/res/js/embed/addwidget-1.2.5.min.js">
="foreign-passport">
подключение скрипта addwidget, который регистрирует функцию rooxWidgetStart для CSI-встраивания;
скрипт, содержащий функции для авторизации (переписывает метод com.rooxteam.auth.requestAuthentification), код должен добавляться на страницу после загрузки виджета, можно вынести в отдельный файл или вписать внутри кода встраивания;
элемент, в который будет встроен виджет;
путь к дескриптору виджета;
параметры запроса;
параметры авторизации (где – токен, полученный при авторизации пользователя через ЕСИА, – токен, полученный при авторизации системы);
обработка ошибки загрузки (на стороне портала).
Код встраивания виджета для продуктивного контура (iframe)
="https://widget.gosuslugi.ru/widgets/res/js/embed/addwidget-1.2.5.min.js">
="foreign-passport">
подключение скрипта addwidget, который регистрирует функцию rooxWidgetStart для CSI-встраивания;
скрипт, содержащий функции для авторизации (переписывает метод com.rooxteam.auth.requestAuthentification), код должен добавляться на страницу после загрузки виджета, можно вынести в отдельный файл или вписать внутри кода встраивания;
элемент, в который будет встроен виджет;
путь к дескриптору виджета;
параметры запроса;
параметры авторизации ( – токен, полученный при авторизации системы);
обработка ошибки загрузки (на стороне портала);
Изменение стилей виджета ( – путь до файла со стилями).
Переопределение действия кнопки «Войти»
При неавторизованном состоянии виджета отображается ссылка "Войти", при помощи которого происходит запрос авторизации на ЕСИА. По умолчанию, нажатие на ссылку "Войти" инициирует авторизацию пользователя на ЕСИА от лица Открытой платформы. Для переопределения действия ссылки «Войти», можно использовать инструкцию ниже. Инструкция являетcя типовой для виджетов Открытой платформы госуслуг:
Для запроса авторизации используется JavaScript функция com.rooxteam.auth.requestAuthentification, которая реализована в js файле:
где https://gu-st.ru/content/partners/authKey.js - это код, который необходимо реализовать на стороне портала. Минимально необходимый код:
/*global shindig, gadgets, window */
var com = com || {};
com.rooxteam = com.rooxteam || {};
com.rooxteam.auth = com.rooxteam.auth || {};
com.rooxteam.auth.getSecurityToken = function (devPrefix) {
var token = shindig.auth.getSecurityToken();
if (!token) {
return token;
}
return devPrefix ? 'esia_1.0_' + token : token;
};
com.rooxteam.auth.getSystemToken = function (devPrefix) {
var trusted = shindig.auth.getTrustedData(),
token = trusted && trusted.systemToken;
if (!token) {
return token;
}
return devPrefix ? 'esia_1.0_' + token : token;
};
// необходимо заменить authUrl и добавить свою логику, если необходимо
com.rooxteam.auth.requestAuthentification = function () {
var authUrl = 'http://example.com'; // некоторый URL
authUrl += '?';
authUrl += 'redirectto=' + encodeURIComponent(window.top.location.href);
authUrl += '&byesia=true';
try {
window.top.location.href = authUrl;
}
catch (e) {}
};
Измененный код необходимо подключить вместо https://gust.ru/content/partners/authKey.js функция com.rooxteam.auth.requestAuthentification будет вызвана при нажатии кнопки «Войти».
Требования к поисковой и навигационной доступности при размещении виджета
Виджет должен быть размещен в соответствии с требованиями к реализации навигации, поиска и предоставления информации о государственных услугах документа «Методические рекомендации по совершенствованию пользовательских интерфейсов федеральной государственной информационной системы «Единый портал государственных и муниципальных услуг (функций)» и официальных сайтов федеральных органов исполнительной власти и государственных внебюджетных фондов, используемых при предоставлении государственных услуг в электронном виде», утвержденным приказом Минкомсвязи России от 16.10.2015 г. № 405 и размещенном на сайте Минкомсвязи России по адресу: http://minsvyaz.ru/ru/documents/4820/
В частности:
-
виджет должен быть размещен в каталоге государственных услуг партнерского портала при его наличии в разделах:
Паспорта, регистрации, визы;
Документы; Личные документы; Получение документов;
в случае наличия интеграции каталога государственных услуг партнерского портала с данными федерального реестра государственных услуг виджет должен быть связан со страницей услуги «Выдача паспорта гражданина Российской Федерации, удостоверяющего личность гражданина Российской Федерации, за пределами территории Российской Федерации» (паспорт нового поколения - реестровый номер услуги: 10001959166; паспорт старого поколения – реестровый номер услуги: 10000008589);
допускается размещение виджета в разделе, связанном с государственными услугами либо иными интерактивными сервисами (если партнерский интернет-портал не имеет соответствующего каталога государственных услуг). При этом обязательно должны быть соблюдено обозначение бренда Госуслуг в интерфейсном отображении виджета путем размещения логотипа/брендирования отдельного раздела при размещении нескольких виджетов;
виджет должен быть размещен в разделе популярных услуг (при наличии) и/или на главной странице в период сезонного увеличения популярности услуги. Сезонные периоды – начало весны, середина осени;
-
должна быть обеспечена поисковая доступность страниц размещения/перехода к виджету. Поисковые инструменты портала при возможности должны быть дополнены механизмами исправления опечаток, транслитерации и словарем синонимов, в котором будет установлена взаимосвязь между поисковыми запросами пользователей и страницей размещения виджета на основании упрощенных и общераспространенных слов и выражений. Словарь синонимов должен обладать полнотой состава синонимов и точностью наименований. Примеры запросов пользователей по виджету «Получение загранпаспорта» для обработки опечаток и создания связей:
загранпаспорт нового образца заявление подать
загранпаспорт
загранпаспорт старого образца заявление подать
заграничный паспорт
загран паспорт
получение загранпаспорта нового образца
pfuhfy заграничный паспорт нового поколения
заграничный паспорт нового поколения
оформление загранпаспорта нового образца
паспорт заграничный
загран
загран паспорт нового образца на 10 лет
загранпаспорт нового образца
замена загранпаспорта по истечению срока действия
загранпаспорт для несовершеннолетнего
Загранпаспорт
заграничный паспорт нового образца на 10 лет
получение заграничного паспорта
pfuhfygfcgjhn старого поколения
заявление на получение загран паспорта нового образца
оформление загранпаспорта
госпошлина на загранпаспорт нового образца
загран паспорт нового образца
паспорт нового поколения
загранпаспорт старого образца
замена загранпаспорта при смене фамилии
получить загранпаспорт нового образца
gjkextybt загранпаспорта нового образца
получение загранпаспорта
получение загранпаспорта старого образца
заграничный
оформить загран паспорт гражданина рф в электронном виде
получение паспорта нового поколения гражданином российской федерации
pfuhfygfcgjhn yjdjuj gjrjktybzпоиск загранпаспортах нового поколения
заявление на загранпаспорт нового образца
анкета на загранпаспорт нового образца
оформление загранпаспорта старого образца
Загран паспорт
Получение паспорта нового поколения гражданином Российской Федерации, достигшим 18-летнего возраста
выдача заграничных паспортов нового образца
получение заграничного паспорта нового поколения
Заграничный паспорт
заграничный паспорт нового образца
загранпаспорт нового образца для лиц старше 18 лет
подать заявление на загранпаспорт нового образца
смена заграничного паспорта в связи со сменой фамилии
ЗАГРАНПАСПОРТ
бланк заявления на загранпаспорт
замена заграничного паспорта
замена загранпаспорта
Загран
загран паспорт нового образца не достигшим 14 лет
загран паспорт старого образца для лиц старше 18 лет
заявление на загранпаспорт
выдача заграничного паспорта
заграничный паспорт старого образца
заявка на загранпаспорт нового образца
образец заполнения заявления на загранпаспорт нового поколения
оформление заявки на получение загран паспорта
pfuhfy заграничный паспорт
готовность загранпаспорта
загран паспорт старого образца
загранпаспорт
загранпаспорт на 10 лет
|