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 seu 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 do aplicativo para dispositivos móveis às Contas do Google. Também é possível usar links diretos para direcionar os usuários ao fluxo de vinculação no app ou no site do produto.
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 é enviado no cabeçalho de autorização quando as smart home
intents são enviadas ao seu 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 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.