Saltar al contenido principal

Integración de Brightspace D2L con POK LTI

Puedes conectar POK Proof of Knowledge con Brightspace D2L mediante LTI para emitir y gestionar credenciales digitales directamente desde tus cursos. La configuración tiene dos partes: un administrador instala y registra la herramienta POK en Brightspace, y luego los instructores agregan actividades POK a sus cursos y configuran cómo se emite cada credencial.

Instalar la herramienta POK en Brightspace​

Paso 1: Conectar POK con tu LMS​

  1. Ingresa a tu plataforma POK.
  2. Abre el menú superior derecho y selecciona Integraciones.
  3. Busca Brightspace en la lista de plataformas.
  4. Haz clic en Conectar.

Se abrirá un formulario donde debes ingresar:

  • Nombre de integración: usa un nombre descriptivo, por ejemplo Brightspace Universidad - POK.
  • Tu URL: pega la URL de tu LMS.
  • Client ID
  • Client Secret

Para obtener el Client ID y el Client Secret, sigue las dos partes siguientes.

Parte 1: Obtener el Client ID en Brightspace​

  1. Ingresa a Brightspace con rol de administrador.
  2. Ve a Admin Tools (el ícono de engranaje).
  3. Abre Manage Extensibility.
  4. Haz clic en la pestaña Service Users.
  5. Selecciona New Service User para crear un nuevo usuario de servicio.
tip

Si no ves la opción para crear un nuevo Service User, tu cuenta no tiene el permiso necesario. Pídele al administrador principal de tu institución que te lo asigne.

  1. Una vez creado el Service User, asígnale las unidades de organización donde estarán disponibles las actividades de POK.
  2. Dentro del Service User, define los permisos en All para el conjunto general de opciones.
  3. Abre el menú, elige Grades y marca las casillas de los siguientes permisos:
    • See user grade values (API Only)
    • Retrieve Grade Values for Course Offering Descendants (API Only)

Parte 2: Registrar la app OAuth 2.0​

  1. Selecciona la pestaña OAuth 2.0.

  2. Haz clic en Register App.

  3. Completa el formulario con estos valores:

    • Grant Type: selecciona Client Credentials.
    • JWKS URL: ingresa la URL que corresponda a tu entorno:
      • Producción: https://lti.pok.tech/.well-known/lti-jwks.json
      • QA / Testing: https://lti.credentity.xyz/.well-known/lti-jwks.json
    • Scopes:
    content:modules:manage content:topics:manage core:*:* grades:gradevalues:read grades:gradeobjects:read ltiadvantage:*:*
    • En Add Service Users, selecciona el Service User que creaste en la Parte 1.
    • Access Token Lifetime: 3600

  4. Guarda la aplicación.

tip

Si no ves la opción Client Credentials, tu usuario no tiene el permiso correspondiente. Solicítalo al administrador de tu institución.

Paso 2: Registrar la herramienta POK en Brightspace​

  1. Accede a Brightspace D2L con rol de Administrador.
  2. Abre el menú Admin Tools (ícono de engranaje en la esquina superior derecha).
  3. Selecciona Manage Extensibility.
  4. Ve a la pestaña LTI Advantage y haz clic en Register Tool.
  5. Selecciona Dynamic Registration.
  6. Pega la URL dinámica que copiaste desde POK.
  7. Asegúrate de que la casilla Configure deployment esté activada y haz clic en Registrar.
  8. Se abrirá una ventana emergente de POK que confirma que el registro fue exitoso. Haz clic en Cerrar.

No veo la pestaña LTI Advantage​

Si la pestaña LTI Advantage no aparece en Manage Extensibility, tu rol no tiene los permisos necesarios. Actívalos así:

  1. Inicia sesión en tu entorno de Brightspace.

  2. Haz clic en el ícono de engranaje de la esquina superior derecha y selecciona Admin Tools.

  3. Abre Roles and Permissions. Verás la lista de roles configurados en tu institución.

  4. Haz clic en el rol que usas para la instalación (por ejemplo, Administrator o Instructor). Brightspace muestra todos los permisos asignados a ese rol.

  5. Busca en la página (Ctrl + F) o desplázate hasta la sección External Learning Tools y marca los permisos necesarios para LTI Advantage:

    • Manage LTI Advantage
    • Manage LTI Links
    • Manage LTI Deployments
    • Manage LTI Settings (opcional, pero recomendado)

  6. Marca también los permisos heredados para compatibilidad con versiones anteriores:

    • Manage External Learning Tools
    • Manage LTI Tool Providers

    Los nombres pueden variar según el idioma, pero siempre están dentro de la categoría External Learning Tools.

  7. Haz clic en Save and Close.

  8. Vuelve a Admin Tools, abre Manage Extensibility y confirma que ahora aparece la pestaña LTI Advantage. Luego continúa con los pasos de registro anteriores.

Verificar la configuración del registro​

  1. Activa el registro con el botón Enable.
  2. Dentro del registro, abre la configuración y verifica que las siguientes Extensions estén marcadas:
    • Assignment and Grade Services
    • Names and Role Provisioning Services
  3. Guarda y cierra el registro.

Paso 3: Crear un deployment​

El deployment asocia la herramienta registrada con tu entorno.

  1. Abre el menú Admin Tools (ícono de engranaje en la esquina superior derecha).
  2. Selecciona External Learning Tools.
  3. Haz clic en New Deployment.
  4. En el desplegable Tool, selecciona el registro de POK LTI que acabas de crear.
  5. Asigna un nombre al deployment.
  6. Activa la opción Enabled para que la herramienta quede disponible.

Luego confirma que las siguientes configuraciones estén marcadas dentro del deployment.

Extensiones requeridas:

  • Assignment and Grade Services
  • Names and Role Provisioning Services

Configuración de seguridad (Security Settings), activa estas casillas:

  • Org Unit Information
  • User Information
  • Link Information
  • Classlist including users not known to this deployment

Disponibilidad: selecciona las organizaciones donde quieres que la herramienta esté disponible (organizaciones raíz, descendientes o ambas). Luego guarda la configuración.

  1. En el deployment de POK que acabas de crear, haz clic en el botón View Links.
  2. Selecciona New Link para crear un nuevo enlace.
  3. Asigna un nombre al enlace, por ejemplo "POK Credentials".
  4. En el campo de URL, ingresa: https://lti.pok.tech/lti/launch
  5. En Type of Link, selecciona Basic Launch.
  6. Guarda y cierra el nuevo enlace.

Agregar la vista Course Level​

Si quieres una vista general que muestre el estado de todas las credenciales emitidas en el curso, crea un segundo enlace:

  1. En el deployment de POK, haz clic en el botón View Links.

  2. Selecciona New Link para crear un nuevo enlace.

  3. Configura el enlace:

    • Nombre del enlace: usa un nombre descriptivo, por ejemplo "Course Level" o "Vista general del curso".
    • URL: copia y pega la siguiente URL:
    https://lti.pok.tech/lti/course-level

  4. Guarda los cambios para completar la configuración.

Este enlace permite a los usuarios acceder a la vista a nivel de curso.

Agregar una actividad POK dentro de un curso​

  1. Ingresa al curso donde quieres agregar la actividad, con rol de administrador o instructor.
  2. Abre Content.
  3. Selecciona una unidad existente o crea una nueva con el botón + New Unit.
  4. Haz clic en Add Existing y selecciona External Tool Activity.
  5. Verás la lista de todos los enlaces configurados en tu deployment.
  6. Busca el nombre del enlace de POK que creaste antes.
  7. Haz clic sobre él. La actividad se agrega automáticamente como recurso dentro del módulo de contenido.

Listo: la herramienta POK LTI ya está instalada e integrada en Brightspace D2L. Los instructores y estudiantes pueden emitir y ver credenciales directamente desde sus cursos.

Configurar la emisión de la credencial​

Una vez guardada la actividad, haz clic sobre ella para abrir la configuración LTI y completa el formulario:

  • Selecciona el diseño de la credencial.
  • Vincula una página personalizada y una ruta de aprendizaje (opcional).
  • Define si la credencial tendrá fecha de expiración.
  • Mapea los atributos personalizados del diseño con los datos disponibles del estudiante.
  • Elige el tipo de credencial: básica o blockchain.
  • Define el idioma del correo que recibirá el estudiante.

Opción A: Autoemisión por evaluación​

Puedes hacer que la credencial se emita automáticamente cuando el estudiante apruebe una evaluación. Define esta condición como parte de la configuración de emisión.

Opción B: Sin condiciones de emisión​

Si prefieres que no haya requisitos previos, omite la opción A. En este caso, los estudiantes pueden abrir el ítem de la credencial dentro del curso y generarla manualmente.

Guardar la configuración​

Después de completar toda la información, guarda la configuración. Tu credencial POK queda lista para emitirse automáticamente o bajo demanda, según lo que hayas seleccionado.

Ver el listado de credenciales​

Una vez que hayas configurado una credencial en tu curso, puedes revisar su estado y, si es necesario, editar su configuración.

Para abrir el listado, haz clic sobre el ítem de la credencial dentro del módulo del curso. Muestra el estado de cada estudiante, y desde allí puedes ver y gestionar la emisión.

Qué significan los estados​

  • Pendiente: la credencial aún no fue generada ni enviada al estudiante.
  • Enviado: la credencial fue generada y el estudiante recibió un correo con el enlace para aceptarla.
  • Aceptado: el estudiante aceptó la credencial desde el correo y esta ya fue emitida correctamente.

Enviar credenciales manualmente​

Puedes enviar credenciales en cualquier momento a los estudiantes que cumplan con los criterios definidos:

  1. Haz clic en el botón "Enviar".
  2. Solo se envían credenciales a los estudiantes con estado Pendiente.
  3. Si un estudiante ya tiene estado Enviado o Aceptado, la credencial no se vuelve a enviar.

Editar una credencial​

Si necesitas cambiar la configuración de una credencial, usa el botón "Configurar emisión". Puedes actualizar los datos visibles en la credencial.

Vista Course Level​

Cuando un instructor o administrador abre el enlace de Course Level, ve un panel con todas las credenciales y certificados disponibles en el curso:

  • Credenciales Enviadas: total de credenciales enviadas a los estudiantes.
  • Credenciales Aceptadas: total de credenciales aceptadas por los estudiantes.
  • Listado de Certificados: cada credencial con su estado de automatización y la cantidad de envíos completados.

Este panel le permite al instructor o administrador:

  • Monitorear el progreso de las credenciales en tiempo real.
  • Gestionar certificados desde un único lugar sin salir de Brightspace.
  • Verificar la automatización de las credenciales.
  • Analizar la participación de los estudiantes en cada certificado.
  • Acceder rápidamente a los detalles y enlaces de cada credencial.

Más información​

Para conocer cómo las integraciones LTI de POK se conectan con tu LMS y otros sistemas, visita la página de la funcionalidad de integraciones con LMS y CRM.