Vinculação de contas

Cada integração com Cloud-to-cloud precisa incluir um mecanismo para autenticar usuários.

A autenticação permite vincular as Contas do Google dos usuários às contas de usuário no seu sistema de autenticação. Isso permite identificar os usuários quando o fulfillment recebe uma intent de casa inteligente. A casa inteligente do Google só oferece suporte ao OAuth com um fluxo de código de autorização.

Depois de ter uma implementação do OAuth 2.0, você pode configurar App Flip com base no OAuth, o que permite que os usuários vinculem as contas no sistema de autenticação às Contas do Google com mais rapidez.

OAuth

Para smart home, é necessário usar o OAuth com um fluxo de código de autorização, que exige dois endpoints: autorização e troca de token.

Quando você autentica um usuário, o token de acesso OAuth 2.0 de terceiros do usuário é enviado no cabeçalho de autorização quando as intents smart home são enviadas para a realização. Todos os usuários precisam realizar a vinculação da conta, porque as informações do dispositivo são enviadas para o Google Assistant com a intent action.devices.SYNC, que exige a vinculação da conta.

A integração da Cloud-to-cloud precisa oferecer suporte a vários usuários do Google conectados à mesma conta de usuário (por exemplo, quando os usuários dão acesso a outros usuários da família). Se o serviço não oferecer suporte a várias conexões de usuário, ele vai apresentar erros no momento da vinculação de conta.

Para instruções sobre como configurar um servidor OAuth 2.0 para sua integração, consulte Implementar seu servidor OAuth 2.0.

App Flip baseado em 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.

Para mais informações sobre o fluxo do código de autorização de vinculação do OAuth, consulte Implementar seu servidor OAuth 2.0.

Para instruções sobre como configurar App Flip para sua integração, consulte App Flip baseado em OAuth.

Anterior
Fulfillment