Vinculação de contas

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

Com a autenticação, é possível vincular as Contas do Google dos usuários às contas de usuário no seu sistema de autenticação. Isso permite identificar seus usuários quando seu atendimento recebe uma intent de casa inteligente. A casa inteligente do Google só aceita OAuth com um fluxo de código de autorização.

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

OAuth

Para smart home, use 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 dele é enviado no cabeçalho de autorização quando as intents smart home são enviadas ao seu fulfillment. Todos os usuários precisam fazer a vinculação de contas, porque as informações do dispositivo são enviadas ao Google Assistant com a intent action.devices.SYNC, que exige a vinculação de contas.

Sua integração com Cloud-to-cloud precisa oferecer suporte a vários usuários do Google que se conectam à mesma conta de usuário (por exemplo, quando os usuários dão acesso a outras pessoas na casa deles). Se o serviço não for compatível com várias conexões de usuários, ele vai gerar erros durante a vinculação de contas.

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

Troca de apps baseada 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 de código de autorização de vinculação do OAuth, consulte Implementar seu servidor OAuth 2.0.

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

Anterior
Fulfillment