Привязка аккаунта

Каждая интеграция Cloud-to-cloud должна включать механизм аутентификации пользователей.

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

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

OAuth

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

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

Ожидается, что ваша интеграция Cloud-to-cloud будет поддерживать подключение нескольких пользователей Google к одной и той же учётной записи (например, когда пользователи предоставляют доступ другим пользователям в своей семье). Если ваш сервис не поддерживает подключение нескольких пользователей, при подключении учётных записей должны возникать ошибки.

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

App Flip на основе OAuth

OAuth-based App Flip Linking (App Flip) allows your users to easily and quickly link their accounts in your authentication system to their Google accounts. If your app is installed on your user’s phone when they initiate the account linking process, they are seamlessly flipped to your app to obtain user authorization.

This approach provides a faster and easier linking process since the user does not have to re-enter their username and password to authenticate; instead, App Flip leverages the credentials from the user's account on your app. Once a user has linked their Google account with your app, they can take advantage of any integrations that you have developed.

You can set up App Flip for both iOS and Android apps.

This figure shows the steps for a user to link their Google account
            to your authentication system. The first screenshot shows how a user
            can select your app if their Google account is linked to your app.
            The second screenshot shows the confirmation for linking their
            Google account with your app. The third screenshot shows a
            successfully linked user account in the Google app.
Figure 1. Account linking on a user's phone with App Flip.

Requirements

To implement App Flip, you must fulfill the following requirements:

  • You must have an Android or iOS app.
  • You must own, manage and maintain an OAuth 2.0 server which supports the OAuth 2.0 authorization code flow.

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

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