Toda integração do 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ó é compatível com o 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, que permite que os usuários vinculem as contas do seu app para dispositivos móveis às Contas do Google de forma integrada. Você também pode usar links diretos para direcionar os usuários ao fluxo de vinculação do seu app ou site do produto.
OAuth
Para smart home, use o OAuth com um fluxo de código de autorização, que exige dois endpoints: o de autorização e o de troca de token.
Depois que você autentica um usuário, o token de acesso OAuth 2.0 de terceiros dele
é enviado no cabeçalho de autorização quando as intents de smart home
são enviadas ao fulfillment. Todos os usuários precisam vincular as contas, porque as informações do dispositivo são enviadas ao Google Assistant com a intent action.devices.SYNC, que exige a vinculação de contas.
A integração do Cloud-to-cloud precisa 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 outras pessoas da família). Se o serviço não for compatível com várias conexões de usuário, ele precisará fornecer erros no momento da vinculação da conta.
Para instruções sobre como configurar um servidor OAuth 2.0 para sua integração, consulte Implementar seu servidor OAuth 2.0.
Vinculação no app baseada 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 o App Flip para sua integração, consulte App Flip baseado em OAuth.