Link di condivisione
Un link di condivisione in Omniscol è un URL firmato che concede l'accesso a una risorsa senza necessità di connessione preventiva:
- l'orario di una classe o di un professore,
- una schermata di inserimento mirata, per esempio delle disponibilità,
- il modulo Gestione delle assenze in sola consultazione,
- una vista specifica per un team esterno (verifica, comunicazione).
Per gli orari pubblici, l'accesso è in sola lettura. Alcuni link di condivisione interni possono tuttavia autorizzare un'azione limitata, come la compilazione di un modulo preciso. Il caso tipico è il link per l'inserimento delle disponibilità dei professori: l'istituto può inviarlo a un professore con una scadenza, senza creargli un login Omniscol.
Sicurezza
Ogni link incorpora un JWT firmato. Per i link web e API, la firma dipende dall'account che ha generato il link e dall'hash della sua password. Per i link iCal, l'hash di verifica è costruito sullo stesso principio. Quattro conseguenze:
- Data di scadenza obbligatoria — il link scade automaticamente alla data scelta. È una protezione importante: nessun link eterno.
- Invalidazione al cambio di password — se l'account titolare cambia la propria password (o la reimposta identica, il che modifica il sale casuale), tutti i link che ha generato vengono invalidati immediatamente.
- Invalidazione tramite l'account titolare — se tale account viene disattivato o eliminato, i link di cui era titolare cessano di funzionare.
- Perimetro limitato — il link apre unicamente la vista o l'azione prevista. Non va descritto come un accesso globale all'account.
Per una diffusione collettiva, utilizzare un account di servizio chiaramente identificato anziché un account personale. L'account di servizio diventa il titolare amministrativo dei link emessi e può essere ruotato o disattivato se una campagna di condivisione deve essere invalidata.
Differenza con un token API
| Aspetto | Link di condivisione | Token API |
|---|---|---|
| Pubblico | Persona in un browser | Software di terze parti |
| Autorizzazione | Perimetro delimitato, spesso in sola lettura | In base agli endpoint selezionati |
| Caso d'uso | Diffusione occasionale | Integrazione software |
| Autenticazione | JWT nell'URL | JWT nell'intestazione Authorization |
| Livello richiesto | Ruolo del creatore | Diritti di amministrazione |
Creazione di un link
Il pulsante Condivisione compare sulle schermate condivisibili (orari, disponibilità, assenze). Fare clic, scegliere una data di scadenza, quindi copiare l'URL nel formato utile.