Ссылка общего доступа

Ссылка общего доступа в Omniscol — это подписанный URL, дающий доступ к ресурсу без предварительного входа в систему:

• расписание класса или преподавателя,
• отдельный экран ввода данных, например доступности,
• модуль Управление отсутствиями в режиме просмотра,
• отдельное представление для внешней команды (аудит, информирование).

Для публичных расписаний доступ только для чтения. Некоторые внутренние ссылки общего доступа могут при этом разрешать ограниченное действие, например заполнение определённой формы. Типичный случай — ссылка для ввода доступности преподавателей: учебное заведение может отправить её преподавателю с крайним сроком, не создавая ему учётную запись в Omniscol.

Безопасность

Каждая ссылка содержит подписанный JWT. Для веб-ссылок и ссылок API подпись зависит от учётной записи, создавшей ссылку, и от хеша её пароля. Для ссылок iCal контрольный хеш строится по тому же принципу. Из этого следуют четыре вывода:

1. Дата окончания срока действия обязательна — ссылка автоматически перестаёт действовать в выбранную дату. Это важная защита: вечных ссылок не бывает.
2. Недействительность после смены пароля — если учётная запись, создавшая ссылку, меняет пароль (или задаёт тот же самый, что меняет случайную соль), все созданные ею ссылки перестают действовать немедленно.
3. Недействительность из-за учётной записи-владельца — если эта запись отключена или удалена, ссылки, которые к ней привязаны, перестают работать.
4. Ограниченная область — ссылка открывает только предусмотренное представление или действие. Не описывайте её как общий доступ к учётной записи.

Для рассылки широкому кругу используйте чётко обозначенную служебную учётную запись, а не личную. Служебная запись становится административным владельцем выданных ссылок и может быть заменена или отключена, если нужно аннулировать все ссылки, выданные в рамках одной рассылки.

Отличие от токена API

Создание ссылки

Кнопка Общий доступ появляется на экранах, которыми можно поделиться (расписание, доступность, отсутствия). Нажмите её, выберите дату окончания срока действия, затем скопируйте URL нужного формата.