Google OAuth 2.0 es un producto gratuito y de código abierto que ofrece una solución de identidad federada para conectar a los usuarios con aplicaciones de diversos tipos, tanto dentro como fuera de las instituciones. El marco flexible de proveedor de módulos SSO de la plataforma de video está diseñado para admitir una amplia variedad de soluciones de identidad, lo que permite la integración completa de Google OAuth 2.0 en su infraestructura.
Este documento tiene como objetivo guiar a los usuarios sobre cómo integrar la plataforma de video como una aplicación con su sistema Google API OAuth 2.0. Una vez configurado, los usuarios podrán dar su consentimiento y autorizar a la plataforma de video para que acceda a la información básica de su cuenta de Google con el fin de iniciar su sesión en la plataforma de video como usuarios nuevos o existentes.
Configuración
La configuración consiste en agregar un URI de redireccionamiento de la plataforma de video a su proyecto en la consola de Google API y luego obtener el archivo de metadatos JSON, que contiene toda la información necesaria para configurar el lado de la plataforma de video. Con el archivo JSON, configurar la plataforma de video solo implica proporcionar algunos parámetros y realizar un inicio de sesión de prueba. Una vez verificado que el SSO funciona, el último paso es activar la autenticación para todos los usuarios de su institución.
En algunos pasos, <organization> debe reemplazarse por el DNS comodín de la organización asociada con la plataforma de video. Por ejemplo, para “https://hudson.yuja.com”, <organization> se reemplazaría por “hudson”.
Cómo agregar un URI de redireccionamiento de la plataforma de video a la consola de Google API
Para obtener instrucciones sobre cómo crear proyectos en la consola de Google API, consulte lo siguiente: https://developers.google.com/identity/sign-in/web/devconsole-project
- En su consola de Google API, elija o cree un proyecto asociado con la plataforma de video. Agregue el siguiente valor a URI de redireccionamiento autorizados: https://<organization>.yuja.com/D/OauthAuthentication
- Descargue el archivo de metadatos JSON desde la consola de Google API. Este contiene los parámetros necesarios para configurar YuJa.
Configuración de la integración de Google OAuth en la plataforma de video
- Inicie sesión en su zona de YuJa como administrador de TI y vaya a Panel de Administrador → Integraciones.
- En Seleccione una API para configurar, seleccione SSO - Google OAuth 2.0.
- Ingrese los siguientes parámetros de configuración:
Parámetro
Valor
ID de cliente
El ID de cliente obtenido de la consola de Google API.
https://console.developers.google.com
También se encuentra en los datos JSON de su proyecto como el valor del atributo “client_id”.
Secreto de cliente
El secreto de cliente obtenido de la consola de Google API. https://console.developers.google.com
También se encuentra en los datos JSON de su proyecto como el valor del atributo “client_secret”.
URI de autenticación
Se encuentra en los datos JSON de su proyecto como el valor del atributo “auth_uri”.
URI del token
Se encuentra en los datos JSON de su proyecto como el valor del atributo “token_uri”.
- Haga clic en Crear configuración.
- Haga clic en OK en la ventana emergente de confirmación.
- Para comprobar si la configuración es correcta, haga clic en Prueba de inicio de sesión OAuth. Esto debería abrir una pestaña nueva y redirigirlo a Google, que gestiona la autenticación y el consentimiento del usuario.
- Si ningún usuario de Google tiene la sesión iniciada, ingrese credenciales de inicio de sesión válidas y haga clic en Iniciar sesión. De lo contrario, elija una cuenta de Google.
- Haga clic en Permitir para dar a la plataforma de video su consentimiento para acceder a la información básica del usuario.
- Debería ser redirigido de vuelta a la plataforma de video, con la sesión iniciada como un usuario nuevo.
Al iniciar sesión como un usuario nuevo, es posible que se cierre la sesión de la cuenta original. Si es así, cierre la sesión de la cuenta recién creada, vuelva a iniciar sesión como administrador de TI y luego regrese a Panel de Administrador → Integraciones → SSO – Google OAuth 2.0.
- Una vez que haya verificado que el SSO de OAuth funciona, puede optar por activar el nuevo esquema de autenticación para su organización haciendo clic en Activar.
Active el nuevo esquema de autenticación solo después de realizar correctamente un inicio de sesión de prueba y cuando esté listo para ponerlo a disposición de todos los usuarios de su organización.
(Opcional) Integración dual con LTI
Si su organización ha habilitado tanto LTI como el acceso SSO de Google OAuth, puede optar por vincular las dos integraciones. De forma predeterminada, un usuario que inicia sesión mediante LTI y OAuth recibe una cuenta de la plataforma de video independiente por cada inicio de sesión. Si su proveedor de LTI está configurado para autenticar a los usuarios con las credenciales de su cuenta de Google, es posible vincular las dos cuentas, ya que el proveedor de LTI proporcionará a la plataforma de video un identificador único del usuario en el sistema OAuth.
- Configure su LMS para que pase un parámetro LTI personalizado llamado lis_person_sourcedid, que contiene el valor de SSO de coincidencia cruzada. Puede ser un correo electrónico, un ID de empleado u otro campo. La plataforma de video usará esta función para vincular las dos técnicas de inicio de sesión a la misma cuenta.
- Obtenga el nombre del atributo cuyo valor corresponde al identificador único que usa el proveedor de LTI. Los valores posibles que puede usar los determina la API de Google. Dado que la plataforma de video solo solicita información básica del perfil de un usuario específico, el único atributo válido sería 'email'.
- Ingrese este valor en Panel de Administrador → Integraciones → Seleccione una API para configurar → SSO - Google OAuth 2.0 → Atributo de enlace y seleccione Guardar la integración cruzada.
- Ahora, cuando inicie sesión por primera vez mediante Google OAuth, el sistema de la plataforma de video buscará un vínculo con una cuenta LTI usando el valor del atributo de enlace. Si lo encuentra, la cuenta de Google se vinculará con la cuenta existente. De lo contrario, se aprovisionará una cuenta nueva de la forma habitual. Todos los inicios de sesión posteriores al primero seguirán vinculándose con la cuenta de la plataforma de video creada o encontrada en el primer inicio de sesión.
Uso
Una vez que la consola de Google API y la plataforma de video se hayan configurado correctamente y el SSO de OAuth se haya activado, los usuarios que accedan al dominio de la plataforma de video de su organización se autenticarán mediante Google OAuth 2.0, en lugar del inicio de sesión estándar de la plataforma de video. Es fácil comprobar que todo se hizo correctamente siguiendo los pasos a continuación:
- Vaya a la zona de la plataforma de video de la organización.
- Presione Iniciar sesión. Esto debería redirigir al usuario a Google, donde seleccionará una cuenta que usar y dará su consentimiento para que la plataforma de video acceda a su información básica.
- Una vez autorizado, el usuario debería ser redirigido de vuelta a la plataforma de video y haber iniciado sesión correctamente.