Accueil
» ADMINISTRATEUR RÉSEAU
»
Résolution du problème de chargement de la webcam BigBlueButton : échec de la connexion ICE Socket
Résolution du problème de chargement de la webcam BigBlueButton : échec de la connexion ICE Socket
Lorsqu'une webcam BigBlueButton reste noire et que le navigateur ou la réunion affiche « Échec de la connexion ICE Socket », le message indique un problème de connexion multimédia, mais n'en identifie pas la cause unique. Les autorisations d'accès à la caméra, le réseau de l'utilisateur, le pare-feu du serveur, l'adressage NAT et les paramètres du relais TURN peuvent tous être en cause. Avant de modifier la configuration du serveur, commencez par effectuer des vérifications permettant d'isoler le problème.
Le guide de dépannage actuel de BigBlueButton décrit une erreur similaire, 1007 : Échec de la négociation ICE , comme un échec de négociation d'un chemin entre le navigateur et le serveur multimédia. Il mentionne la NAT, les ports UDP bloqués et la nécessité éventuelle d'utiliser TURN sur les réseaux restrictifs. Le message exact affiché dans votre navigateur peut varier selon la version de BigBlueButton, la plateforme d'hébergement ou le client. Considérez-le comme une piste, et non comme un diagnostic. Consultez le guide de dépannage de BigBlueButton 4.0 .
Commencez par identifier si le problème vient de la caméra ou de la connexion.
L'autorisation d'accès à la caméra est requise pour qu'un navigateur puisse accéder à une webcam, et la page de réunion doit utiliser un contexte sécurisé tel que HTTPS. Ces vérifications déterminent si le navigateur peut capturer la vidéo locale. ICE est le processus WebRTC qui établit une route réseau pour l'envoi de flux multimédias entre le navigateur et BigBlueButton. Un refus d'autorisation d'accès à la caméra et une erreur de routage ICE sont deux problèmes distincts, bien que les deux puissent rendre la webcam indisponible. La documentation MDN détaille les exigences relatives à l'autorisation du navigateur et au contexte sécurisé .
Panneau d'autorisation conceptuel du navigateur avec la caméra activée ; les symboles sont illustratifs et ne reproduisent pas un navigateur ou un écran BigBlueButton spécifique.
Vérifiez l'icône de la caméra à côté de la barre d'adresse et les paramètres de votre navigateur. Autorisez l'accès à la caméra pour le site BigBlueButton, assurez-vous que la caméra souhaitée est sélectionnée et fermez les autres applications susceptibles de l'utiliser. Si le navigateur affiche un aperçu local mais que la réunion ne peut toujours pas diffuser la vidéo, l'accès à votre appareil local fonctionne probablement ; poursuivez les vérifications réseau. Si aucun aperçu n'apparaît, commencez par vérifier la sélection de l'appareil, les paramètres de confidentialité de votre système d'exploitation ou les autorisations de votre navigateur.
Essayez ces vérifications des participants dans l'ordre
Rechargez la page une fois, puis rejoignez la réunion. Quittez-la, rechargez la page, puis rejoignez-la à nouveau et réessayez la webcam. Cette manipulation peut résoudre un problème passager de navigateur ou de session multimédia, mais une panne ICE répétée nécessite généralement une intervention sur le réseau ou le serveur.
Mettez à jour votre navigateur ou utilisez-en un compatible. Essayez une version récente d'un autre navigateur de bureau compatible. Si la webcam fonctionne, notez le navigateur et sa version utilisés par l'organisateur de la réunion. Le comportement de la webcam peut varier d'un navigateur à l'autre ; par conséquent, le bon fonctionnement avec un autre navigateur ne garantit pas que le serveur est correctement configuré pour tous les utilisateurs.
Comparez avec un autre réseau. Si possible, connectez-vous via un point d'accès mobile ou un autre réseau de confiance. Si la webcam fonctionne correctement lors de cette seconde connexion, cela suggère fortement que le réseau Wi-Fi, le VPN, le proxy ou le pare-feu d'entreprise d'origine bloque le trafic multimédia. Cela ne permet cependant pas d'identifier la règle en cause.
Testez la même salle avec un autre participant. Si plusieurs personnes, même sur des réseaux différents, ne parviennent pas à activer leur webcam, signalez un problème probable de serveur ou d'hébergement à l'administrateur de la réunion. Si une seule personne rencontre ce problème, vérifiez d'abord son appareil, son navigateur et son réseau.
Testez une autre salle ou démo BigBlueButton. Si votre organisation l'autorise, utilisez une salle distincte ou le service de test officiel BigBlueButton. Si la caméra fonctionne dans cette salle mais pas sur le serveur de votre organisation, signalez ce problème à l'administrateur.
La liste des réseaux Wi-Fi disponibles sur un téléphone et un ordinateur portable permet une comparaison rapide entre un réseau restreint et une connexion dédiée.
Que doivent vérifier les administrateurs
Lorsque plusieurs utilisateurs sont concernés, vérifiez le chemin média à chaque limite du réseau : pare-feu hôte, groupe de sécurité cloud, routeur ou périphérique NAT, et tout pare-feu réseau en amont. La documentation du pare-feu BigBlueButton indique les ports TCP 80 et 443 pour le trafic web et, dans la configuration par défaut documentée, les ports UDP 16384 à 32768 pour les médias. Votre installation peut utiliser une plage personnalisée ou une pile média spécifique à une version ; vérifiez donc la configuration actuelle avant de modifier les règles. N'ouvrez pas une plage plus large que nécessaire. Consultez le guide de configuration du pare-feu BigBlueButton .
Un schéma conceptuel du chemin réseau montre le flux multimédia d'une réunion passant par un pare-feu pour atteindre un serveur ; vérifiez les règles et la plage de ports réellement utilisées par votre installation.
Pour un serveur derrière un NAT, vérifiez que le service multimédia diffuse une adresse IP externe accessible. BigBlueButton 2.5 et versions ultérieures utilisent mediasoup pour les médias WebRTC HTML5 ; le guide officiel du pare-feu explique comment configurer l'adresse externe diffusée /etc/bigbluebutton/bbb-webrtc-sfu/production.yml. Une adresse privée, une adresse publique obsolète, une redirection de port incorrecte ou une configuration IPv6 manquante peuvent empêcher les clients d'accéder au service multimédia. Suivez uniquement les instructions correspondant à votre version de BigBlueButton et à votre architecture réseau, puis redémarrez les services conformément aux indications du guide.
Vérifiez également si les utilisateurs concernés se trouvent sur des réseaux bloquant le trafic UDP sortant. Un serveur TURN peut relayer le trafic WebRTC lorsqu'une route directe est indisponible, mais il doit être installé, accessible et configuré pour la version de BigBlueButton appropriée. La documentation et les paramètres par défaut du serveur TURN varient selon les versions ; suivez le guide correspondant à votre version. Ne copiez pas les identifiants ni les paramètres de port d'une autre version. Consultez le guide du serveur TURN pour BigBlueButton 4.0 .
Un schéma conceptuel du chemin WebRTC illustre les points de terminaison utilisant un serveur relais lorsqu'une connexion directe ne peut être établie.
Hypothèses courantes à éviter
« L’erreur de la webcam signifie que la caméra est cassée. »
Pas nécessairement. Si l'aperçu local s'affiche et que le navigateur dispose des autorisations nécessaires, l'appareil peut fonctionner même si le flux multimédia est interrompu. Action : avant de remplacer la caméra, essayez un autre réseau et vérifiez si d'autres utilisateurs sont concernés.
« Autoriser la caméra résout tous les problèmes de webcam. »
Cette autorisation permet uniquement au navigateur de capturer la vidéo. Elle n'ouvre pas le trafic UDP bloqué et ne corrige pas l'adresse NAT d'un serveur. Action : après avoir confirmé l'autorisation, testez la connexion depuis un autre réseau.
« Une réunion qui se déroule normalement prouve que son réseau médiatique est ouvert. »
La page et les commandes de réunion peuvent se charger via HTTPS, mais l'audio ou la vidéo en temps réel ne peut pas établir son propre chemin média. BigBlueButton signale les échecs ICE, ainsi que les blocages UDP et NAT, comme causes possibles. Action : effectuez un test avec une webcam et comparez les résultats sur différents réseaux.
« Chaque serveur doit utiliser les mêmes ports et paramètres TURN. »
Les valeurs par défaut documentées constituent un point de départ utile, mais ne reflètent pas la configuration réelle. Les ports sont personnalisables et la configuration TURN varie selon la version. Action : vérifiez votre version déployée et sa configuration avant de modifier les règles de pare-feu ou de relais.
Comment confirmer la correction
Après une modification, rejoignez une nouvelle réunion et activez la webcam pendant au moins une minute. Vérifiez que l'aperçu local s'affiche, que les autres participants peuvent voir le flux et que la reconnexion ne reproduit pas l'erreur ICE. Demandez à un utilisateur du réseau précédemment affecté de répéter le test. Si seul le test de point d'accès réussit, communiquez ce résultat à l'administrateur réseau et demandez-lui d'examiner le trafic WebRTC sortant. Si tous les réseaux sont défaillants pour plusieurs utilisateurs, envoyez à l'hébergeur BigBlueButton la version du serveur, l'heure approximative, les navigateurs concernés, le code d'erreur ou le message exact, si l'audio fonctionne et les résultats de chaque test réseau. Évitez de publier publiquement les liens de réunion, les jetons d'accès ou les journaux de navigateur non expurgés.
Un diagnostic précis permet de cibler la source du problème : accès à la caméra locale, réseau d’un utilisateur ou routage des médias du serveur. Le message d’erreur seul ne suffit pas à faire la distinction, mais ces vérifications peuvent fournir à votre administrateur des éléments pour la prochaine intervention.