Deze gidsen koppelen de begrippen van een sector aan de objecten die het platform vandaag heeft (bouquets, lijnen, pakketten, partneraccounts, nodes, de API). Het zijn conceptuele toewijzingen, geen sectorspecifieke functies, en een partneraccount is een gedelegeerd account, geen geïsoleerde tenant.
Conceptuele toewijzing
Niets in het paneel heet een faculteit, een semester of een student. De tabel zegt welk object welke rol speelt; de hoofdstukken hieronder richten ze in die volgorde in.
| In je sector | Op het platform | Waar in het paneel |
|---|---|---|
| Account van faculteit of afdeling | Partneraccount (reseller): een gedelegeerd dashboard met credits, rechten en eigen lijnen | Users → een reseller toevoegen; Groups voor zijn rechten |
| Faculteitscollectie of campusaanbod | Bouquet: een benoemde set kanalen, films of series die een pakket toekent | Bouquets, vanuit Streams en Movies / Series |
| Campuskanaal of live evenement | Live kanaal: een stream met zijn bronnen, EPG en uitvoerformaten | Streams → een live stream toevoegen (bron-URL of RTMP-push) |
| Collegearchief | VOD-catalogus: films en series met seizoenen en afleveringen, categorieën en metadata | Movies en Series, of de VOD-ingesttaak |
| Toegang van student of medewerker | Lijn: één toegang met pakket, bouquets, vervaldatum, verbindingslimiet en uitvoer | Lijnen → toevoegen, of activeringscodes, of de Reseller-API |
| Einde van het semester of de inschrijving | Vervaldatum van de lijn, verlengd door een pakket, een credit of de API | De vervaldatum van de lijn en de looptijd van het pakket |
| Node van campus of studentenhuis | Streamingnodes: edge-servers die vanuit het paneel worden geregistreerd, één per locatie of gebouw | Servers → een node toevoegen, geïnstalleerd via SSH |
| Integratie met studentinformatiesysteem | Reseller-API en webhooks: de handelingen van het paneel vanuit je eigen systeem | Reseller-API-sleutels en webhooks in het dashboard van de reseller |
Vereisten
Wat je nodig hebt voor de installatie.
- Een server op de hoofdcampus (Ubuntu 22.04 of 24.04) die bereikbaar is vanaf de andere campussen en de studentenhuizen, de installer en een intern adres of een domein achter je reverse proxy.
- De campuskanaalfeeds en de collegeopnames (of de export van het collegeregistratiesysteem), en de mogelijkheid van het studentinformatiesysteem om een HTTP-API aan te roepen.
- Een besluit over de structuur: welke faculteiten een partneraccount krijgen, hoe collegereeksen worden genoemd en hoe lang een semesterpakket duurt.
Uitrol van de infrastructuur
Eerst de hoofdcampus, daarna de andere locaties.
- Draai de installer op de server van de hoofdcampus; zet het paneel achter de reverse proxy van de universiteit en stel de vertrouwde proxy's in zodat logs en IP-regels echte adressen zien.
- Stel de afspeelbasis in op het adres dat studenten vanaf de campus en de studentenhuizen bereiken.
- Meld via Servers een node per campus en per studentenhuis aan; het paneel installeert hem via SSH en stuurt de kijkers van die locatie ernaartoe.
- Stel de licentiesleutel in op de server; een instelling met een academisch domein kan per e-mail de gratis Professional-sleutel van het onderwijsprogramma aanvragen.
Indeling van de content
Faculteitscollecties en het campusaanbod.
- Maak categorieën per faculteit en vak, en één serie per cursus met een seizoen per periode en één aflevering per college.
- Maak één bouquet per faculteitscollectie, één voor de campuskanalen en één voor gemeenschappelijk materiaal zoals introductievideo's.
- Maak pakketten voor studenten en medewerkers: de bouquets die elk nodig heeft, met het semester als looptijd, zodat de toegang met de periode eindigt tenzij hij wordt verlengd.
- Maak een kort proefpakket voor open dagen of gaststudenten.
Configuratie van partners (resellers)
Faculteiten als gedelegeerde accounts.
- Maak een groep met rechten voor lijnen en de eigen catalogus van de faculteit, en zonder toegang tot instellingen.
- Voeg elke faculteit of afdeling toe als partneraccount (reseller) met die groep en haar pakketten; subresellers kunnen afdelingen binnen een faculteit nabootsen.
- Een faculteit ziet en beheert alleen haar eigen lijnen; het centrale team houdt het totaaloverzicht. Het is een gedelegeerd account, geen geïsoleerde installatie.
Configuratie van studententoegang
Eén lijn per student, vanuit het SIS.
- Maak een Reseller-API-sleutel voor het studentinformatiesysteem en bewaar die in de geheimen van dat systeem.
- Bij inschrijving roept het SIS action=create_line aan met het pakket van de student en een request-id; de looptijd van het pakket, het semester, is de toegangsperiode.
- Stel het maximale aantal verbindingen in op het aantal apparaten dat een student tegelijk mag gebruiken (doorgaans twee: telefoon en laptop).
- Voeg voor medewerkers en voor een pilot lijnen toe via Lijnen → toevoegen en deel de inloggegevens uit.
Collegearchieven
Opnames op aanvraag.
- Upload elke opname als bron van een aflevering of importeer hem met de VOD-ingesttaak; bewaar de titel van de cursus en een korte beschrijving.
- Koppel de serie aan de bouquet van de faculteit, zodat alleen studenten wier pakket die toekent de cursus zien.
- Controleer het afspelen met een testlijn van elk pakket om te bevestigen wie wat ziet.
Campuskanalen en live evenementen
Live kanalen voor de campus.
- Voeg de campuskanaalfeeds toe als live streams onder Streams en een EPG-bron voor de gids.
- Voeg per collegezaal of evenement een live stream toe, gevoed door de encoder van de zaal via RTMP, en schakel catch-up in zodat laatkomers kunnen terugspoelen.
- Zet elk kanaal in de juiste bouquet; de nodes in de studentenhuizen halen het één keer op bij de origin en bedienen studenten lokaal.
Vervaldatum en verlenging
Het semester als geldigheid van de lijn.
- Een lijn verloopt aan het einde van de periode van zijn pakket; bij herinschrijving roept het SIS action=renew_line aan en komt er een periode bij.
- Wanneer een student zich terugtrekt of afstudeert, roept het SIS action=disable_line aan.
- Abonneer het SIS op de webhooks om aflopende en verlopen lijnen af te stemmen met zijn administratie.
Integratie met het studentinformatiesysteem
Het SIS stuurt de toegang aan; de speler speelt af.
- Het SIS maakt lijnen aan, verlengt, schakelt in en uit via de Reseller-API met een sleutel en een request-id.
- Er is geen single sign-on voor kijkers en geen native LMS- of SIS-integratie: een student meldt zich in de speler aan met de inloggegevens van de lijn, en een cursuspagina in het LMS kan naar de webspeler linken.
- Gebruik Admin-API-sleutels met de alleen-lezenvlag, een IP-toegestaanlijst en een vervaldatum voor interne rapportagetools.
Beveiligingsoverwegingen
Houd de toegang voor studenten en medewerkers.
- Houd het platform op het campusnetwerk of achter de reverse proxy met TLS; stel TRUSTED_PROXIES in op de proxy.
- Aanmelden met twee factoren voor elk paneelaccount en een rechtengroep per rol, zodat een faculteit de lijnen van een andere faculteit niet kan zien.
- Ondertekende en verlopende afspeellinks, een verbindingslimiet per lijn en binding aan een land of een adres waar dat helpt.
- Versleutelde databaseback-ups met een off-sitekopie, en het auditlogboek voor elke wijziging van lijnen en catalogus.
Probleemoplossing
De gebruikelijke eerste controles.
- Een student ziet geen colleges: controleer de vervaldatum van de lijn, daarna het pakket en de bouquets die het toekent.
- Een nieuwe student heeft geen toegang: controleer in het Reseller-API-aanroeplogboek of de aanroep van het SIS is gelukt en of het request-id nieuw is.
- Een studentenhuis buffert in de avond: controleer de heartbeat van zijn node en of kijkers ernaartoe worden gestuurd.
- Het auditlogboek toont het adres van de proxy: stel TRUSTED_PROXIES in op de proxy en herstart het paneel.