Toda integração 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 do código de autorização.
Depois de implementar o OAuth 2.0, você pode configurar o App Flip baseado em OAuth App Flip, 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: o de autorização e troca de tokens.
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 smart home
intents são enviadas ao fulfillment. Todos os usuários precisam vincular a conta, porque as informações do dispositivo são enviadas ao
Google Assistant com a action.devices.SYNC
intent, que exige a vinculação de contas.
A integração 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 concedem acesso a outras pessoas na casa). Se o serviço não oferecer suporte a várias conexões de usuário, ele vai mostrar erros no momento da vinculação de contas.
Para instruções sobre como configurar um servidor OAuth 2.0 para sua integração, consulte Implementar o servidor OAuth 2.0.
App Flip baseado em OAuth
A vinculação de apps com base em OAuth (App Flip) permite que os usuários vinculem as contas no sistema de autenticação às Contas do Google com facilidade e rapidez. Se o app estiver instalado no smartphone do usuário quando ele iniciar o processo de vinculação da conta, ele será transferido para o app para 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 fazer a autenticação. Em vez disso, o App Flip aproveita as credenciais da conta do usuário no seu app. Depois que um usuário vincula a Conta do Google ao seu app, ele pode aproveitar todas as integrações que você desenvolveu.
É possível configurar a vinculação no app para iOS e Android.
Requisitos
Para implementar o recurso, você precisa atender aos seguintes requisitos:
- Você precisa ter um app Android ou iOS.
- Você precisa ter, gerenciar e manter um servidor OAuth 2.0 compatível com o fluxo do 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 o servidor OAuth 2.0.
Para instruções sobre como configurar App Flip para sua integração, consulte App Flip baseado em OAuth App Flip.