Guida alla configurazione per Formazione aziendale

Corrispondenza concettuale

Nel pannello nulla si chiama reparto o dipendente. La tabella dice quale oggetto svolge quale ruolo; i capitoli qui sotto li configurano in quest'ordine.

1Prerequisiti

Cosa avere prima di installare.

1. Un server aziendale (Ubuntu 22.04 o 24.04) raggiungibile dagli uffici, l'installer e un indirizzo interno o un dominio dietro il tuo reverse proxy.
2. Le registrazioni formative, l'encoder dell'auditorium per le sessioni in diretta e la capacità del sistema HR o LMS di chiamare un'API HTTP.
3. Una decisione sulla riservatezza: quale materiale va in quale raccolta di reparto e chi, in HR e nel team di formazione, riceve un account del pannello.

2Installazione dell'infrastruttura

Prima la sede centrale, poi gli uffici.

1. Esegui l'installer sul server della sede centrale; metti il pannello dietro il reverse proxy aziendale e imposta i proxy fidati perché il log di audit veda gli indirizzi reali.
2. Imposta la base di riproduzione sull'indirizzo interno; i dipendenti fuori dalla rete vi arrivano tramite la VPN o il proxy.
3. Registra un nodo per ufficio da Servers; il pannello lo installa via SSH e instrada a lui gli spettatori di quell'ufficio.
4. Crea un account partner per il team di formazione con i permessi sul catalogo e nessuno sulle linee dei dipendenti.

3Organizzazione dei contenuti

Raccolte per reparto, corsi come serie.

1. Crea categorie per argomento e una serie per ogni corso in più parti, con un episodio per sessione.
2. Crea un bouquet per raccolta formativa di reparto e un bouquet di tutto il personale per il materiale che tutti vedono.
3. Crea un pacchetto per ruolo: i bouquet di cui quel ruolo ha bisogno e nessun altro, con una durata lunga (un anno, ad esempio) come periodo di accesso; un rinnovo aggiunge un altro periodo e l'HR disattiva la linea alla fine del contratto.
4. Contrassegna chiaramente nei nomi le raccolte riservate; una linea vede solo i bouquet che il suo pacchetto concede.

4Configurazione dei partner (reseller)

Il team di formazione e, per un gruppo, ogni controllata.

1. Crea un gruppo con i permessi sul catalogo per il team di formazione e un gruppo con i permessi sulle linee per HR.
2. Aggiungi il team di formazione e HR come reseller con quei gruppi; in un deployment interno nessuno dei due ha bisogno di crediti.
3. Una controllata con una propria libreria ottiene un proprio reseller, propri bouquet e propri pacchetti.

5Configurazione dell'accesso dei dipendenti

Una linea per dipendente, da HR.

1. Crea una chiave Reseller API per il sistema HR e tienila nei segreti del sistema HR.
2. All'assunzione il sistema HR chiama action=create_line con il pacchetto del ruolo e un id di richiesta (la durata del pacchetto è il periodo di accesso); all'uscita chiama action=disable_line.
3. Imposta le connessioni massime sul numero di dispositivi che un dipendente può usare (di solito due: scrivania e telefono).
4. Per un pilota, aggiungi le linee da Lines → aggiungi e consegna le credenziali a pochi dipendenti.

6Materiali formativi

Registrazioni on demand.

1. Carica ogni registrazione come fonte di un episodio o acquisiscila con il job di ingest VOD; mantieni il titolo e una breve descrizione.
2. Collega la registrazione al bouquet di reparto giusto tramite la sua serie.
3. Verifica la riproduzione con una linea di prova per ogni ruolo per confermare chi vede cosa.

7Sessioni di formazione interne

Una sessione come canale in diretta.

1. Aggiungi uno stream in diretta per l'encoder dell'auditorium (push RTMP); mettilo nel bouquet di tutto il personale o in quello di un reparto.
2. Abilita il catch-up perché chi arriva in ritardo possa tornare indietro, e carica poi la registrazione nella libreria.
3. I nodi negli uffici prendono la sessione una sola volta dall'origin e servono le proprie persone localmente.

8Scadenza dell'accesso

L'accesso termina con il contratto.

1. Una linea scade alla fine del periodo del suo pacchetto; finché il contratto è in corso l'HR la rinnova con action=renew_line e, alla fine del contratto, l'HR la disattiva.
2. Iscrivi il sistema HR ai webhook per riconciliare le linee in scadenza e scadute con i suoi registri.
3. Per un accesso temporaneo (collaboratori esterni, settimana di inserimento) usa una scadenza breve anziché un pacchetto separato.

9Integrazione con HR o un LMS

I sistemi governano l'accesso; il player riproduce.

1. HR crea, rinnova e disattiva le linee tramite la Reseller API; l'LMS può rimandare al web player da una pagina del corso.
2. Non c'è single sign-on per gli spettatori: un dipendente accede al player con le credenziali della linea emesse dal tuo sistema.
3. Usa chiavi Admin API con il flag di sola lettura per gli strumenti di reportistica interni.

10Considerazioni sulla sicurezza

Riservatezza dalla rete fino alla linea.

1. Tieni la piattaforma sulla rete interna o dietro il reverse proxy con TLS; imposta TRUSTED_PROXIES di conseguenza.
2. Accesso a due fattori per ogni account del pannello; gruppi di permessi perché HR non possa modificare il catalogo e il team di formazione non possa vedere le linee.
3. Link di riproduzione firmati e a scadenza, un limite di connessioni basso per linea e legame all'indirizzo dove i dispositivi sono fissi.
4. Backup cifrati del database con una copia off-site; il log di audit per ogni modifica di linee e catalogo.

11Risoluzione dei problemi

I primi controlli abituali.

1. Un dipendente vede il materiale di un altro reparto: controlla il pacchetto della linea e i bouquet che concede.
2. Un nuovo assunto non ha accesso: controlla che la chiamata di HR sia riuscita (il log delle chiamate della Reseller API) e la scadenza della linea.
3. Un ufficio va in buffering durante una sessione in diretta: controlla l'heartbeat del nodo dell'ufficio e che gli spettatori siano instradati a lui.
4. Il log di audit mostra l'indirizzo del proxy: imposta TRUSTED_PROXIES sul proxy e riavvia il pannello.