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

A vinculação de apps do Google baseada no OAuth permite que os usuários vinculem as contas deles com facilidade e rapidez no sistema de autenticação às Contas do Google. Se o app for instalado no smartphone do usuário quando ele iniciar o processo de vinculação da conta, ele será virado para o app e receberá a autorização do usuário.

Essa abordagem oferece um processo de vinculação mais rápido e fácil, já que o usuário não precisa inserir novamente o nome de usuário e a senha para autenticação. Em vez disso, o App Flip usa as credenciais da conta do usuário no aplicativo. Depois de vincular a Conta do Google ao aplicativo, o usuário pode aproveitar as integrações que você desenvolveu.

Você pode configurar o App Flip em apps iOS e Android.

Esta figura mostra as etapas para um usuário vincular a Conta do Google
 ao seu sistema de autenticação. A primeira captura de tela mostra como um usuário
            pode selecionar o app se a Conta do Google dele estiver vinculada ao app.
            A segunda captura de tela mostra a confirmação da vinculação
            da Conta do Google ao app. A terceira captura de tela mostra uma
            conta de usuário vinculada com sucesso no Google app.
Figura 1. Vinculação de conta no smartphone de um usuário com o App Flip.

Requisitos

Para implementar o App Flip, você precisa atender aos seguintes requisitos:

  • É preciso ter um app Android ou iOS.
  • É necessário ter, gerenciar e manter um servidor OAuth 2.0 compatível com o fluxo de código de autorização do OAuth 2.0.

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.