Cada integración de 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 las cuentas de usuario de 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 la App Flip basada en OAuth, que permite que tus usuarios vinculen sus cuentas sin problemas desde tu aplicación para dispositivos móviles a sus Cuentas de Google. También puedes usar la vinculación directa para dirigir a los usuarios al flujo de vinculación desde tu app o sitio web del producto.
OAuth
Para smart home, debes usar OAuth con un flujo de código de autorización, lo que requiere que tengas dos extremos: el de autorización y el de intercambio de tokens.
Cuando autenticas a un usuario, su token de acceso de OAuth 2.0 de terceros se envía en el encabezado de autorización cuando se envían intents de 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, que requiere la vinculación de cuentas.
Se espera que tu integración de Cloud-to-cloud 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 grupo familiar). Si tu servicio no admite varias conexiones de usuario, debería proporcionar errores en el momento de la vinculación de la cuenta.
Si quieres obtener instrucciones para configurar un servidor de OAuth 2.0 para tu integración, consulta Implementa tu servidor de 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 de OAuth 2.0.
Para obtener instrucciones sobre cómo configurar App Flip para tu integración, consulta App Flip basado en OAuth.