Configuración de Gradescope LTI 1.3 en Canvas
Antes de que puedas comenzar a configurar tu integración LTI 1.3, envíanos un correo electrónico a help@gradescope.com para que podamos habilitar los permisos de integración para tu cuenta. Una vez que hayas recibido nuestra confirmación de que tu cuenta de Gradescope tiene los permisos necesarios, puedes continuar con el primer paso.
Si aún no tienes una cuenta, ingresa al sitio web de Gradescope y selecciona Registrarse (Sign Up). Selecciona el rol de Instructor, completa el formulario proporcionado y asegúrate de usar la misma dirección de correo electrónico que usas en Canvas. Se te enviará un correo electrónico con un enlace para establecer una contraseña para que puedas acceder a tu nueva cuenta.
El proceso de configuración consta de ciertos pasos tanto en Canvas como en Gradescope. Tener ambas aplicaciones abiertas en pestañas separadas podría facilitar el proceso. Te recomendamos que completes el proceso de configuración de una sola vez, o en tu entorno de prueba de Canvas si crees que puede ser necesario completarlo por etapas. ¡Empecemos!
Elige tu método de instalación
Puedes instalar la integración de Gradescope LTI 1.3 en Canvas en la cuenta raíz o en el nivel de subcuenta según las preferencias de tu institución. Ambos enfoques de instalación funcionarán con las configuraciones de clave heredada y manual. Recomendamos realizar la instalación en el nivel de subcuenta si ciertos departamentos tienen sus propias subcuentas y quieres que los enlaces LTI de Gradescope estén disponibles para algunos departamentos, pero no para otros.
Elige tu método de configuración de clave
Para comenzar la integración de Canvas, elige la pestaña de configuración adecuada para tu institución. Para los usuarios de Gradescope.com, puedes utilizar tanto la configuración de clave heredada como la manual. Para los usuarios de Gradescope.ca/.eu/.com.au, debes utilizar la configuración de clave manual.
- Configuración de clave heredada (recomendada): este método de configuración utiliza la configuración predeterminada de Ubicación (Placement) que muestra los enlaces LTI de Gradescope en el menú Navegación del curso (Course Navigation); el menú Tareas del curso (Course Assignments) en Canvas, y el menú de entrega Herramientas externa (External Tool). Esta configuración tiene menos pasos y solo está disponible para los usuarios de Gradescope.com.
- Configuración de clave manual (recomendada para entornos de prueba o beta): este método de configuración te permite personalizar la configuración de Ubicación (Placement) donde se muestran los enlaces LTI de Gradescope en Canvas. Por ejemplo, puedes especificar que los instructores y estudiantes vean el enlace LTI de Gradescope en el nivel de tarea, pero no en el nivel de curso (en el menú de navegación del curso de la izquierda). Esta configuración está disponible para los usuarios de Gradescope.com y gradescope.ca/.eu/.com.au.
Si estás configurando una integración de Gradescope LTI 1.3 en una instancia beta o de prueba de Canvas (antes de implementarla en producción), debes usar la configuración de clave manual durante la prueba. Si no utilizas el método de clave manual para estos entornos, la integración no se logrará y la configuración generará un error. Cuando ya puedas configurar la integración en producción, utiliza la configuración de clave heredada.
Configuración de clave heredada
- Para registrar LTI 1.3 en Canvas, inicia sesión como Administrador de LMS.
- Ve a la página Admin utilizando el menú principal de la izquierda y selecciona el nombre de la cuenta de tu institución.
- Selecciona Claves de desarrollador (Developer Keys). Esta opción no aparecerá en ninguna subcuenta y debe configurarse utilizando la cuenta principal.
- Selecciona Heredado (Inherited) y asegúrate de que Gradescope se haya establecido en Activado (On).
- Selecciona Configuración (Settings), luego Aplicaciones (Apps) y, a continuación, Ver configuraciones de aplicaciones (View App Configurations).
- Selecciona el botón azul Agregar aplicación (+ App). Aparecerá un modal.
- Establece el Tipo de configuración (Configuration Type) en Por Id. de cliente (By Client ID) y luego ingresa el Id. de la Clave de desarrollador (Developer Key) heredada: 170000000000720.
- Selecciona Enviar (Submit) y luego Instalar (Install).
- Para ajustar las ubicaciones predeterminadas, selecciona configuración (settings) (ícono de engranaje) a la derecha de la nueva integración de Gradescope, luego selecciona Ubicaciones (Placements). Se abrirá el modal Ubicaciones de aplicaciones (App Placements).
Antes de poder ajustar la configuración de ubicaciones de las aplicaciones, tu administrador de Canvas debe habilitar la función Permitir cambiar la ubicación de LTI (Allow LTI Placement Toggling) en la configuración de la cuenta.
- Para deshabilitar una ubicación específica, selecciona la marca de verificación junto a ella. La marca de verificación cambiará a una X cuando se logre deshabilitar.
Gradescope ahora aparecerá como una opción para tus instructores. Los instructores deben completar el paso 4 en la sección Implementación antes de poder crear cursos o tareas de Gradescope a través de los enlaces LTI en Canvas.
Configuración de clave manual
Paso uno: Configuración en Canvas
- Inicia sesión en tu cuenta de Gradescope que tiene habilitados los permisos de integración. Contiene detalles que deben copiarse en tu página de configuración de integración de Canvas.
- Una vez que hayas iniciado sesión, selecciona Integraciones LTI 1.3 (LTI 1.3 Integrations) en el menú del lado izquierdo y luego selecciona Configurar integración (Configure Integration) en la esquina inferior derecha.
Si la opción Integraciones LTI 1.3 (LTI 1.3 Integrations) no aparece en la lista, comprueba que hayas iniciado sesión en la cuenta correcta y luego ponte en contacto con tu gerente de cuenta para que te habiliten los permisos de integración.
- Selecciona Crear nuevo registro (Create new registration) y luego elige Otro (Other) en el menú desplegable. Cambia el Nombre de registro (Registration Name) a Canvas o el nombre que prefieras para tu integración de Canvas.
- Aparecerán dos encabezados, Gradescope y Detalles de LMS (LMS Details). Los detalles bajo el encabezado Gradescope deben copiarse en Canvas.
- Ahora que tienes la información que necesitas, abre una nueva pestaña en tu navegador e inicia sesión en tu cuenta de administrador de Canvas.
- Selecciona Admin en el menú izquierdo y elige el nombre de tu institución.
- Selecciona Claves de desarrollador (Developer Keys), + Clave de desarrollador (+ Developer Key) y, a continuación, + Clave LTI (+ LTI Key).
- Asegúrate de que el Método (Method) esté configurado en Entrada manual (Manual Entry).
- Para los campos Nombre de clave (Key Name), Título (Title) y Descripción (Description), recomendamos utilizar “Gradescope” o algo que tus instructores reconozcan como tu integración de Gradescope.
- Para el campo Correo electrónico del propietario (Owner Email), recomendamos utilizar la dirección de correo electrónico de tu administrador de la integración.
- El Método JWK (JWK Method) debe establecerse en URL pública de JWK (Public JWK URL).
- Inserta la información que te proporcionó Gradescope en los siguientes campos:
- La URL del conjunto de herramientas de clave pública (Tool Public Key set URL) en URL pública de JWK (Public JWK URL)
- La URL de inicio de sesión (Login Initiation URL) en URL de iniciación de OpenID Connect (OpenID Connect Initiation URL)
- La URL de inicio/URL de redireccionamiento de la herramienta (Launch URL/Tool Redirect URL) en URL de redirección (Redirect URLs)
- La URL del enlace de destino (Target Link URL) en URL del enlace de destino (Target Link URL)
- Selecciona el menú desplegable Servicios LTI Advantage (LTI Advantage Services) y asegúrate de que las 6 opciones principales estén habilitadas.
- Puedes crear y ver datos de tareas en el boletín de calificaciones asociado con la herramienta (Can create and view assignment data in the gradebook associated with the tool).
- Puedes ver los datos de las tareas en el boletín de calificaciones asociado con la herramienta (Can view assignment data in the gradebook associated with the tool).
- Puedes ver los datos de entrega de las tareas asociadas con la herramienta (Can view submission data for assignments associated with the tool).
- Puedes crear y actualizar los resultados de entrega de tareas asociadas con la herramienta (Can create and update submission results for assignments associated with the tool).
- Puedes recuperar datos de usuario asociados con el contexto en el que está instalada la herramienta (Can retrieve user data associated with the context the tool is installed in).
- Puedes actualizar jwk público para servicios LTI (Can update public jwk for LTI services).
- Expande el menú desplegable Configuración adicional (Additional Settings) y realiza las siguientes modificaciones:
- Para Dominio (Domain), ingresa turnitin.com.
- En Campos personalizados (Custom Fields), agrega la especificación geográfica que prefieras según la instancia que utilizará tu institución:
- Los usuarios de Gradescope.eu deben ingresar: preferred_geography=eu
- Los usuarios de Gradescope.ca deben ingresar: preferred_geography=ca
- Los usuarios de Gradescope.com.au deben ingresar: preferred_geography=ap
Si estás utilizando una instancia de gradescope.com, puedes omitir esto e ir a Campos personalizados (Custom Fields).
- En Campos personalizados (Custom Fields), agrega los datos de los nombres de las secciones a una nueva línea: section_names=$com.instructure.User.sectionNames
- Asegúrate de que el Nivel de privacidad (Privacy Level) esté establecido en Público (Public).
- Para Ubicaciones (Placements), agrega tu preferencia sobre dónde aparecerá Gradescope para tus instructores y estudiantes:
-
Navegación del curso (Course Navigation): muestra Gradescope como una opción en el menú del curso en la barra lateral izquierda. Si se configura, esta ubicación se mostrará de forma predeterminada para todos los cursos de tu institución en el nivel de subcuenta o cuenta raíz (según dónde instales la integración). Esto permitirá a los instructores y estudiantes acceder al curso de Gradescope vinculado y a todas las tareas a través del panel de su curso en Canvas.
Cada instructor puede ocultar el enlace de Navegación del curso (Course Navigation), que se mostrará de forma predeterminada, de su Configuración del curso (Course Settings) en Canvas.
Sin la ubicación de Navegación del curso (Course Navigation), los instructores y estudiantes tendrán que acceder a la configuración y las funciones a nivel de curso de Gradescope, como Sincronizar listas (Roster Sync), al retroceder y usar el enlace de una tarea específica. Esto podría provocar que los instructores tengan problemas para encontrar la opción para sincronizar la lista de cursos, así como que los estudiantes tengan inconvenientes para encontrar tareas de Gradescope que pueden no estar vinculadas con Canvas.
-
Menú de tareas del curso (Course Assignments Menu): muestra Gradescope como una opción en el menú desplegable con puntos (ícono de tres puntos) en la esquina superior derecha de la página Tareas (Assignments). Esto permite a los instructores vincular las tareas nuevas de Canvas con Gradescope. Esta ubicación se necesita para que los instructores vinculen las tareas nuevas de Canvas con las de Gradescope.Recomendamos esta ubicación a los instructores porque se puede localizar con facilidad y requiere la menor cantidad de clics para encontrarla.
Para que los instructores vinculen las tareas existentes y las tareas nuevas de Canvas con las de Gradescope, se necesitan las ubicaciones en el Menú de tareas del curso (Course Assignments Menu) y en Selección de tareas (Assignment Selection).
-
Selección de tareas (Assignment Selection): muestra Gradescope como una opción para los instructores dentro de la tarea de Canvas y se configura en la página de tarea individual en la sección Tipo de entrega (Submission Type). Esto permite a los instructores vincular y crear la tarea como una entrega de una herramienta externa. Esta ubicación se necesita para que los instructores vinculen las tareas existentes de Canvas con las de Gradescope.
Para que los instructores vinculen las tareas existentes y las tareas nuevas de Canvas con las de Gradescope, se necesitan las ubicaciones en el Menú de tareas del curso (Course Assignments Menu) y en Selección de tareas (Assignment Selection).
-
Navegación del curso (Course Navigation): muestra Gradescope como una opción en el menú del curso en la barra lateral izquierda. Si se configura, esta ubicación se mostrará de forma predeterminada para todos los cursos de tu institución en el nivel de subcuenta o cuenta raíz (según dónde instales la integración). Esto permitirá a los instructores y estudiantes acceder al curso de Gradescope vinculado y a todas las tareas a través del panel de su curso en Canvas.
- Deja en blanco la configuración dentro de Navegación del curso (Course Navigation), pero para Menú de tareas del curso (Course Assignments Menu) y Selección de tareas (Assignment Selection), asegúrate de que Seleccionar tipo de mensaje (Select Message Type) esté configurado en LtiDeepLinkingRequest.
- Completaste la configuración de la clave de desarrollador; selecciona Guardar (Save).
- Gradescope ahora aparecerá dentro de tus Claves de desarrollador (Developer Keys). Asegúrate de que tu Estado (State) esté en ENCENDIDO (ON).
- Configura Gradescope para que sea una aplicación externa dentro de Canvas.
- Copia el Identificador del cliente (Client ID) desde debajo de la columna Detalles (Details) de tu clave de desarrollador de Gradescope recién creada.
- Selecciona Configuración (Settings) en la barra de navegación lateral izquierda.
- Elige la pestaña Aplicaciones (Apps) y luego Ver configuración de la aplicación (View App Configuration).
- Desde aquí puedes crear una nueva aplicación externa. Selecciona el botón + App.
- Cambia el Tipo de configuración (Configuration Type) a Por Id. de cliente (By Client ID) e ingresa el Id. que copiaste de la
- columna Detalles de las claves de desarrollador (Developer Key Details).
- Selecciona Enviar (Submit) y luego Instalar (Install) para confirmar.
Gradescope ahora aparecerá como una opción para tus instructores, pero recibirán mensajes de error hasta que se complete la etapa de implementación si intentan crear cursos o asignaciones de Gradescope a través de los enlaces LTI en Canvas.
Paso dos: Configuración en Gradescope
- Ahora que configuraste los detalles necesarios en Canvas, debes ingresar los detalles en Gradescope. Regresa a la página de configuración de LTI 1.3 dentro de Gradescope.
- En el encabezado Detalles del LMS (LMS Details), ingresa la siguiente información en los campos enumerados:
- Si estás configurando una integración de Gradescope LTI 1.3 en una instancia beta o de prueba de Canvas (antes de implementarla en producción):
- Reemplaza cada instancia de la URL base sso.canvaslms.com con sso.test.canvaslms.com o sso.beta.canvaslms.com y mantén el resto de las URL iguales.
- Asegúrate de que el campo Emisor (Issuer) en el paso ii tenga la URL https://canvas.test.instructure.com o https://canvas.beta.instructure.com .
- Para ver un ejemplo, consulta la imagen de detalles del LMS en el paso vii.
- URL del conjunto de claves públicas de la plataforma (Platform public key set URL): https://sso.canvaslms.com/api/lti/security/jwks
-
Emisor (Issuer): https://canvas.instructure.comAsegúrate de copiar el enlace del emisor tal como está. No agregues ningún carácter adicional al final, como una barra (/), o de lo contrario tu intento de registro fallará.
- Identificador del cliente (Client ID): copia el Id. del cliente que se encuentra debajo de la columna Detalles (Details) de tu clave de desarrollador de Gradescope recién creada.
- URL del token de acceso (Access Token URL): https://sso.canvaslms.com/login/oauth2/token
- Punto de conexión de inicio de sesión de OpenID Connect (OpenID Connect login endpoint): https://sso.canvaslms.com/api/lti/authorize_redirect
- Deja Proveedor de autorización de la plataforma (Platform authorisation provider) en blanco.
- Al configurar una instancia de prueba de Canvas, asegúrate de que las URL tengan sso.test.canvaslms.com para sus dominios y que el campo Emisor (Issuer) tenga la URL https://canvas.test.instructure.com o https://canvas.beta.instructure.com, como se muestra en la siguiente imagen.
- Si estás configurando una integración de Gradescope LTI 1.3 en una instancia beta o de prueba de Canvas (antes de implementarla en producción):
- Seleccione Guardar en la página de configuración de Gradescope.
Implementación
Gradescope ya está instalado y aparecerá en tu lista de Herramientas externas. Para completar la configuración, necesitamos vincularla a tu cuenta para que los instructores y estudiantes la puedan utilizar.
- Selecciona Cursos (Courses) en el menú principal a la izquierda y elige un curso.
- Selecciona Gradescope, que ahora aparecerá dentro de la barra de navegación lateral de tu curso.
- Es posible que se te pida que inicies sesión en Gradescope si aún no lo has hecho. Asegúrate de que estás iniciando sesión en la cuenta que tiene habilitados los permisos de integración.
- Ingresa el Nombre de plataforma de marca y selecciona tu escuela. Este será el nombre que los instructores verán en Gradescope cuando se refieran a tu integración con Canvas. Recomendamos usar un nombre que los instructores asocien con facilidad con tu LMS de Canvas. No recomendamos nombrar este campo “Gradescope”, ya que puede causar confusión a los instructores.
- Prueba la integración desde el lado del instructor y del estudiante. Para realizarlo, sigue nuestra Guía de Canvas para instructores y nuestra Guía de Canvas para estudiantes.
¡Ya terminó! Tus instructores ahora pueden vincular sus cursos de Canvas con Gradescope, sincronizar listas, crear y vincular tareas y sincronizar calificaciones entre Gradescope y Canvas.
¿Cómo agregar la aplicación externa Gradescope en el nivel de curso? Si la aplicación Gradescope se agrega en el nivel de subcuenta, la implementación inicial solo deberá realizarse una vez. Si la aplicación externa Gradescope se agrega en el nivel de un curso individual o en cursos que no se encuentran dentro de la subcuenta, los pasos de implementación deberán repetirse cada vez.
Si alguna vez necesitas deshabilitar o volver a habilitar una integración LTI 1.3 anterior, puedes hacerlo navegando a la página de integraciones de LTI 1.3 en tu cuenta de Gradescope, seleccionando Editar (Edit) junto a la integración y marcando o desmarcando la casilla Deshabilitado (Disabled). Deshabilitar una integración desvinculará todos los cursos y las tareas entre Gradescope y Moodle y eliminará las opciones Sincronizar lista (Sync Roster) y Publicar calificaciones (Post Grades). Al volver a habilitar la integración se restaurarán todos los vínculos.