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

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

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

2. В проекте создайте приложение. Для этого нажмите Добавить приложение, задайте название и выберите тип. Нажмите Создать.

3. Созданное приложение отобразится на странице Приложения.

4. Выберите приложение и сохраните значение поля ID приложения для выполнения шага 6.

5. Заполните необходимые параметры приложения в соответствии с таблицей, приведенной ниже:

Жирным шрифтом выделены параметры, значения которых необходимо задать, учитывая ваши индивидуальные требования.

ПараметрТребуемое значениеОписание
НазваниеЛюбоеНазвание навыка задается тем, кто настраивает интеграцию.
Допускается указание любого значения.
Адрес API

https://domain.name:port/api/v1/yandex/v1.0

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

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

По данному URL УД ВК будет обращаться к API платформы умного дома ELIS.
Адрес страницы авторизации

https://domain.name:port/api/v1/oauth2/authorize

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

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

По данному URL УД ВК будет перенаправлять пользователей для входа в аккаунт на платформе умного дома ELIS.
Адрес для получения тоĸена

https://domain.name:port/api/v1/oauth2/token

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

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

По данному URL УД ВК будет получать токен для доступа к платформе умного дома от имени привязанного пользователя.
Адрес для обновления токена

https://domain.name:port/api/v1/oauth2/token

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

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

По данному URL УД ВК будет обновлять токен для доступа к платформе умного дома от имени привязанного пользователя.
Авторизационный client_idЛюбоеИдентификатор приложения задается тем, кто настраивает интеграцию.
Допускается указание любого уникального значения (не совпадающего с Client ID других интеграций).
Авторизационный secretЛюбоеСекрет приложения задается тем, кто настраивает интеграцию.
Допускается указание любого значения.
Протокол интеграцииЯндексПротокол, при помощи которого будет выполняться обращение к API платформы умного дома ELIS.

6. Отредактируйте конфигурационный файл /etc/ansible-iot/latest/vars/default.yml в соответствии с таблицей, приведенной ниже:

# Параметры установки платформы.
iot:
  # Параметры authorization server.
  authorization:
    skills:
      # Параметры проекта умного дома Mail.ru для интеграции с Марусей. Отображается в карточке проекта/приложения.
      marusya:
        enabled: false
        # Параметры для Basic Authentication.
        clientId: "MarusyaClientIdChangeMe"
        password: "PasswordChangeMe"
        # App ID, который был назначен приложению VK при создании.
        appId: "MarusyaAppIdChangeMe"
        # OAuth-токен, который необходимо указывать при отправке уведомлений.
        oauthToken: ""

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

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

iot.authorization.skills.marusya.enabled

false

true

Включение возможности интеграции с УД ВК.

iot.authorization.skills.marusya.clientId

"MarusyaClientIdChangeMe"

Идентификатор приложения, указанный при создании навыка в шаге 4

Идентификатор приложения, использующийся для определения интеграции, отправившей запрос на авторизацию.
Данный идентификатор не должен совпадать с Client ID других интеграций (УД Яндекс, УД Сбер).

iot.authorization.skills.marusya.password

"PasswordChangeMe"

Секрет приложения, указанный при создании навыка в шаге 4

Секрет приложения, использующийся для верификации интеграции, отправившей запрос на авторизацию.

iot.authorization.skills.marusya.appId

""

ID приложения, полученный в шаге 4

Идентификатор диалога, использующийся для отправки уведомлений УД ВК от имени созданного навыка.

iot.authorization.skills.marusya.oauthToken

""

""

Данное поле не используется при работе с интеграцией УД ВК (Маруся)