Una organización, varios Moodle
Una organización puede tener varias conexiones con Moodle — tantas como permita tu plan, y la página te dice cuántas plazas quedan. Cada conexión es 1:1 con una instalación (producción y pruebas, o una por institución) y tiene sus propias credenciales, sus claves, su URL de conector y su uso.
Registra el sitio
-
Abre Organización → Moodle y rellena Conectar un sitio Moodle: un slug de la conexión — letras minúsculas, dígitos y guiones, por ejemplo main-campus — y la URL de Moodle del sitio. HTTPS es obligatorio y la URL se valida contra rangos de direcciones privadas, así que un sitio no accesible públicamente se rechaza aquí.
-
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 la URL del conector de esta conexión — no es un secreto y puedes volver a consultarla en la página de la conexión cuando quieras.
-
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.