Implementación
Integración con el LMS e inicio de sesión institucional
Cómo se conecta LingoQuesto con Moodle, Brightspace, Canvas o Blackboard por LTI 1.3, qué opciones de inicio de sesión existen y qué se necesita de la institución para activarlas.
Resumen
Hay tres formas de llevar a docentes y estudiantes a LingoQuesto, y se pueden combinar:
- Desde el LMS, por LTI 1.3. El usuario hace clic en un enlace de su curso y entra ya autenticado, sin otra contraseña.
- Con la cuenta institucional de Microsoft o de Google.
- Sin integración. Invitaciones por correo, carga de estudiantes por archivo o código de clase.
La institución no instala software, no abre su base de datos y no entrega contraseñas.
Inicio de sesión
| Método | Disponibilidad | Observaciones |
|---|---|---|
| Cuenta de Microsoft (Microsoft 365, Entra ID) | Disponible | Sirve para cualquier organización, sin configuración por cliente. |
| Cuenta de Google (Google Workspace) | Disponible | |
| Entrada desde el LMS (LTI 1.3) | Disponible | El LMS ya autenticó al usuario; LingoQuesto verifica la firma del LMS. |
| Correo y contraseña | Disponible | Contraseña de 8 caracteres como mínimo. |
| SAML 2.0 propio de la institución | No disponible | Las tres primeras opciones cubren el mismo caso de uso. |
Segundo factor de autenticación
LingoQuesto no administra un segundo factor propio. Cuando el usuario entra con su cuenta de Microsoft o de Google, o desde el LMS, se aplican el segundo factor y las políticas de acceso que la institución ya tiene en su proveedor de identidad. Es la opción recomendada para instituciones que exigen autenticación multifactor.
Permisos que se piden al iniciar sesión
| Proveedor | Permisos | Datos que se reciben |
|---|---|---|
| Microsoft | openid, email, profile y User.Read |
Identificador, correo, nombre y apellido |
email y profile |
Identificador, correo, nombre, apellido y la dirección de la foto de perfil |
Si la organización restringe el consentimiento de aplicaciones en Microsoft Entra ID, su administrador debe aprobar la aplicación LingoQuesto una vez.
Integración por LTI 1.3
LTI 1.3 es el estándar que usan los LMS para conectar herramientas externas. El administrador del LMS registra LingoQuesto una sola vez; después, cualquier docente puede poner el enlace en sus cursos.
Cuando un usuario abre ese enlace:
- El LMS le indica a LingoQuesto quién es el usuario, en qué curso está y con qué rol, y firma esa información.
- LingoQuesto verifica la firma con las claves públicas del LMS.
- Si es la primera vez, se crea la cuenta y se inscribe en la clase que corresponde a ese curso.
- El usuario queda dentro de la plataforma sin ver un formulario de inicio de sesión.
Compatibilidad
| LMS | Estado |
|---|---|
| Moodle | Probado de punta a punta. |
| D2L Brightspace, Canvas, Blackboard Learn, Schoology, Sakai, Open edX | Compatibles por estándar. La primera institución de cada LMS se habilita con un piloto corto. |
| Google Classroom | No implementa LTI 1.3. Los usuarios pueden entrar con su cuenta de Google. |
Lista de clase
Si el LMS tiene activo el servicio de nombres y roles (Names and Role Provisioning Services), la lista del curso se sincroniza cada vez que alguien abre LingoQuesto desde ese curso. No hay sincronización programada ni manual.
- Se crean las cuentas y se inscriben en la clase todos los miembros activos del curso, aunque todavía no hayan entrado.
- Una baja en el LMS no retira a la persona de la clase en LingoQuesto. El docente o el administrador la retira desde la plataforma.
Lo que la integración no hace
- No envía las calificaciones al libro de calificaciones del LMS. Se consultan y se exportan desde LingoQuesto.
- No permite elegir una actividad específica desde el LMS. El enlace lleva a la plataforma y el estudiante encuentra allí sus asignaciones.
Datos que la institución recibe de LingoQuesto
Con estos datos el administrador registra la herramienta en el LMS.
| Dato | Valor |
|---|---|
| Dominio | lti.lingoquesto.com |
| URL de inicio de sesión (OIDC) | https://lti.lingoquesto.com/lti/login |
| URL de lanzamiento y de redirección | https://lti.lingoquesto.com/lti/launch |
| Claves públicas (JWKS) | https://lti.lingoquesto.com/.well-known/jwks.json |
Datos que LingoQuesto recibe de la institución
Son los que el LMS muestra al terminar el registro.
| Dato | Descripción |
|---|---|
| Emisor (issuer) | La dirección pública del LMS |
| Identificador de cliente (client ID) | El que el LMS asigna a LingoQuesto |
| Identificador de despliegue | El del despliegue creado para la herramienta |
| URL de autenticación OIDC | A donde LingoQuesto redirige para iniciar la sesión |
| URL de tokens | Para pedir acceso a la lista de clase |
| Claves públicas del LMS (JWKS) | Para verificar la firma de cada entrada |
Datos personales que llegan por LTI
En cada entrada LingoQuesto recibe el identificador del usuario en el LMS, su nombre, su correo, su rol y el curso desde el que entró. No recibe contraseñas ni lee otro contenido del curso. Cada entrada queda registrada para poder diagnosticar incidentes.
Qué necesitamos de la institución
Del administrador del LMS
- Qué LMS usa la institución, en qué versión y si está alojado por el proveedor o en servidores propios.
- Quién puede registrar herramientas externas y cuál es el proceso de autorización.
- El registro de LingoQuesto con los datos de este documento, y los datos que el LMS entrega al terminar.
- Un curso de prueba con un docente y dos estudiantes.
- El enlace configurado para abrir LingoQuesto en una pestaña nueva. Evita que el navegador le niegue el micrófono a una herramienta incrustada.
- El servicio de nombres y roles activado, si se quiere la lista de clase sincronizada.
Del administrador de identidad
- Confirmar que los usuarios pueden entrar con su cuenta institucional de Microsoft o de Google.
- Aprobar la aplicación LingoQuesto si la organización restringe el consentimiento de aplicaciones.
Del área de sistemas y redes
Lo descrito en Requisitos técnicos y de red: dominios permitidos, WebSocket por el puerto 443 y micrófono autorizado en los equipos administrados.