Для настройки регистрации пользователей платформы ELIS через Mail.ru необходимо создать приложение в OAuth Mail. Чтобы сделать это, воспользуйтесь инструкцией в данном разделе.

Платформа должна иметь домен с действительным SSL-сертификатом.

При необходимости вы можете обратиться к официальной документации OAuth Mail.

1. Войдите в сервис OAuth Mail через аккаунт Mail, с помощью которого вы планируете продолжать разработку.

2. Нажмите Создать приложение.

3. Введите в поле Название проекта название вашего приложения, которое будет отображаться на странице авторизации пользователя.

4. Добавьте изображение, которое будет отображаться на экране выдачи прав. 

5. В поле Все redirect_uri добавьте адрес, на который платформа перенаправит пользователя после авторизации. Формат ввода:

https://domain.name:port/api/v1/login/oauth2/code/mail-ru

где domain.name — доменное имя сервера платформы умного дома (файл vars/default.yml, параметр iot.serverName);

      port — HTTPS-порт (файл vars/default.yml, параметр iot.web.httpsPort).

Например: https://eltex-co.ru:443/api/v1/login/oauth2/code/mail-ru

Не используйте на конце redirect_uri слеш и другие символы.

6. Подтвердите, что ознакомились и принимаете условия Лицензионного соглашения и Правил использования данных.

7. После настройки всех параметров нажмите Подключить сайт

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

9. Сохраните значения полей Client ID и Client Secret, указанных на данной странице, а затем отредактируйте конфигурационный файл vars/default.yml в соответствии с таблицей, приведенной ниже:

default.yml
# Параметры установки платформы.
iot:
  # Параметры authorization server.
  authorization:
    # Параметры для управления доступностью саморегистрации.
    selfRegistration:
      allowSocialNetworks: false

    # Параметры клиентских регистраций (через соцсети).
    clientRegistrations:
      mailRu:
        enable: true
        clientId: "MailRuClientIdChangeMe"
        clientSecret: "MailRuClientSecretChangeMe"

Жирным шрифтом выделены параметры, значения которых необходимо задать, опираясь на столбец "Значение по умолчанию" с учетом ваших индивидуальных требований, а также данных из предыдущих шагов документа.

ПараметрЗначение по умолчаниюТребуемое значениеОписание

iot.authorization.selfRegistration.allowSocialNetworks

false

true

Глобальное включение возможности регистрации пользователей через социальные сети (Яндекс, ВК, Mail.ru).

iot.authorization.clientRegistrations.mailRu.enable

true

true

Включение возможности регистрации пользователей через Mail.ru.
Для корректной работы требуется предварительно включить параметр iot.authorization.selfRegistration.allowSocialNetworks

iot.authorization.clientRegistrations.mailRu.clientId

"MailRuClientIdChangeMe"

Значение поля "Client ID"

"Client ID", полученный во время регистрации приложения в OAuth Mail.

iot.authorization.clientRegistrations.mailRu.clientSecret

"MailRuClientSecretChangeMe"

Значение поля "Client Secret"

"Client Secret", полученный во время регистрации приложения в OAuth Mail.


  • Нет меток