Ir a YuJa
  1. Centro de Ayuda de YuJa
  2. Plataforma de accesibilidad LMS Panorama
  3. Integración de Canvas
  4. Administradores

Integración de Panorama en Canvas mediante LTI 1.3

Avatar
YuJa
  • Actualización

Este documento ofrece a los administradores instrucciones para integrar la plataforma Panorama en Canvas mediante LTI 1.3. Antes de continuar con los pasos siguientes, 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 dedicado.
 

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 deseados.

 

Obtener su cadena JSON de Panorama

Antes de agregar Panorama a su instancia de Canvas, deberá obtener su cadena JSON. Para acceder a su cadena JSON, debe haber recibido un correo electrónico de su gerente de cuenta en el que se le pide registrarse para obtener su cuenta de Panorama. Regístrese y luego continúe con los pasos siguientes. 

  1. Inicie sesión en su cuenta de Panorama.
  2. Haga clic en Configuraciones en el menú del lado izquierdo y luego seleccione Configuración de Integración.
  3. Seleccione LTI 1.3.
  4. Haga clic en Descargar JSON de LTI 1.3 para obtener su cadena JSON de Panorama. 

Agregar Panorama a Canvas

Una vez que haya obtenido su cadena JSON, puede agregar Panorama a su instancia de Canvas. 

  1. 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.
  2. En la barra lateral, seleccione Administrador > Claves de desarrollador.
  3. Haga clic en + Clave de desarrollador > + Clave LTI.
  4. Abra el menú desplegable Método y seleccione Pegar JSON.
  5. Abra el archivo JSON descargado en la sección anterior con cualquier editor de texto, como el Bloc de notas, y copie su contenido. Las URL de redirección se agregarán automáticamente.
  6. A continuación, pegue el contenido copiado en el campo Configuración de LTI 1.3.

  7. Escriba un Nombre de la clave de su elección y haga clic en Guardar.

    Nota: Si desea que la herramienta LTI esté deshabilitada de forma predeterminada en la barra de navegación del curso, agregue el siguiente parámetro en la sección de navegación del curso: "default": "disabled".

    El parámetro para configurar el enlace LTI de Panorama se inserta en el código.

  8. Active el interruptor Estado de la clave de desarrollador.
  9. Haga clic en Ver en aplicaciones de Canvas. Se abrirá una nueva ventana de Canvas.
  10. Haga clic en el ícono del lápiz.
  11. Cambie el estado a Disponible, y luego haga clic en Guardar.
  12. Copie la Identificación del cliente.
  13. A continuación, seleccione Configuración en la barra de navegación.
      
  14. Seleccione Aplicaciones en la fila superior y luego seleccione Ver configuraciones de aplicaciones.
  15. Seleccione +Aplicación en la parte superior derecha de la pantalla.
  16. En Tipo de configuración, seleccione Por ID de cliente.
  17. Pegue la Identificación del cliente copiada anteriormente. Tome nota de ella, ya que se seguirá necesitando.
  18. Haga clic en Enviar para crear la aplicación.
  19. Seleccione el ícono de Engranaje junto a la aplicación recién creada.
  20. En el menú desplegable, seleccione Id. de implementación y copie el ID. Se necesitará en el paso 24 de esta sección.
  21. A continuación, inicie sesión en su cuenta de Panorama.
  22. Haga clic en Configuraciones en el menú del lado izquierdo y luego seleccione Configuración de Integración.
  23. Abra el menú desplegable Seleccione la integración y seleccione LTI 1.3.
  24. Ingrese la información necesaria según su entorno de Panorama (tipo de cuenta): 
    1. Entorno de producción: 
      1. Identificación del cliente: La Identificación del cliente que se copió en el paso 12. 
      2. Id. de implementación: El Id. de implementación que se copió en el paso 20. 
      3. ISS: https://canvas.instructure.com
      4. Extremo de OIDC: https://canvas.instructure.com/api/lti/authorize_redirect
      5. Extremo de JWKS: https://canvas.instructure.com/api/lti/security/jwks
         
    2. Entorno de prueba:
      1. Identificación del cliente: La Identificación del cliente que se copió en el paso 12. 
      2. Id. de implementación: El Id. de implementación que se copió en el paso 20. 
      3. ISS: https://canvas.test.instructure.com
      4. Extremo de OIDC: https://canvas.test.instructure.com/api/lti/authorize_redirect
      5. Extremo de JWKS: https://canvas.test.instructure.com/api/lti/security/jwks
         
    3. Entorno beta:
      1. Identificación del cliente: La Identificación del cliente que se copió en el paso 12. 
      2. Id. de implementación: El Id. de implementación que se copió en el paso 20. 
      3. ISS: https://canvas.beta.instructure.com
      4. Extremo de OIDC: https://canvas.beta.instructure.com/api/lti/authorize_redirect
      5. Extremo de JWKS: https://canvas.beta.instructure.com/api/lti/security/jwks
  25. Haga clic en Guardar cambios para agregar Panorama a su instancia de Canvas y luego continúe con la siguiente sección de esta guía.

     
     

Generar una clave y un secreto de cliente

  1. Haga clic en + Clave de desarrollador > Clave de API.
    1.png

  2. Ingrese la siguiente información:

    • Nombre de la clave: Panorama API Integration
    • URL de redirección: https://<zoneURL>/canvas-auth
      • Zona de EE. UU.: https://panorama-api.yuja.com/canvas-auth
      • Zona de Canadá: https://panorama-api-cz.yuja.com/canvas-auth
      • Zona de la UE: https://panorama-api-ez.yuja.com/canvas-auth
      • Zona de Australia: https://panorama-api-az.yuja.com/canvas-auth

    2.png

  3. (Opcional) Habilite Aplicar ámbitos.
    Nota: No recomendamos aplicar ámbitos. Deberá volver a integrar Panorama con la API de Canvas cada vez que Panorama agregue nuevas funciones que usen la API. Si no desea hacerlo, asegúrese de que Aplicar ámbitos esté deshabilitado y luego continúe con el paso 5. 
  4. Marque Permitir parámetros de inclusión y luego marque los siguientes parámetros:
    3.png
    • Cuentas
      • url:GET|/api/v1/accounts
      • url:GET|/api/v1/accounts/:id
      • url:GET|/api/v1/accounts/:account_id/courses
      • url:GET|/api/v1/accounts/:account_id/sub_accounts
    • Administradores
      • url:GET|/api/v1/accounts/:account_id/admins
    • Tareas
      • url:GET|/api/v1/courses/:course_id/assignments
      • url:GET|/api/v1/courses/:course_id/assignments/:id
      • 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/courses/:course_id/users
      • url:GET|/api/v1/courses/:course_id/users/:id
      • url:PUT|/api/v1/courses/:id
      • url:POST|/api/v1/courses/:course_id/files
    • Temas de discusión
      • url:GET|/api/v1/courses/:course_id/discussion_topics
      • url:GET|/api/v1/courses/:course_id/discussion_topics/:topic_id
      • url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id
      • url:PUT|/api/v1/courses/:course_id/discussion_topics/:topic_id/entries/:id
    • Inscripciones
      • url:GET|/api/v1/users/:user_id/enrollments
      • url:GET|/api/v1/courses/:course_id/enrollments 
    • Períodos de inscripción
      • url:GET|/api/v1/accounts/:account_id/terms
      • url:GET|/api/v1/accounts/:account_id/terms/:id
    • Archivos
      • url:GET|/api/v1/courses/:course_id/files
      • url:GET|/api/v1/files/:id
      • url:POST|/api/v1/files/:id
      • url:PUT|/api/v1/files/:id
    • Páginas
      • url:GET|/api/v1/courses/:course_id/pages
      • url:GET|/api/v1/courses/:course_id/pages/:url_or_id
      • url:PUT|/api/v1/courses/:course_id/pages/:url_or_id
      • url:POST|/api/v1/courses/:course_id/pages
    • Cuestionarios
      • url:GET|/api/v1/courses/:course_id/quizzes
      • url:GET|/api/v1/courses/:course_id/quizzes/:id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
      • url:GET|/api/quiz/v1/courses/:course_id/quizzes
      • url:PUT|/api/v1/courses/:course_id/quizzes/:id
      • url:PATCH|/api/quiz/v1/courses/:course_id/quizzes/:assignment_id
    •  Roles
      • url:GET|/api/v1/accounts/:account_id/roles
      • url:GET|/api/v1/accounts/:account_id/roles/:id
    • Rúbricas
      • url:GET|/api/v1/courses/:course_id/rubrics
      • url:GET|/api/v1/courses/:course_id/rubrics/:id
    • Enlaces de recursos LTI
      • url:GET|/api/v1/courses/:course_id/lti_resource_links
      • url:GET|/api/v1/courses/:course_id/lti_resource_links/:id
  5. Haga clic en Guardar.
    4.png
  6. Busque la clave de desarrollador Panorama API Integration recién creada y copie la Identificación del cliente en Detalles.
  7. Haga clic en Mostrar clave y copie el Secreto del cliente.
  8. Inicie sesión en Panorama y, en el menú del lado izquierdo, haga clic en Configuración > Configuración de Integración.
    7.png
  9. Abra el menú desplegable Seleccione la integración y seleccione API de LMS.
  10. Haga clic en Agregar clave de acceso.
    9.png
  11. Para el método de autenticación de Canvas, elija Identificación del cliente.
  12. En el campo Identificación del cliente ingrese el ID del paso 8.
  13. En el campo Secreto del cliente ingrese el secreto del cliente del paso 9.
  14. Si aplicó ámbitos, habilite Usar Ámbitos Forzados. De lo contrario, omita este paso.
  15. Haga clic en Autenticar con Canvas.
    Nota: Asegúrese de haber iniciado sesión en Canvas como administrador con todos los privilegios.
  16. Haga clic en Autorizar.
    13.png
  17. Copie la respuesta de autenticación y regrese a Panorama. Pegue la respuesta en el campo Respuesta de Autenticación de Canvas.
  18. Haga clic en Agregar clave de acceso.
  19. Haga clic en Guardar cambios para completar la configuración.
    15.png

Instalar LMS Visualizer 

Instalar LMS Visualizer permitirá que los íconos de Panorama aparezcan dentro de los cursos. Este paso requiere que su instancia de Canvas tenga habilitada la función de anulaciones personalizadas de CSS/JavaScript. Si no está habilitada, comuníquese con su gerente de cuenta de Canvas.

  1. Inicie sesión en Panorama.
  2. Haga clic en Configuraciones en el menú del lado izquierdo y luego seleccione Configuración de Integración.
  3. Abra el menú desplegable Seleccione la integración y elija LMS Visualizer y, a continuación, haga clic en Descargar Visualizador.
  4. A continuación, inicie sesión en Canvas como Administrador. En la barra lateral izquierda, haga clic en Administrador y seleccione la Cuenta en la que aplicará YuJa Panorama - LMS Viewer.
  5. Seleccione Configuración en la barra de navegación del lado izquierdo y asegúrese de que la pestaña de configuración esté seleccionada en la fila superior. 
  6. A continuación, haga clic en Temas en la barra de navegación del lado izquierdo y luego haga clic en el botón + Tema. Seleccione cualquier plantilla de tema en la lista desplegable.

  7. En el editor de temas, vaya a la pestaña Cargar y seleccione el archivo Visualizer que se descargó. 

    Nota: La pestaña Cargar solo está disponible una vez que su gerente de cuenta de Canvas la habilite.

  8. A continuación, haga clic en Vista previa de los cambios, y luego elija Aplicar tema. Cuando se le pida que asigne un nombre a su tema, escriba Panorama Theme.

Artículos relacionados

Comuníquese con soporte