Ces guides font correspondre les concepts d'un secteur aux objets que la plateforme possède aujourd'hui (bouquets, lines, packages, comptes revendeurs, nœuds, l'API). Ce sont des correspondances conceptuelles, pas des fonctionnalités propres à un secteur, et un compte revendeur est un compte délégué, pas un locataire isolé.
Correspondance conceptuelle
Rien dans le panneau ne s'appelle faculté, semestre ou étudiant. Le tableau indique quel objet joue quel rôle ; les chapitres ci-dessous les configurent dans cet ordre.
| Dans votre secteur | Sur la plateforme | Où dans le panneau |
|---|---|---|
| Compte de faculté ou de département | Compte revendeur : un tableau de bord délégué avec crédits, permissions et ses propres lines | Users → ajouter un revendeur ; Groups pour ses permissions |
| Collection de faculté ou grille du campus | Bouquet : un ensemble nommé de chaînes, films ou séries qu'un package accorde | Bouquets, à partir de Streams et de Movies / Series |
| Chaîne du campus ou événement en direct | Chaîne en direct : un stream avec ses sources, son EPG et ses formats de sortie | Streams → ajouter un stream en direct (URL source ou push RTMP) |
| Archives de cours | Catalogue VOD : films et séries avec saisons et épisodes, catégories et métadonnées | Movies et Series, ou la tâche d'ingestion VOD |
| Accès étudiant ou personnel | Line : un accès avec son package, ses bouquets, son expiration, sa limite de connexions et ses sorties | Lines → ajouter, ou codes d'activation, ou la Reseller API |
| Fin du semestre ou de l'inscription | Date d'expiration de la line, renouvelée par un package, un crédit ou l'API | La date d'expiration de la line et la durée du package |
| Nœud de campus ou de résidence | Nœuds de streaming : serveurs edge enrôlés depuis le panneau, un par site ou par bâtiment | Servers → ajouter un nœud, installé par SSH |
| Intégration du système d'information étudiant | Reseller API et webhooks : les opérations du panneau depuis votre propre système | Clés Reseller API et webhooks dans le tableau de bord du revendeur |
Prérequis
Ce qu'il faut avoir avant d'installer.
- Un serveur sur le campus principal (Ubuntu 22.04 ou 24.04) joignable depuis les autres campus et les résidences, l'installateur, et une adresse interne ou un domaine derrière votre reverse proxy.
- Les flux de chaînes du campus et les enregistrements de cours (ou l'export du système de capture de cours), et la capacité du système d'information étudiant à appeler une API HTTP.
- Une décision sur la structure : quelles facultés reçoivent un compte partenaire, comment les séries de cours sont nommées, et la durée d'un package de semestre.
Déploiement de l'infrastructure
Le campus principal d'abord, puis les autres sites.
- Lancez l'installateur sur le serveur du campus principal ; placez le panneau derrière le reverse proxy de l'université et définissez les proxys de confiance pour que les journaux et les règles d'IP voient les vraies adresses.
- Définissez la base de lecture sur l'adresse que les étudiants atteignent depuis le campus et les résidences.
- Enrôlez un nœud par campus et par résidence depuis Servers ; le panneau l'installe par SSH et y dirige les spectateurs de ce site.
- Définissez la clé de licence sur le serveur ; un établissement disposant d'un domaine académique peut demander par e-mail la clé Professional gratuite du programme éducation.
Organisation du contenu
Les collections des facultés et la grille du campus.
- Créez des catégories par faculté et par matière, et une série par cours avec une saison par semestre et un épisode par cours magistral.
- Créez un bouquet par collection de faculté, un pour les chaînes du campus, et un pour le matériel commun comme les vidéos d'accueil.
- Créez des packages pour les étudiants et le personnel : les bouquets dont chacun a besoin, avec le semestre comme durée, pour que l'accès se termine avec le semestre à moins d'être renouvelé.
- Créez un package d'essai court pour les journées portes ouvertes ou les étudiants invités.
Configuration des partenaires (revendeurs)
Les facultés comme comptes délégués.
- Créez un groupe avec des permissions sur les lines et le catalogue propre de la faculté, et sans accès aux réglages.
- Ajoutez chaque faculté ou département comme compte partenaire (revendeur) avec ce groupe et ses packages ; les sous-revendeurs peuvent refléter les départements au sein d'une faculté.
- Une faculté ne voit et ne gère que ses propres lines ; l'équipe centrale garde la vue d'ensemble. C'est un compte délégué, pas une installation isolée.
Configuration de l'accès des étudiants
Une line par étudiant, depuis le SIE.
- Créez une clé Reseller API pour le système d'information étudiant et conservez-la dans les secrets de ce système.
- À l'inscription, le SIE appelle action=create_line avec le package de l'étudiant et un identifiant de requête ; la durée du package, le semestre, est la période d'accès.
- Définissez les connexions max. sur le nombre d'appareils qu'un étudiant peut utiliser en même temps (en général deux : téléphone et ordinateur portable).
- Pour le personnel et pour un pilote, ajoutez des lines depuis Lines → ajouter et remettez les identifiants.
Archives de cours
Des enregistrements à la demande.
- Téléversez chaque enregistrement comme source d'un épisode ou ingérez-le avec la tâche d'ingestion VOD ; gardez le titre du cours et une courte description.
- Rattachez la série au bouquet de la faculté, pour que seuls les étudiants dont le package l'accorde voient le cours.
- Vérifiez la lecture avec une line de test de chaque package pour confirmer qui voit quoi.
Chaînes du campus et événements en direct
Des chaînes en direct pour le campus.
- Ajoutez les flux de chaînes du campus comme flux en direct sous Streams et une source EPG pour le guide.
- Ajoutez un flux en direct par amphithéâtre ou par événement, alimenté par l'encodeur de la salle en RTMP, et activez le catch-up pour que les spectateurs arrivés en retard puissent revenir en arrière.
- Placez chaque chaîne dans le bon bouquet ; les nœuds des résidences la récupèrent une seule fois depuis l'origine et desservent les étudiants localement.
Expiration et renouvellement
Le semestre comme validité de la line.
- Une line expire à la fin de la période de son package ; à la réinscription, le SIE appelle action=renew_line et une nouvelle période est ajoutée.
- Quand un étudiant abandonne ou obtient son diplôme, le SIE appelle action=disable_line.
- Abonnez le SIE aux webhooks pour rapprocher les lines bientôt expirées et expirées de ses enregistrements.
Intégration avec le système d'information étudiant
Le SIE pilote l'accès ; le lecteur lit.
- Le SIE crée, renouvelle, active et désactive des lines via la Reseller API avec une clé et un identifiant de requête.
- Il n'y a pas de connexion unique (SSO) pour les spectateurs ni d'intégration native avec un LMS ou un SIE : un étudiant se connecte au lecteur avec les identifiants de la line, et la page d'un cours dans le LMS peut renvoyer vers le lecteur web.
- Utilisez des clés Admin API avec indicateur lecture seule, liste blanche d'IP et date d'expiration pour les outils de reporting internes.
Considérations de sécurité
Réserver l'accès aux étudiants et au personnel.
- Gardez la plateforme sur le réseau du campus ou derrière le reverse proxy avec TLS ; définissez TRUSTED_PROXIES sur le proxy.
- Connexion en deux étapes pour chaque compte du panneau et un groupe de permissions par rôle, pour qu'une faculté ne puisse pas voir les lines d'une autre faculté.
- Liens de lecture signés et expirants, une limite de connexions par line, et une liaison à un pays ou à une adresse là où c'est utile.
- Sauvegardes chiffrées de la base de données avec copie externe, et journal d'audit pour chaque modification des lines et du catalogue.
Dépannage
Les premières vérifications habituelles.
- Un étudiant ne voit aucun cours : vérifiez l'expiration de la line, puis le package et les bouquets qu'il accorde.
- Un nouvel étudiant n'a pas d'accès : vérifiez dans le journal des appels de la Reseller API que l'appel du SIE a réussi et que l'identifiant de requête est nouveau.
- Une résidence met en mémoire tampon le soir : vérifiez le heartbeat de son nœud et que les spectateurs y sont dirigés.
- Le journal d'audit montre l'adresse du proxy : définissez TRUSTED_PROXIES sur le proxy et redémarrez le panneau.