Saltar al contenido principal

Guía de integración POK + Open edX

Esta guía explica cómo conectar Open edX con POK Proof of Knowledge para que tu plataforma emita credenciales digitales verificables de forma automática cuando un estudiante completa un curso. Configurarás un template de certificado y una API key en POK, habilitarás la integración en Django Admin y activarás los certificados en Open edX Studio.

Parte 1: Configurar la plataforma POK​

Crear o personalizar un template de certificado​

  1. Inicia sesión en tu panel de POK a través del selector de región.

  2. Abre Diseños.

  3. Crea un template nuevo o edita uno existente.

  4. Configura los atributos obligatorios:

    • Título
    • Nombre de la organización
    • Achiever (destinatario)

    También puedes crear atributos opcionales personalizados, por ejemplo la nota o el firmante.

  5. Guarda tu template.

Para más detalle sobre cómo crear templates, consulta Designs.

Generar tu API key​

  1. Abre el menú de tu perfil.

  2. Ve a Integraciones.

  3. Busca la opción OPEN edX en la lista de plataformas y haz clic en Connect.

  4. Copia la API key generada y guárdala en un lugar seguro. Es la única vez que será visible.

Luego la usarás en la configuración de Open edX así:

"POK_API_KEY": "your_api_key_here"

Guardar la API key en Open edX​

  1. Accede a Django Admin: inicia sesión en tu LMS como superusuario y ve a https://<tu-dominio-lms>/admin.

  2. Busca Site Configurations: la sección puede llamarse Self_Paced o Site_Configuration según la versión de Open edX.

  3. Agrega o edita la configuración:

    • Haz clic en Add site configuration, o abre tu sitio existente para editarlo.
    • Selecciona tu Site en el menú desplegable.

  4. Inserta la API key: en el campo Values, agrega tu clave como una propiedad JSON. Si el campo está vacío, debe quedar así:

{
  "POK_API_KEY": "your_api_key_here"
}

Si ya existen valores, agrega una coma después del último elemento y luego añade la nueva propiedad.

  1. Activa y guarda: marca la casilla Enabled y haz clic en Save.

Parte 2: Habilitar POK en Open edX (configuración de administrador)​

Para activar POK dentro de Open edX debes habilitar un feature flag. Este flag permite que Open edX se comunique con los servicios de POK.

  1. Entra a /admin como staff o superusuario.

  2. Ve a DJANGO-WAFFLE → Flags.

  3. Haz clic en Add flag.

  4. Configura el flag:

    • Name: module_pok.enable (debe coincidir exactamente).
    • Everyone: marca esta casilla para habilitar la función para todos los usuarios de inmediato.
    • Enabled: verifica que esta casilla esté marcada.

  5. Haz clic en Save.

Parte 3: Configurar los certificados del curso en Studio​

Dentro de Open edX Studio:

  1. Crea o abre un curso.

  2. Construye la estructura del curso (secciones, unidades, lecciones).

  3. Ve a Settings → Certificates.

  4. Completa los datos que se enviarán a POK:

    • Título del curso
    • Nombre del firmante
    • Cargo del firmante
    • Nombre de la organización

  5. Haz clic en Activate para habilitar los certificados.

Esta información se enviará automáticamente a POK cuando se solicite un certificado.

Parte 4: Idioma de los emails de certificados (opcional)​

En Site Preferences puedes definir el idioma de la plataforma. El idioma seleccionado ahí determina el idioma de los correos de certificados que envía POK.

Configurar múltiples idiomas en POK​

Si tu plataforma usa más de un idioma:

  1. Ve a POK.

  2. Busca la sección Branding.

  3. Haz clic en Customize en la sección Emails.

  4. En el selector de idiomas, marca todos los idiomas que quieras habilitar, según los idiomas configurados en tu plataforma Open edX.

  5. Haz clic en Save.

Parte 5: Configuración técnica, el modelo CertificateTemplate​

En Django Admin, el modelo CertificateTemplate permite configurar por curso:

  • template_id: el template de POK que se usará, creado en la Parte 1.

  • emission_type: el tipo de emisión.

    • Valor POK: credencial básica, gratuita. Los destinatarios pueden ver y compartir su credencial en la web sin costo. Es una imagen disponible desde el sitio de POK.
    • Valor blockchain: credencial blockchain, de pago. Las credenciales se emiten como credenciales blockchain NFT, más seguras y permanentes. Pueden verse en la web y en Polygonscan.

  • course_id: el curso vinculado.

Esta estructura permite que cada curso emita certificados con la configuración de su propio template.

Tu plataforma Open edX ya está integrada con los certificados digitales de POK. Los estudiantes pueden completar cursos y recibir credenciales verificables al instante.

Experiencia del estudiante​

Solicitar la credencial desde el curso​

Desde la perspectiva del estudiante, el proceso es simple:

  1. El estudiante completa los requisitos del curso.

  2. Hace clic en Request Certificate.

  3. Open edX envía una solicitud a POK vía API y el estudiante recibe un email con su credencial generada.

  4. Después de unos segundos, actualiza la página del curso.

  5. Aparece el botón View My Certificate, que abre el certificado alojado en POK.

Validación del certificado​

Cada certificado incluye verificación integrada. El estudiante puede:

  • Abrir los detalles del certificado.
  • Hacer clic en Validate credential. Este paso garantiza la autenticidad y previene fraudes.
  • Confirmar su identidad.
  • Descargar o compartir la credencial de forma segura.

Resultado final​

Después de completar la integración:

  • Los certificados se emiten automáticamente.
  • Las credenciales son seguras y verificables.
  • Los estudiantes reciben certificados digitales profesionales.
  • El sistema es modular y fácil de mantener.

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.