Toda integração do Cloud-to-cloud precisa incluir um mecanismo para autenticar usuários.
Com a autenticação, é possível vincular as Contas do Google dos usuários às contas de usuário no seu sistema de autenticação. Isso permite identificar seus usuários quando seu atendimento recebe uma intent de casa inteligente. A casa inteligente do Google só aceita OAuth com um fluxo de código de autorização.
Depois de ter uma implementação do OAuth 2.0, você pode configurar opcionalmente App Flip com base no OAuth, que permite que os usuários vinculem mais rapidamente as contas no sistema de autenticação às Contas do Google.
OAuth
Para smart home, use o OAuth com um fluxo de código de autorização, que exige dois endpoints: autorização e troca de token.
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 intents smart home
são enviadas ao seu fulfillment. Todos os usuários precisam fazer a vinculação de 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.
Sua integração com 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 dão acesso a outras pessoas na casa deles). Se o serviço não for compatível com várias conexões de usuários, ele vai gerar erros durante a vinculação de contas.
Para instruções sobre como configurar um servidor OAuth 2.0 para sua integração, consulte Implementar seu servidor OAuth 2.0.
Troca de apps 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 de 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 sua integração, consulte App Flip com base em OAuth.