Vinculação da conta

Toda ação smart home precisa incluir um mecanismo para autenticar usuários.

Com a autenticação, você pode vincular as Contas do Google dos seus usuários às contas deles 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ó é compatível com o OAuth com um fluxo de código de autorização.

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

OAuth

Para smart home, é preciso usar o OAuth com um fluxo de código de autorização, que exige dois endpoints: os endpoints de autorização e de troca de tokens.

Depois de autenticar um usuário, o token de acesso do OAuth 2.0 de terceiros dele será enviado no cabeçalho de autorização quando as intents smart home forem enviadas para o fulfillment. Todos os usuários precisam fazer a vinculação da conta, já que as informações do dispositivo são enviadas ao Google Assistant com a intent action.devices.SYNC, que exige a vinculação da conta.

Espera-se que a ação smart home ofereça suporte a vários usuários do Google que se conectam à mesma conta de usuário (por exemplo, quando os usuários concedem acesso a outros usuários da família). Se o serviço não for compatível com várias conexões de usuários, ele mostrará erros no momento da vinculação da conta.

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

Virar aplicativo 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 o App Flip para a ação, consulte App Flip baseado em OAuth.