Просмотреть исходный

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

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

1. Перейдите на страницу SmartMarket Studio, выполните вход и выберите Создать проект.

Дизайн гайды > Умный дом Сбер (Салют) (1.34) > Создать проект.png

2. Из списка сервисов выберите карточку Другие сервисы и API → Smart Home Cloud:

Дизайн гайды > Умный дом Сбер (Салют) (1.34) > Group 2.png

3. Далее введите в соответствующее поле название проекта:

4. В соответствующих полях введите Название бренда, добавьте Логотип и следующие Ссылки на приложения:

Параметр	Требуемое значение
`App Store Url`	`https://apps.apple.com/ru/app/eltex-home/id1563181285`
`Google Play`	`https://play.google.com/store/apps/details?id=org.eltex.android.app.smart_home_services`
`Rustore`	`https://apps.rustore.ru/app/org.eltex.android.app.smart_home_services`
`Appgallery`	`https://appgallery.huawei.com/#/app/C109850967`

Дизайн гайды > Умный дом Сбер (Салют) (1.34) > image2022-10-12_12-43-23.png

5. На вкладке Параметры задайте следующие значения:

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

Параметр	Требуемое значение	Описание
Тип передачи параметров	В параметрах запроса	Способ передачи параметров при обращении УД Сбер к платформе умного дома ELIS.
Адрес API-сервера проекта	`https://domain.name:port/api/v1/sber` где `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 УД Сбер будет получать токен для доступа к платформе умного дома от имени привязанного пользователя.
Идентификатор клиента	Любое	Идентификатор приложения задается тем, кто настраивает интеграцию. Допускается указание любого уникального значения (не совпадающего с Client ID других интеграций).
Секрет клиента	Любое	Секрет приложения задается тем, кто настраивает интеграцию. Допускается указание любого значения.

6. После изменения параметров нажмите Сохранить.

7. На вкладке Доступ к API сгенерируйте токен, который будет использоваться облачной платформой для взаимодействия с УД Сбер:

Дизайн гайды > Умный дом Сбер (Салют) (1.34) > image2022-10-12_12-55-52.png

8. Сгенерированный токен доступа к API умного дома Sber необходимо сохранить для выполнения шага 9.

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

# Параметры установки платформы.
iot:
  # Параметры authorization server.
  authorization:
    skills:
      # Параметры проекта умного дома Сбера для интеграции с Салютом. Отображается в карточке проекта.
      sber:
        enabled: false
        # Параметры для Basic Authentication.
        clientId: "SberClientIdChangeMe"
        password: "PasswordChangeMe"
        # Bearer-токен, который необходимо указывать при отправке уведомлений.
        bearerToken: ""

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

Параметр	Значение по умолчанию	Требуемое значение	Описание
`iot.authorization.skills.sber.enabled`	`false`	`true`	Включение возможности интеграции с УД Сбер.
`iot.authorization.skills.sber.clientId`	`"SberClientIdChangeMe"`	Идентификатор приложения, указанный при создании навыка в шаге 5	Идентификатор приложения, использующийся для определения интеграции, отправившей запрос на авторизацию. Данный идентификатор не должен совпадать с Client ID других интеграций (УД Яндекс, УД ВК).
`iot.authorization.skills.sber.password`	`"PasswordChangeMe"`	Секрет приложения, указанный при создании навыка в шаге 5	Секрет приложения, использующийся для верификации интеграции, отправившей запрос на авторизацию.
`iot.authorization.skills.sber.bearerToken`	`""`	""	OAuth-токен для отправки уведомлений, использующийся для отправки уведомлений в УД Сбер от имени созданного навыка.