Conectar tu sitio

Una organización, un Moodle

Cada organización es propietaria de exactamente una conexión con Moodle. Como la conexión es 1:1 con una instalación, si tienes varias (producción y pruebas, o varias instituciones) necesitas una organización por instalación: cada una tiene su endpoint, sus claves y su uso.

Registra el sitio

1. Abre Organización → Moodle e introduce la URL de tu Moodle. HTTPS es obligatorio y la URL se valida contra rangos de direcciones privadas, así que un sitio no accesible públicamente se rechaza aquí.

2. El panel genera dos credenciales y las muestra una sola vez:

   • la clave de licencia, que identifica tu instalación;
   • el secreto del panel, con el que se firma cada petición entre el plugin y el panel.

   Junto a ellas verás también tu subdominio y la URL de tu endpoint MCP — estos dos no son secretos y puedes volver a consultarlos en esta misma página cuando quieras.

3. Copia los valores y pégalos en el plugin: consulta el plugin de Moodle.

Tener solo la clave de licencia no otorga nada: cada petición debe llevar además una firma válida calculada con el secreto, así que el par solo funciona junto.

Verifica el enlace

El botón Validar licencia del plugin confirma las credenciales y que la URL registrada en el panel coincide con la del sitio que llama. Una vez verificado, el panel guarda en caché el nombre, la versión y el idioma de tu sitio a partir de la propia información del sitio de Moodle, y los muestra en la página de Moodle.

Si la comprobación falla, la resolución de problemas cubre las causas habituales.

Rota las credenciales

Organización → Moodle → Rotar credenciales invalida de inmediato la clave de licencia y el secreto actuales y emite un par nuevo, mostrado una sola vez. Todos los propietarios y administradores reciben una notificación de seguridad.

Conviene rotar cuando:

• el secreto puede haberse expuesto (enviado por correo, subido a un repositorio, visto por alguien que ya no está);
• migras el sitio a otro servidor o proveedor de alojamiento;
• has perdido los valores y necesitas un par que funcione.

La conexión deja de funcionar hasta que pegues el par nuevo en el plugin, así que cuenta con unos minutos de corte para los asistentes.

Cambiar la URL del sitio

Cambiar la URL vuelve a ejecutar la misma validación. Si tu Moodle cambia de dominio, actualízala aquí primero y vuelve a validar desde el plugin. Las claves siguen funcionando: están ligadas a la conexión, no al nombre de host.

Desconectar

Al desconectar se eliminan las credenciales guardadas y los tokens cifrados de Moodle, y el endpoint MCP deja de resolverse. Las claves existentes dejan de funcionar de inmediato. Los tokens de servicio web siguen en tu Moodle hasta que los elimines allí, así que revoca también los usuarios en el plugin si vas a dar de baja el sitio.