Toda integración Cloud-to-cloud debe incluir un mecanismo para autenticar a los usuarios.
La autenticación te permite vincular las Cuentas de Google de tus usuarios con cuentas de usuario en tu sistema de autenticación. Esto te permite identificar a tus usuarios cuando tu entrega recibe 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 el cambio de app basado en OAuth App Flip, 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 intercambio de tokens.
Cuando autentiques a un usuario, el token de acceso de OAuth 2.0 de terceros del usuario se enviará en el encabezado de autorización cuando se envíen smart home
intents a tu entrega. Todos los usuarios deben realizar la vinculación de la cuenta, ya que la información del dispositivo se envía al
Google Assistant con el action.devices.SYNC
intent, que requiere la vinculación de la cuenta.
Se espera que tu Cloud-to-cloud integración admita que varios usuarios de Google se conecten a la misma cuenta de usuario (por ejemplo, cuando los usuarios otorgan acceso a otros usuarios de su casa). Si tu servicio no puede admitir conexiones multiusuario, debe proporcionar errores en el momento de la vinculación de la cuenta.
Para obtener instrucciones sobre cómo configurar un servidor OAuth 2.0 para tu integración, consulta Implementa tu servidor OAuth 2.0.
Cambio de app basado en OAuth
La vinculación de App Flip basada en OAuth (App Flip) permite que los usuarios vinculen sus cuentas en tu sistema de autenticación con sus Cuentas de Google de forma fácil y rápida. Si tu app está instalada en el teléfono del usuario cuando inicia el proceso de vinculación de la cuenta, se lo redirecciona sin problemas a tu app 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 su lugar, App Flip aprovecha las credenciales de la cuenta del usuario en tu app. Una vez que un usuario vinculó su Cuenta de Google con tu app, puede aprovechar cualquier integración que hayas desarrollado.
Puedes configurar el cambio de app para apps de iOS y Android.
Requisitos
Para implementar el cambio de app, debes cumplir con los siguientes requisitos:
- Debes tener una app para Android o iOS.
- Debes ser propietario de un servidor de OAuth 2.0, administrarlo y mantenerlo, y este debe admitir 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 Implementa tu servidor OAuth 2.0.
Para obtener instrucciones sobre cómo configurar App Flip para tu integración, consulta Cambio de app basado en OAuth App Flip.