Создание сервиса Партнера

Для того чтобы воспользоваться услугами Aitu Passport Партнер, после регистрации в клиентской консоли, должен создать свой сервис в системе Aitu Passport на соответствующем окружении (на тестовой площадке, на продакшн площадке)

Для того чтобы создать сервис выполните следующие действия:

  • В клиентской консоли, на странице "Сервисы" нажмите на кнопку “Создать” (о регистрации в клиентской консоли см., статью "Регистрация Партнера"). После нажатия на кнопку "Создать" откроется страница создания нового сервиса

На странице создания нового сервиса укажите следующие данные:

  1. Логотип сервиса. Загрузите изображение логотипа вашего сервиса для светлой и темной темы. Требования к логотипу:

    • файл в формате png или jpeg

    • объем файла - 5 Mb

    • цвет фона изображения логотипа - прозрачный

    • размеры изображения одинаковы по высоте и ширине, например - 82x82px

  2. Наименование сервиса - отобразится на странице запроса данных Пользователя.

  3. Redirect URI - URI, на который будет перенаправлен Пользователь после того, как выдаст разрешение на предоставление своих данных сервису Партнера. В Redirect URI можно указать несколько URI, сформировав тем самым список URI, на которые Aitu Passport сможет переместить Пользователя приложения Партнера. Данный параметр должен быть статичным, все динамические части ссылки должны быть переданы через параметр state в ссылке-запросе авторизации.

Вы можете указать несколько URI, если вам необходимо возвращать пользователя на разные ресурсы

4. Post Logout Redirect URI - URI, на который будет перенаправлен пользователь после logout в системе Aitu Passport. Если данный параметр не заполнять, Пользователь будет перенаправлен на страницу ввода номера телефона в Aitu Passport. Значение для параметра Post Logout Redirect URI выбирается из списка URI, указанных в параметре Redirect URI. Параметр опциональный, можно не указывать.

5. Logout Callback URI - URI, на который Aitu Passport будет отправлять вебхук после выхода пользователя из системы. Параметр опциональный, можно не указывать.

6. Email - адрес электронной почты, на который будут отправляться уведомления об изменениях в системе Aitu Passport

7. Номер телефона. Указываются номера телефонов сотрудников Партнера, у которых в личном кабинете будет отображаться созданный сервис

8. Адаптеры - указываются адаптеры, которые система Aitu Passport должна использовать при предоставлении данных/услуг сервису Партнера. Данный параметр появится в консоли Партнера только после того как сотрудники Aitu Passport произведут соответствующие настройки. Используется при идентификации Пользователя Партнера через ЦОИД.

9. Данные для oauth параметра iin_signature (Публичный RSA ключ) - указывается публичная часть RSA ключа. Данный параметр заполняется если необходимо запретить пользователю менять ИИН, указанный в oauth запросе, а так же для защиты от несанкционированного изменения ИИН пользователя, переданного в oauth запросе.

Публичный RSA ключ вы можете получить следующим образом: Зайти на сайт https://8gwifi.org/RSAFunctionality?rsasignverifyfunctions=rsasignverifyfunctions&keysize=1024 Скопировать из поля “Public Key” ключ и вставить его в поле “Публичный RSA ключ”

После завершения работ по передаче закодированного параметра iin_signature на стороне системы Партнера, необходимо сообщить об этом менеджеру проекта для включения настройки, указывающей на обязательную передачу параметра iin_signature

10. Доступы по умолчанию - отображается перечень базовых сервисов Aitu Passport которые будут доступны Партнеру сразу же после создания сервиса.

11. Доступы по подписке - Отображается перечень сервисов, подключенных Партнеру по запросу. Полный список сервисов Aitu Passport см. статью "Список сервисов Aitu Passport (scope)". Для того чтобы подключить сервисы по подписке, необходимо сначала создать сервис, затем обратиться к вашему проектному менеджеру Aitu Passport с запросом на подключение сервисов по подписке. В запросе вы должны указать client_id и наименование сервисов (scope) которые вы хотите подключить. Чтобы узнать:

  • client_id сервиса в ниспадающем меню сервиса выберите функцию "Данные Client secret",

  • список всех доступных сервисов (scope) по подписке и выбрать нужный см., статью см. статью "Список сервисов Aitu Passport (scope)".

12. Ссылка (URL) на пользовательское соглашение - URL страницы с текстом пользовательского соглашения Партнера

13. Ссылка на политику конфиденциальности - URL страницы с текстом политики конфиденциальности Партнера

После того, как будут заполнены необходимые параметры сервиса, нажмите на кнопку “Создать”, если все сделано правильно, то система Aitu Passport создаст сервис и отобразит окно с данными для создания ссылки авторизации:

  • client_id - идентификатор сервиса партнера

  • client_secret - секрет, используемый для авторизации сервиса партнера

Созданные сервисы будут отображаться на странице личного кабинета клиентской консоли, при необходимости пользователь клиентской консоли сможет отредактировать параметры сервиса.

После создания сервиса, становится доступными функции кастомизации пользовательского интерфейса. Подробней о кастомизации пользовательского интерфейса смотрите в статье Сервис Партнера. Кастомизация интерфейса.

Функции управления сервисом

  • "Редактировать" - Открывает страницу редактирования данных сервиса

  • "Номера телефонов с доступом" - Открывает страницу, на которой отображаются телефонные номера сотрудников Партнера, которым доступен сервис. На странице доступна функция добавления дополнительных номеров телефонов.

  • "Значения Scope" - отображается список всех сервисов Aitu Passport (scope).

  • "Данные Client secret" - отображается страница с данными Client ID и Client Secret сервиса Партнера.

  • "Удалить" - Открывает предупреждение в котором отображается запрос на подтверждение удаления сервиса

Связанные статьи:

Last updated