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:

  1. Data di scadenza obbligatoria — il link scade automaticamente alla data scelta. È una protezione importante: nessun link eterno.
  2. 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.
  3. Invalidazione tramite l'account titolare — se tale account viene disattivato o eliminato, i link di cui era titolare cessano di funzionare.
  4. 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

Il pulsante Condivisione compare sulle schermate condivisibili (orari, disponibilità, assenze). Fare clic, scegliere una data di scadenza, quindi copiare l'URL nel formato utile.

See also