Connecter votre site

Une organisation, un Moodle

Chaque organisation possède exactement une connexion Moodle. Comme la connexion est en 1:1 avec une installation, si vous en avez plusieurs (production et préproduction, ou plusieurs établissements), vous avez besoin d'une organisation par installation : chacune a son point de terminaison, ses clés et son utilisation.

Enregistrez le site

1. Ouvrez Organisation → Moodle et saisissez l'URL de votre Moodle. HTTPS est obligatoire et l'URL est validée contre les plages d'adresses privées : un site non joignable publiquement est refusé ici.

2. Le panneau génère deux identifiants et les affiche une seule fois :

   • la clé de licence, qui identifie votre installation ;
   • le secret du panneau, utilisé pour signer chaque requête entre le plugin et le panneau.

   À côté, vous verrez aussi votre sous-domaine et l'URL de votre point de terminaison MCP — ces deux-là ne sont pas des secrets et vous pouvez les consulter à nouveau sur cette même page quand vous voulez.

3. Copiez les valeurs et collez-les dans le plugin : voir le plugin Moodle.

Détenir la seule clé de licence ne donne rien : chaque requête doit aussi porter une signature valide calculée avec le secret, donc la paire ne fonctionne qu'ensemble.

Vérifiez le lien

Le bouton Valider la licence du plugin confirme les identifiants et que l'URL enregistrée dans le panneau correspond au site qui appelle réellement. Une fois la vérification faite, le panneau met en cache le nom, la version et la langue de votre site à partir des informations fournies par Moodle lui-même, et les affiche sur la page Moodle.

En cas d'échec, le dépannage couvre les causes habituelles.

Faites tourner les identifiants

Organisation → Moodle → Renouveler les identifiants invalide immédiatement la clé de licence et le secret actuels et émet une nouvelle paire, affichée une seule fois. Tous les propriétaires et administrateurs reçoivent une notification de sécurité.

Renouvelez lorsque :

• le secret a pu être exposé (envoyé par courriel, poussé dans un dépôt, vu par quelqu'un qui est parti) ;
• vous migrez le site vers un nouveau serveur ou hébergeur ;
• vous avez perdu les valeurs et avez besoin d'une paire fonctionnelle.

La connexion cesse de fonctionner tant que la nouvelle paire n'est pas collée dans le plugin : prévoyez quelques minutes d'interruption pour les assistants.

Changer l'URL du site

Changer l'URL relance la même validation. Si votre Moodle change de domaine, mettez-la à jour ici d'abord, puis revalidez depuis le plugin. Les clés continuent de fonctionner : elles sont liées à la connexion, pas au nom d'hôte.

Déconnecter

La déconnexion supprime les identifiants enregistrés et les jetons Moodle chiffrés, et le point de terminaison MCP cesse d'être résolu. Les clés existantes cessent de fonctionner immédiatement. Les jetons de service web restent dans votre Moodle jusqu'à ce que vous les y supprimiez : révoquez donc aussi les utilisateurs dans le plugin si vous mettez le site hors service.