Vinculación de cuenta

Cada acción smart home debe incluir un mecanismo para autenticar a los usuarios.

La autenticación te permite vincular las Cuentas de Google de tus usuarios con las cuentas de usuario en tu sistema de autenticación. Esto te permitirá identificar a tus usuarios cuando tu entrega reciba un intent de casa inteligente. La casa inteligente de Google solo admite OAuth con un flujo de código de autorización.

Una vez que tengas una implementación de OAuth 2.0, puedes configurar de forma opcional App Flip basado en OAuth, que permite a tus usuarios vincular más rápido sus cuentas en tu sistema de autenticación a sus Cuentas de Google.

OAuth

Para smart home, debes usar OAuth con un flujo de código de autorización, que requiere que tengas dos extremos: los extremos de autorización y de intercambio de tokens.

Cuando autenticas a un usuario, el token de acceso de OAuth 2.0 de terceros del usuario se envía en el encabezado de autorización cuando se envían los intents smart home a tu entrega. Todos los usuarios deben realizar la vinculación de cuentas, ya que la información del dispositivo se envía al Google Assistant con el intent action.devices.SYNC, lo que requiere la vinculación de la cuenta.

Se espera que tu acción smart home admita varios usuarios de Google que se conectan a la misma cuenta de usuario (por ejemplo, cuando los usuarios otorgan acceso a otros usuarios de su familia). Si tu servicio no puede admitir varias conexiones de usuarios, debería proporcionar errores durante la vinculación de la cuenta.

Si quieres obtener instrucciones a fin de configurar un servidor de OAuth 2.0 para tu acción, consulta Cómo implementar tu servidor de OAuth 2.0.

Cambios de app basados en OAuth

App Flip Link (App Flip) basada en OAuth permite que tus usuarios vinculen de manera fácil y rápida sus cuentas en tu sistema de autenticación con sus Cuentas de Google. Si la app se instala en el teléfono del usuario cuando inicia el proceso de vinculación de la cuenta, se le pasa a la app sin problemas para obtener su autorización.

Este enfoque proporciona un proceso de vinculación más rápido y sencillo, ya que el usuario no tiene que volver a ingresar su nombre de usuario y contraseña para autenticarse. En cambio, App Flip aprovecha las credenciales de la cuenta del usuario en tu app. Una vez que un usuario vincula su Cuenta de Google con tu app, puede aprovechar cualquier integración que hayas desarrollado.

Puedes configurar App Flip para las apps de iOS y Android.

En esta figura, se muestran los pasos para que un usuario vincule su Cuenta de Google a tu sistema de autenticación. La primera captura de pantalla muestra cómo un usuario puede seleccionar tu app si su Cuenta de Google está vinculada a la tuya. La segunda captura de pantalla muestra la confirmación de la vinculación de su Cuenta de Google con la app. La tercera captura de pantalla muestra una cuenta de usuario vinculada correctamente en Google app.
Figura 1: Vinculación de cuentas en el teléfono de un usuario con App Flip.

Requisitos

Para implementar App Flip, debes cumplir con los siguientes requisitos:

  • Debes tener una app para Android o iOS.
  • Debes tener, administrar y mantener un servidor de OAuth 2.0 que sea compatible con el flujo de código de autorización de OAuth 2.0.

Para obtener más información sobre el flujo de código de autorización de vinculación de OAuth, consulta Implementar tu servidor de OAuth 2.0.

A fin de obtener instrucciones para configurar App Flip en tu Acción, consulta App Flip basado en OAuth.