Связывание аккаунта

Каждое Действие smart home должно включать в себя механизм аутентификации пользователей.

Аутентификация позволяет вам связать учетные записи Google ваших пользователей с учетными записями пользователей в вашей системе аутентификации. Это позволяет вам идентифицировать ваших пользователей, когда ваше выполнение получает намерение умного дома. Умный дом Google поддерживает только OAuth с потоком кода авторизации.

Если у вас есть реализация OAuth 2.0, вы можете дополнительно настроить App Flip на основе OAuth , который позволит вашим пользователям быстрее связывать свои учетные записи в вашей системе аутентификации со своими учетными записями Google.

OAuth

Для smart home вы должны использовать OAuth с потоком кода авторизации, который требует наличия двух конечных точек: конечных точек авторизации и обмена токенами .

Когда вы аутентифицировали пользователя, сторонний токен доступа OAuth 2.0 пользователя отправляется в заголовке авторизации, когда намерения smart home отправляются для вашего выполнения. Все пользователи должны выполнить привязку учетной записи, поскольку информация об устройстве отправляется в Google Assistant с намерением action.devices.SYNC , что требует привязки учетной записи.

Ожидается, что действие вашего smart home будет поддерживать несколько пользователей Google, подключающихся к одной и той же учетной записи пользователя (например, когда пользователи предоставляют доступ другим пользователям в своей семье). Если ваша служба не может поддерживать несколько пользовательских подключений, она должна выдавать ошибки во время связывания учетных записей.

Инструкции по настройке сервера OAuth 2.0 для вашего действия см. в разделе «Реализация сервера OAuth 2.0» .

Переворот приложения на основе OAuth

Связывание App Flip Linking (App Flip) на основе OAuth позволяет вашим пользователям легко и быстро связать свои учетные записи в вашей системе аутентификации со своими учетными записями Google. Если ваше приложение установлено на телефоне вашего пользователя, когда он инициирует процесс привязки учетной записи, он легко переключается на ваше приложение для получения авторизации пользователя.

Этот подход обеспечивает более быстрый и простой процесс связывания, поскольку пользователю не нужно повторно вводить свое имя пользователя и пароль для аутентификации; вместо этого App Flip использует учетные данные из учетной записи пользователя в вашем приложении. Как только пользователь свяжет свою учетную запись Google с вашим приложением, он сможет воспользоваться преимуществами любых разработанных вами интеграций.

Вы можете настроить App Flip для приложений iOS и Android.

На этом рисунке показаны шаги, необходимые пользователю для привязки своей учетной записи Google к вашей системе аутентификации. На первом снимке экрана показано, как пользователь может выбрать ваше приложение, если его учетная запись Google связана с вашим приложением. На втором снимке экрана показано подтверждение привязки их учетной записи Google к вашему приложению. На третьем снимке экрана показана успешно связанная учетная запись пользователя в приложении Google.
Рис. 1. Связывание учетной записи на телефоне пользователя с App Flip.

Требования

Для реализации App Flip необходимо выполнить следующие требования:

  • У вас должно быть приложение для Android или iOS.
  • Вы должны владеть, управлять и поддерживать сервер OAuth 2.0, который поддерживает поток кода авторизации OAuth 2.0.

Дополнительные сведения о потоке кода авторизации привязки OAuth см. в разделе Реализация сервера OAuth 2.0 .

Инструкции по настройке App Flip для вашего действия см. в разделе App Flip на основе OAuth .