Este documento proporciona a los administradores instrucciones para integrar la plataforma de supervisión de exámenes Verity en Canvas mediante LTI 1.3. Antes de continuar con los pasos a continuación, asegúrese de tener acceso completo a su instancia de Canvas como administrador. Si tiene preguntas sobre el proceso, comuníquese con su gerente de cuenta exclusivo.
Nota: Se recomienda encarecidamente crear una cuenta de servicio independiente en Canvas para la integración. Esto facilita identificar qué acciones realizó la integración y cuáles realizó un administrador humano, lo que ayuda a evitar confusiones o cambios no intencionados.
Agregar Verity a Canvas
Como administrador, puede integrar Verity con Canvas agregando una URL JSON a las claves de desarrollador.
- Inicie sesión en Canvas como administrador. En la barra lateral izquierda, haga clic en Administrador y seleccione la cuenta de Canvas de su institución.
- En la barra lateral, seleccione Administrador > Claves de desarrollador.
- Haga clic en + Clave de desarrollador > + Clave LTI.
- En la página Configuración de la clave, ingrese un nombre para su clave (p. ej., YuJa Verity).
- En el menú desplegable Método, seleccione Ingresar URL.
-
En el campo URL JSON, ingrese una de las siguientes URL según su ubicación:
Zona de EE. UU.: https://zone1.verity.yuja.com/api/verity/lti/config/canvas.json
Zona de Australia: https://az.verity.yuja.com/api/verity/lti/config/canvas.json
- Haga clic en Guardar.
- En la página Claves de desarrollador, ubique la clave de Verity que agregó.
- Asegúrese de que el interruptor del campo Estado esté en ACTIVADO. Si aparece la ventana emergente Activar clave de desarrollador, haga clic en Cambiar a activado.
- Haga clic en Ver en aplicaciones de Canvas. Se abrirá una nueva ventana de Canvas.
-
Haga clic en Desbloquear aplicación.
-
En la ventana emergente, haga clic en Desbloquear.
- A continuación, haga clic en el ícono Modificar disponibilidad (lápiz).
- Cambie el estado a Disponible, y luego haga clic en Guardar. Continúe con Generar un secreto de clave API para completar la integración.
Generar un secreto de clave API
- Haga clic en + Clave de desarrollador > Clave API.
- Ingrese la siguiente información:
- Nombre de la clave: Verity API Integration
-
URLs de redireccionamiento: https://<zoneURL>/api/verity/oauth/callback
- Zona de EE. UU.: https://zone1.verity.yuja.com/api/verity/oauth/callback
-
Zona de Australia: https://az.verity.yuja.com/api/verity/oauth/callback
-
(Opcional) Habilite Aplicar alcances.
Nota: No recomendamos aplicar los alcances. Esto requerirá que vuelva a integrar Verity con la API de Canvas cada vez que Verity agregue nuevas funcionalidades que utilicen la API. Además, si los alcances están habilitados, la aplicación Verity Mobile Lockdown no será compatible. Si su institución utiliza la aplicación Verity Mobile Lockdown, es obligatorio que los alcances estén deshabilitados.Si no desea continuar con esto, asegúrese de que Aplicar alcances esté deshabilitado y luego continúe con el paso 5.
- Marque Permitir parámetros de inclusión y luego marque los siguientes parámetros:
- Cuentas:
- url:GET|/api/v1/accounts
- url:GET|/api/v1/accounts/:id
- url:GET|/api/v1/manageable_accounts
- url:GET|/api/v1/course_creation_accounts
- url:GET|/api/v1/course_accounts
- url:GET|/api/v1/accounts/:account_id/sub_accounts
- url:GET|/api/v1/accounts/:account_id/permissions
- url:GET|/api/v1/accounts/:account_id/courses
- Tareas:
- url:GET|/api/v1/courses/:course_id/assignments
- url:GET|/api/v1/courses/:course_id/assignments/:id
- url:POST|/api/v1/courses/:course_id/assignments
- url:PUT|/api/v1/courses/:course_id/assignments/:id
- Cursos:
- url:GET|/api/v1/courses
- url:GET|/api/v1/courses/:id
- url:GET|/api/v1/accounts/:account_id/courses/:id
- url:GET|/api/v1/users/:user_id/courses
- url:GET|/api/v1/courses/:course_id/users
- url:GET|/api/v1/courses/:course_id/users/:id
- Herramientas externas:
- url:GET|/api/v1/courses/:course_id/external_tools/:external_tool_id
- url:GET|/api/v1/courses/:course_id/external_tools
- url:GET|/api/v1/courses/:course_id/external_tools/sessionless_launch
- url:GET|/api/v1/accounts/:account_id/external_tools/sessionless_launch
- Elementos de nuevos cuestionarios:
- url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items/:item_id
- url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items
- url:POST|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items
- url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id/items/:item_id
- Cuestionarios:
- url:GET|/api/v1/courses/:course_id/quizzes
- url:GET|/api/v1/courses/:course_id/quizzes/:id
- url:POST|/api/v1/courses/:course_id/quizzes
- url:PUT|/api/v1/courses/:course_id/quizzes/:id
- url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
- url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
- url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
- url:PUT|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
- url:POST|/api/v1/courses/:course_id/quizzes/:id/validate_access_code
- url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
- url:GET|/api/quiz/v1/courses/:course_id/quizzes
- url:POST|/api/quiz/v1/courses/:course_id/quizzes
- url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
- Preguntas de cuestionarios:
- url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
- url:GET|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
- url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/questions
- url:PUT|/api/v1/courses/:course_id/quizzes/:quiz_id/questions/:id
- Usuarios:
- url:GET|/api/v1/users/:id
- url:GET|/api/v1/accounts/:account_id/users
- Cuentas:
-
Haga clic en Guardar en la esquina inferior derecha.
- Copie el secreto de la clave API que aparece en la ventana emergente Clave de desarrollador creada y luego haga clic en Cerrar.
-
Asegúrese de que el interruptor de Estado de la nueva clave API esté habilitado.
- Comuníquese con su gerente de cuenta y proporciónele su secreto de clave API para finalizar las configuraciones del LMS para Verity.
Probar el acceso a la API de YuJa Verity
Una vez que su gerente de cuenta complete la integración, puede probar la API REST para asegurarse de que los instructores puedan eliminar cuestionarios de Verity y crear cuestionarios de práctica de Verity en Canvas.
- En Canvas, haga clic en el enlace YuJa Verity de la barra lateral para abrir el portal de Verity.
- En Verity, seleccione Configuración > Configuración de integración en la barra de navegación lateral.
- Seleccione API de LMS en el menú desplegable Seleccionar integración.
- En la sección Claves de acceso, haga clic en Probar acceso a la institución para verificar que su cuenta de Canvas esté integrada con la API.
- Confirme que el acceso a la API sea correcto tanto para Leer cuentas como para Leer cursos.
Nota: Si el acceso a la API falla, comuníquese con su gerente de cuenta para actualizar la clave API de su institución. - Haga clic en Cerrar.
Agregar el LMS Visualizer a Canvas
Como administrador, puede agregar código JavaScript en el Editor de temas para supervisar la extensión del navegador Verity. Con el código JavaScript habilitado, se guiará a quienes realicen la evaluación para que descarguen la extensión del navegador Verity antes de acceder a la evaluación. No podrán acceder a la evaluación a menos que la extensión del navegador esté instalada.
- En Canvas, haga clic en el enlace YuJa Verity de la barra lateral para abrir el portal de Verity.
- En Verity, seleccione Configuración > Configuración de integración en la barra de navegación lateral.
- Seleccione LMS Visualizer en el menú desplegable Seleccionar integración.
- Haga clic en Ver visualizador.
- Copie el código JavaScript que aparece en la nueva pestaña.
- Dentro de Canvas, seleccione Temas en la barra de navegación lateral.
- Pase el cursor sobre su tema y haga clic en Abrir en el Editor de temas.
- En el panel izquierdo, haga clic en la pestaña Cargar .
- Ubique el campo Archivo JavaScript, luego haga clic en Ver archivo para abrir la página del código JavaScript.
- Haga clic con el botón derecho en la página del código JavaScript y seleccione Guardar como para guardar el archivo en su dispositivo.
- Abra su archivo en un editor de texto (p. ej., el Bloc de notas) y pegue al final el código JavaScript copiado en el paso 5.
- Guarde su archivo en su editor de texto.
- En su Editor de temas, ubique el campo Archivo JavaScript y haga clic en Seleccionar para cargar su archivo.
- Ubique el campo Archivo JavaScript de la aplicación móvil , luego haga clic en Ver archivo para abrir la página del código JavaScript.
- Haga clic con el botón derecho en la página del código JavaScript y seleccione Guardar como para guardar el archivo en su dispositivo.
- Abra su archivo en un editor de texto (p. ej., el Bloc de notas) y pegue al final el código JavaScript copiado en el paso 5.
- Guarde su archivo en su editor de texto.
- En su Editor de temas, ubique el campo Archivo JavaScript de la aplicación móvil y haga clic en Seleccionar para cargar su archivo.
- Haga clic en Previsualizar sus cambios.
- Haga clic en Guardar tema.
- Haga clic en Aplicar tema para agregar la nueva configuración del tema.