Vinculação de contas

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

A autenticação permite que você vincule as Contas do Google dos seus usuários a contas de usuário no seu sistema de autenticação. Isso permite que você identifique seus usuários quando o fulfillment receber 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 implementar o OAuth 2.0, você tem a opção de configurar o App Flip baseado em OAuth. Isso permite que os usuários vinculem as contas do sistema de autenticação mais rapidamente às Contas do Google deles.

OAuth

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

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

Sua ação smart home deve permitir que vários usuários do Google se conectem à 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 for compatível com várias conexões de usuários, serão exibidos erros no momento da vinculação da conta.

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

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