Link udostępniania

Link udostępniania w Omniscol to podpisany adres URL, dający dostęp do zasobu internetowego bez uprzedniego zalogowania:

• planu lekcji klasy albo nauczyciela,
• ukierunkowanego ekranu wprowadzania danych, na przykład dostępności,
• modułu Zarządzanie nieobecnościami w trybie podglądu,
• konkretnego widoku dla zespołu zewnętrznego (audyt, komunikacja).

W przypadku publicznych planów lekcji dostęp jest tylko do odczytu. Niektóre wewnętrzne linki udostępniania mogą jednak zezwalać na ograniczone działanie, na przykład na wypełnienie konkretnego formularza. Typowym przypadkiem jest link do wprowadzania dostępności nauczycieli: placówka może wysłać go nauczycielowi z terminem końcowym, bez zakładania mu loginu Omniscol.

Bezpieczeństwo

Każdy link zawiera podpisany JWT. W linkach internetowych i API podpis zależy od konta, które wygenerowało link, oraz od skrótu jego hasła. W linkach iCal skrót weryfikacyjny jest tworzony na tej samej zasadzie. Cztery konsekwencje:

1. Obowiązkowa data wygaśnięcia — link wygasa automatycznie w wybranym dniu. To ważne zabezpieczenie: żaden link nie jest wieczny.
2. Unieważnienie przy zmianie hasła — jeśli konto wystawiające zmieni swoje hasło (albo ustawi je ponownie na to samo, co zmienia losową sól), wszystkie wygenerowane przez nie linki zostają natychmiast unieważnione.
3. Unieważnienie przez konto wystawiające — jeśli to konto zostanie dezaktywowane albo usunięte, wydane przez nie linki przestają działać.
4. Ograniczony zakres — link otwiera tylko przewidziany widok albo działanie. Nie należy go opisywać jako ogólnego dostępu do konta.

Do dystrybucji zbiorowej proszę używać wyraźnie oznaczonego konta serwisowego, a nie konta osobistego. Konto serwisowe staje się administracyjnym wystawcą wydanych linków i można je poddać rotacji albo dezaktywować, jeśli trzeba unieważnić całą kampanię udostępniania.

Różnica wobec tokenu API

Tworzenie linku

Przycisk Udostępnianie pojawia się na ekranach, które można udostępniać (plany lekcji, dostępność, nieobecności). Proszę go kliknąć, wybrać datę wygaśnięcia, a następnie skopiować adres URL w potrzebnym formacie.