Comment intégrer BigBlueButton à Moodle LMS (étape par étape)
En bref : Sur Moodle 4.0 et versions ultérieures, l’installation d’un plugin BigBlueButton séparé n’est généralement pas nécessaire. Activez l’activité intégrée si elle est désactivée sur votre site, saisissez l’URL du serveur BigBlueButton et le secret partagé dans les paramètres du site, puis ajoutez une activité BigBlueButton à un cours et testez-la avec un enseignant et un étudiant inscrit. Vous avez besoin d’un service BigBlueButton fonctionnel et des identifiants fournis par son fournisseur ou l’administrateur du serveur ; l’installation de l’activité Moodle seule ne crée pas de serveur de visioconférence.
Ce guide décrit l'intégration standard des activités Moodle, et non un déploiement LTI distinct. Les libellés et les chemins d'accès aux menus ci-dessous peuvent légèrement varier selon les versions ou les thèmes de Moodle. Les panneaux d'interface sont des illustrations des paramètres et du flux de travail, et non des captures d'écran d'une installation Moodle en production.
Dois-je installer un autre plugin Moodle ?
En général, non. Moodle a intégré BigBlueButton comme extension principale dans Moodle 4.0. Dans les versions 4.0 à 5.2, un administrateur peut devoir l'activer dans Administration du site > Extensions > Gérer les activités et accepter le contrat de traitement des données. La documentation de Moodle 5.3 indique que l'activité est activée par défaut lors des nouvelles installations, mais l'administrateur doit tout de même saisir l'URL du serveur et le secret partagé ; jusque-là, le sélecteur d'activités peut afficher BigBlueButton comme indisponible. Si votre site est antérieur à Moodle 4.0, vérifiez la version de l'extension correspondant à votre version de Moodle avant d'en installer une copie supplémentaire. N'installez pas un module d'activité dupliqué sur un site plus récent. Consultez les notes de mise à niveau de Moodle pour BigBlueButton afin de connaître l'historique de l'extension principale et la documentation de Moodle 5.3 pour connaître le comportement actuel de l'activité.
Que dois-je préparer avant l'installation ?
Un service BigBlueButton : soit un serveur exploité par votre organisation, soit un service hébergé permettant l’intégration à Moodle.
URL du serveur et clé secrète partagée : veuillez vous renseigner auprès de votre fournisseur ou de l’administrateur de votre serveur. Si vous administrez un serveur BigBlueButton auto-hébergé compatible, son administrateur peut exécuter la commande sudo bbb-conf --secretsur ce serveur. Cette commande affichera l’URL et la clé secrète de l’API.
Accès administrateur à Moodle : seul un administrateur du site peut modifier les identifiants du serveur pour l’ensemble du site ; un enseignant peut ajouter l’activité une fois celle-ci activée.
Cours et comptes de test : utilisez un compte d’enseignant ou de modérateur et un compte d’étudiant inscrit au cours.
L'URL correspond à l'adresse du serveur BigBlueButton fournie pour l'intégration de l'API et se termine généralement par `.bigbluebutton` /bigbluebutton/. Copiez exactement la valeur du fournisseur, y compris `.bigbluebutton` https://et la barre oblique finale, plutôt que d'ajouter un /apichemin approximatif. Le secret partagé assure la signature des requêtes API entre serveurs. Il est impératif de le conserver confidentiel : les recommandations de sécurité de l'API BigBlueButton indiquent de ne pas exposer ce secret dans le code JavaScript côté navigateur ni dans le contenu public des cours. Si vous utilisez des identifiants de service hébergé, ce fournisseur peut appliquer ses propres limites concernant les participants, les enregistrements ou les sessions.
L'administrateur du serveur BigBlueButton peut exécuter la commande bbb-conf --secret pour récupérer l'URL du serveur et le secret partagé ; le secret d'exemple est masqué.
Comment connecter Moodle au serveur BigBlueButton ?
1. Vérifiez la version de Moodle et activez l'activité.
Connectez-vous en tant qu'administrateur du site et vérifiez la version de Moodle dans la section « Notifications du site » ou « Informations système ». Si l'activité BigBlueButton est désactivée, activez-la depuis la page de gestion des activités. Sur Moodle 4.0 à 5.2, les notes de mise à jour indiquent que cette activité principale peut être désactivée par défaut et que l'administrateur doit accepter l'accord de traitement des données pour l'activer. Sur un nouveau site Moodle 5.3, elle devrait apparaître comme activée, mais des identifiants manquants peuvent la rendre indisponible dans le sélecteur. L'emplacement du menu peut varier ; utilisez la recherche « BigBlueButton » dans l'administration du site si les libellés ne correspondent pas à votre thème.
Saisissez le point de terminaison et le secret partagé fournis par votre hébergeur dans les paramètres BigBlueButton de Moodle, puis enregistrez-les.
2. Saisissez l'URL du serveur et le secret partagé
Ouvrez les paramètres BigBlueButton depuis l'administration du site, généralement sous Extensions ou Extensions > Modules d'activité . Repérez les paramètres généraux pour l'URL du serveur BigBlueButton et le secret partagé BigBlueButton . Collez les valeurs fournies par votre fournisseur de services ou votre administrateur serveur, puis enregistrez les modifications. La documentation de Moodle 5.3 explique comment saisir ces identifiants depuis la page des paramètres BigBlueButton ; l'intitulé exact de la navigation peut différer dans les versions antérieures.
Pour un service auto-hébergé, comparez les valeurs Moodle avec l'URL et le secret indiqués sur le serveur BigBlueButton. Ne régénérez ni ne modifiez le secret du serveur à titre de simple dépannage : chaque interface utilisant ce serveur doit être mise à jour avec la nouvelle valeur. Le secret n'est pas un mot de passe étudiant et ne doit pas figurer dans le message de bienvenue d'une activité. BigBlueButton explique comment le secret partagé valide les appels API dans son guide de personnalisation du serveur et sa documentation sur la sécurité de l'API .
3. Ajouter une activité de test à un cours
Ouvrez un cours pour lequel vous disposez des droits de modification et activez le mode Édition. Dans la section Cible, choisissez Ajouter une activité ou une ressource , puis sélectionnez BigBlueButton . S'il est absent, revenez aux vérifications au niveau du site (étape 1) plutôt que d'essayer d'ajouter un autre plugin. Utilisez une session temporaire clairement identifiée, par exemple « Test de connexion BBB », afin que les étudiants ne la confondent pas avec un cours programmé.
Dans le sélecteur d'activités du cours, BigBlueButton apparaît comme une activité une fois que l'administrateur du site l'a activée et configurée.
4. Définir les détails et l'horaire de la réunion
Donnez à l'activité un nom explicite et ajoutez une brève description expliquant l'objectif de la salle. Un message de bienvenue est facultatif. Choisissez d'activer ou non l'option « Attendre le modérateur » : si cette option est activée, les étudiants devront attendre qu'un modérateur se connecte. Si le cours a une plage horaire de début ou de fin, configurez-la et vérifiez le fuseau horaire du cours. Évitez d'ouvrir une activité de test aux invités, sauf si votre établissement autorise explicitement cet accès ; l'accès des utilisateurs inscrits est plus facile à contrôler lors de la configuration.
Utilisez initialement les rôles par défaut des participants. Si l'enseignant doit modérer la salle, vérifiez que son compte possède le rôle approprié dans le cours Moodle avant de procéder au test. Les liens invités et l'accès externe sont soumis à des conditions spécifiques au site et peuvent être indisponibles lorsque le site Moodle exige une authentification.
Le formulaire d'activité comprend un nom et un message de bienvenue facultatif, un paramètre d'attente du modérateur et des commandes de planification.
Comment puis-je vérifier que l'intégration fonctionne pour les apprenants ?
5. Enregistrez l'activité et vérifiez qu'elle apparaît bien dans le cours.
Enregistrez l'activité et retournez à la page du cours. Vérifiez que son nom et son horaire sont corrects. Si l'activité est masquée, hors de sa plage horaire ou restreinte par un groupe ou une condition d'accès, les étudiants risquent de ne pas la voir même si la connexion au serveur est établie. Avant de diagnostiquer le serveur BigBlueButton, vérifiez la visibilité de l'activité et les inscriptions au cours.
Une activité de séminaire hebdomadaire enregistrée apparaît dans la section du cours avec les détails de son calendrier.
6. Connectez-vous en tant qu'enseignant et vérifiez l'accès audio.
Ouvrez l'activité de test en tant qu'enseignant ou modérateur. Lorsque la salle vous invite à connecter votre micro, choisissez « Microphone » pour tester la prise de parole et l'écoute, ou « Écouter seulement » si vous testez la lecture sans micro. Autorisez le navigateur à accéder au micro lorsque vous y êtes invité. Un refus d'autorisation du navigateur est différent d'une erreur d'authentification Moodle : si la salle s'ouvre mais que le son ne fonctionne pas, vérifiez d'abord les autorisations du site dans votre navigateur et le périphérique audio sélectionné.
Au signal audio, les participants peuvent choisir de participer avec un microphone ou d'écouter seulement.
7. Connectez-vous à nouveau avec un compte étudiant inscrit
Utilisez un deuxième profil de navigateur ou un autre appareil pour vous connecter en tant qu'étudiant inscrit et ouvrir la même activité. Vérifiez si l'étudiant peut y accéder immédiatement ou s'il doit attendre l'intervention du modérateur. Assurez-vous que le participant apparaît bien dans la salle et qu'un bref test de chat ou audio fonctionne. Ce test est plus complet qu'un lancement par l'administrateur, car la visibilité de l'étudiant, son inscription au cours, les restrictions de groupe et les paramètres du modérateur peuvent influencer le résultat.
Dans une classe virtuelle, la zone de présentation s'affiche à côté de la liste des participants et du volet de discussion.
8. Ne vérifiez les enregistrements que si votre configuration le permet.
L'enregistrement est optionnel et dépend du serveur, des paramètres d'activité, des autorisations et de votre abonnement. Si l'enregistrement est activé, effectuez un court enregistrement test, terminez la réunion proprement et vérifiez si un lien d'enregistrement est disponible pour les rôles Moodle concernés. L'enregistrement peut ne pas apparaître immédiatement ; la documentation de mise à niveau de Moodle indique que les tâches de métadonnées d'enregistrement peuvent s'exécuter de manière asynchrone et que la tâche cron de Moodle doit être active pour le traitement lié à l'enregistrement dans le scénario de mise à niveau décrit. Pour connaître le fonctionnement actuel de la tâche cron, consultez l'état des tâches planifiées de Moodle et la politique d'enregistrement de votre fournisseur avant de conclure à un dysfonctionnement de l'intégration.
Une entrée d'enregistrement peut apparaître sous l'activité lorsque les enregistrements sont activés, traités et disponibles pour cet utilisateur.
Que se passe-t-il si Moodle ne parvient pas à se connecter ou si les étudiants ne peuvent pas se connecter ?
Symptôme
Premier contrôle
BigBlueButton est absent du sélecteur d'activités.
Vérifiez que l'activité intégrée est activée et disponible pour votre version de Moodle.
L'activité est grisée sur Moodle 5.3
Complétez l'URL du serveur et la configuration du secret partagé ; la documentation actuelle indique que des informations d'identification incomplètes rendent le service indisponible.
Moodle signale que le serveur est indisponible ou que la salle ne peut pas démarrer.
Comparez l'URL et le secret exacts avec les valeurs du fournisseur ; vérifiez que le serveur Moodle peut atteindre l'hôte BigBlueButton via HTTPS.
L'enseignant peut participer, mais pas un élève.
Vérifiez les inscriptions aux cours, la visibilité des activités, les dates d'accès, les restrictions de groupe et les paramètres d'attente du modérateur.
La pièce s'ouvre, mais ni l'audio ni la vidéo ne fonctionnent.
Vérifiez les autorisations du navigateur et les exigences réseau/média du service BigBlueButton ; la connectivité API seule ne permet pas de vérifier le chemin média de chaque participant.
Aucun enregistrement n'est disponible.
Vérifiez que l'enregistrement est pris en charge et activé, contrôlez qui peut le visionner et consultez l'état des tâches planifiées/cron.
Si Moodle signale l'impossibilité d'accéder à la salle, commencez par vérifier l'URL, le secret partagé et la disponibilité du serveur. L'ancienne page de dépannage de Moodle répertorie ces causes fréquentes ; utilisez-la comme liste de vérification pour le diagnostic, en prenant soin d'utiliser les identifiants de votre fournisseur actuel plutôt que de copier les valeurs d'un ancien serveur de test. Pour un serveur autogéré, l'administrateur BigBlueButton peut également vérifier le service côté serveur. Ne divulguez pas le secret partagé dans les captures d'écran, les messages d'assistance ni les journaux publics.
Liste de vérification de la configuration finale
La version de Moodle et l'état du module d'activité sont connus.
Le point de terminaison BigBlueButton correct et le secret partagé sont enregistrés dans les paramètres du site.
L'activité figure dans le cours et est visible pour l'étudiant qui passe le test.
Un enseignant et un élève inscrit peuvent collaborer en respectant les rôles prévus.
L'audio fonctionne dans le navigateur pour au moins un participant.
La lecture des enregistrements n'est testée séparément que si elle fait partie du service.
Une intégration réussie signifie que Moodle peut créer et lancer une session pour les utilisateurs concernés du cours ; il ne s'agit pas simplement de faire apparaître une activité BigBlueButton dans le sélecteur. Si le lancement fonctionne pour l'enseignant, mais que les étudiants, les médias ou les enregistrements ne fonctionnent pas, il convient de résoudre les problèmes d'autorisations ou de services séparément plutôt que de réinstaller systématiquement l'activité principale de Moodle.