Freigabelink

Ein Freigabelink in Omniscol ist eine signierte URL, die ohne vorherige Anmeldung Zugriff auf eine Ressource gewährt:

• den Stundenplan einer Klasse oder einer Lehrkraft,
• einen gezielten Eingabebildschirm, zum Beispiel für Verfügbarkeiten,
• das Modul Abwesenheitsverwaltung zur Ansicht,
• eine spezifische Ansicht für ein externes Team (Audit, Kommunikation).

Bei öffentlichen Stundenplänen ist der Zugriff schreibgeschützt. Manche internen Freigabelinks können jedoch eine begrenzte Aktion erlauben, etwa das Ausfüllen eines bestimmten Formulars. Der typische Fall ist der Link zur Eingabe der Verfügbarkeiten der Lehrkräfte: Die Schule kann ihn mit einer Frist an eine Lehrkraft senden, ohne für sie ein Omniscol-Login anzulegen.

Sicherheit

Jeder Link enthält ein signiertes JWT. Bei Web- und API-Links hängt die Signatur vom Konto, das den Link erzeugt hat, und vom Hash seines Passworts ab. Bei iCal-Links wird der Prüf-Hash nach demselben Prinzip gebildet. Vier Folgen:

1. Verpflichtendes Ablaufdatum — der Link läuft am gewählten Datum automatisch ab. Das ist ein wichtiger Schutz: keine ewigen Links.
2. Ungültigkeit bei Passwortänderung — wenn das Trägerkonto sein Passwort ändert (oder es auf denselben Wert zurücksetzt, was den zufälligen Salt ändert), werden alle von ihm erzeugten Links sofort ungültig.
3. Ungültigkeit über das Trägerkonto — wenn dieses Konto deaktiviert oder gelöscht wird, funktionieren die von ihm getragenen Links nicht mehr.
4. Begrenzter Bereich — der Link öffnet nur die vorgesehene Ansicht oder Aktion. Beschreiben Sie ihn nicht als globalen Zugriff auf das Konto.

Für eine breite Verteilung verwenden Sie ein klar identifiziertes Dienstkonto statt eines persönlichen Kontos. Das Dienstkonto wird zum administrativen Träger der ausgegebenen Links und kann rotiert oder deaktiviert werden, falls eine Freigabekampagne ungültig gemacht werden muss.

Unterschied zu einem API-Token

Erstellen eines Links

Die Schaltfläche Teilen erscheint auf teilbaren Bildschirmen (Stundenpläne, Verfügbarkeiten, Abwesenheiten). Klicken Sie sie an, wählen Sie ein Ablaufdatum und kopieren Sie dann die URL im benötigten Format.