Queste guide mettono in corrispondenza i concetti di un settore con gli oggetti che la piattaforma ha oggi (bouquet, linee, pacchetti, account partner, nodi, l'API). Sono corrispondenze concettuali, non funzioni specifiche per settore, e un account partner è un account delegato, non un tenant isolato.
Corrispondenza concettuale
Nel pannello nulla si chiama facoltà, semestre o studente. La tabella dice quale oggetto svolge quale ruolo; i capitoli seguenti li configurano in quest'ordine.
| Nel tuo settore | Sulla piattaforma | Dove nel pannello |
|---|---|---|
| Account di facoltà o dipartimento | Account partner (reseller): una dashboard delegata con crediti, permessi e linee proprie | Users → aggiungi un reseller; Groups per i suoi permessi |
| Collezione di facoltà o palinsesto del campus | Bouquet: un insieme con nome di canali, film o serie che un pacchetto concede | Bouquets, a partire da Streams e Movies / Series |
| Canale del campus o evento live | Canale in diretta: uno stream con le sue fonti, l'EPG e i formati di uscita | Streams → aggiungi uno stream in diretta (URL della fonte o push RTMP) |
| Archivio delle lezioni | Catalogo VOD: film e serie con stagioni ed episodi, categorie e metadati | Movies e Series, oppure il job di ingest VOD |
| Accesso di studente o personale | Linea: un accesso con il suo pacchetto, i bouquet, la scadenza, il limite di connessioni e le uscite | Lines → aggiungi, oppure codici di attivazione, oppure la Reseller API |
| Fine del semestre o dell'iscrizione | Data di scadenza della linea, rinnovata da un pacchetto, da un credito o dall'API | La data di scadenza della linea e la durata del pacchetto |
| Nodo di campus o residenza | Nodi di streaming: server edge registrati dal pannello, uno per sede o edificio | Servers → aggiungi un nodo, installato via SSH |
| Integrazione con il sistema informativo studenti | Reseller API e webhook: le operazioni del pannello dal tuo sistema | Chiavi Reseller API e webhook nella dashboard del reseller |
Prerequisiti
Cosa avere prima di installare.
- Un server nel campus principale (Ubuntu 22.04 o 24.04) raggiungibile dagli altri campus e dalle residenze universitarie, l'installer e un indirizzo interno o un dominio dietro il tuo reverse proxy.
- I segnali dei canali del campus e le registrazioni delle lezioni (o l'esportazione del sistema di lecture capture) e la capacità del sistema informativo studenti di chiamare un'API HTTP.
- Una decisione sulla struttura: quali facoltà ricevono un account partner, come si chiamano le serie delle lezioni e quanto dura un pacchetto semestrale.
Installazione dell'infrastruttura
Prima il campus principale, poi le altre sedi.
- Esegui l'installer sul server del campus principale; metti il pannello dietro il reverse proxy dell'università e imposta i proxy attendibili così log e regole IP vedono gli indirizzi reali.
- Imposta la base di riproduzione sull'indirizzo raggiunto dagli studenti dal campus e dalle residenze universitarie.
- Registra da Server un nodo per campus e per residenza; il pannello lo installa via SSH e vi instrada gli spettatori di quella sede.
- Imposta la chiave di licenza sul server; un'istituzione con dominio accademico può richiedere via e-mail la chiave Professional gratuita del programma per l'istruzione.
Organizzazione dei contenuti
Collezioni delle facoltà e palinsesto del campus.
- Crea categorie per facoltà e materia, e una serie per corso con una stagione per periodo didattico e un episodio per lezione.
- Crea un bouquet per collezione di facoltà, uno per i canali del campus e uno per il materiale comune, come i video di benvenuto.
- Crea pacchetti per studenti e personale: i bouquet di cui ciascuno ha bisogno, con il semestre come durata, così l'accesso termina con il periodo didattico se non viene rinnovato.
- Crea un breve pacchetto di prova per gli open day o gli studenti in visita.
Configurazione dei partner (reseller)
Le facoltà come account delegati.
- Crea un gruppo con permessi sulle linee e sul catalogo della facoltà, e senza accesso alle impostazioni.
- Aggiungi ogni facoltà o dipartimento come account partner (reseller) con quel gruppo e i suoi pacchetti; i sub-reseller possono rispecchiare i dipartimenti all'interno di una facoltà.
- Una facoltà vede e gestisce solo le proprie linee; il team centrale mantiene la visione d'insieme. È un account delegato, non un'installazione isolata.
Configurazione dell'accesso degli studenti
Una linea per studente, dal SIS.
- Crea una chiave Reseller API per il sistema informativo studenti e conservala nei segreti di quel sistema.
- All'iscrizione il SIS chiama action=create_line con il pacchetto dello studente e un id della richiesta; la durata del pacchetto, il semestre, è il periodo di accesso.
- Imposta le connessioni massime sul numero di dispositivi che uno studente può usare contemporaneamente (di solito due: telefono e portatile).
- Per il personale e per un pilota, aggiungi linee da Linee → aggiungi e consegna le credenziali.
Archivi delle lezioni
Registrazioni on demand.
- Carica ogni registrazione come sorgente di un episodio o importala con il job di ingest VOD; mantieni il titolo del corso e una breve descrizione.
- Collega la serie al bouquet della facoltà, così solo gli studenti il cui pacchetto lo concede vedono il corso.
- Verifica la riproduzione con una linea di test di ogni pacchetto per confermare chi vede cosa.
Canali del campus ed eventi live
Canali live per il campus.
- Aggiungi i segnali dei canali del campus come stream live in Stream e una sorgente EPG per la guida.
- Aggiungi uno stream live per aula o evento, alimentato dall'encoder dell'aula via RTMP, e attiva il catch-up così chi arriva in ritardo può tornare indietro.
- Inserisci ogni canale nel bouquet giusto; i nodi nelle residenze lo prelevano una sola volta dall'origine e servono gli studenti localmente.
Scadenza e rinnovo
Il semestre come validità della linea.
- Una linea scade alla fine del periodo del suo pacchetto; alla re-iscrizione il SIS chiama action=renew_line e viene aggiunto un altro periodo.
- Quando uno studente si ritira o si laurea, il SIS chiama action=disable_line.
- Iscrivi il SIS ai webhook per riconciliare con i suoi dati le linee in scadenza e scadute.
Integrazione con il sistema informativo studenti
Il SIS gestisce l'accesso; il player riproduce.
- Il SIS crea, rinnova, attiva e disattiva le linee tramite la Reseller API con una chiave e un id della richiesta.
- Non esiste il single sign-on per gli spettatori né un'integrazione nativa con LMS o SIS: uno studente accede al player con le credenziali della linea, e la pagina di un corso nell'LMS può rimandare al web player.
- Usa chiavi Admin API con il flag di sola lettura, una lista di IP consentiti e una data di scadenza per gli strumenti interni di report.
Considerazioni sulla sicurezza
Mantieni l'accesso a studenti e personale.
- Tieni la piattaforma sulla rete del campus o dietro il reverse proxy con TLS; imposta TRUSTED_PROXIES sul proxy.
- Accesso a due fattori per ogni account del pannello e un gruppo di permessi per ruolo, così una facoltà non può vedere le linee di un'altra.
- Link di riproduzione firmati e con scadenza, un limite di connessioni per linea e associazione a un paese o a un indirizzo dove utile.
- Backup cifrati del database con una copia esterna e il registro di audit per ogni modifica di linee e catalogo.
Risoluzione dei problemi
I primi controlli abituali.
- Uno studente non vede lezioni: controlla la scadenza della linea, poi il pacchetto e i bouquet che concede.
- Un nuovo studente non ha accesso: controlla nel registro delle chiamate della Reseller API che la chiamata del SIS sia riuscita e che l'id della richiesta sia nuovo.
- Una residenza va in buffering la sera: controlla l'heartbeat del suo nodo e che gli spettatori vi siano instradati.
- Il registro di audit mostra l'indirizzo del proxy: imposta TRUSTED_PROXIES sul proxy e riavvia il pannello.