Диагностика типовых проблем
Применимо к версии 1.5.0+
Эта статья — отправная точка, когда неясно, в какую категорию попадает проблема. Для конкретных настроек SSO, LTI, доступа и приглашений — по каждой теме есть отдельная подробная статья со своей таблицей ошибок; здесь — только маршрутизация и то, что не покрыто ни одной из них: обычный вход по паролю и загрузка файлов.
Шаг 0 — сервис вообще работает?
Прежде чем разбираться в настройках вашей организации, проверьте, что
ИСПУМ в принципе доступен: откройте https://ispum.ru/api/health. Ответ
{"status":"ok", ...} означает, что сервис работает штатно — проблема
локальная (у преподавателя, в вашей конфигурации SSO/LTI, или в сети
университета). Любой другой ответ, либо страница вообще не открывается —
проблема на нашей стороне; писать в поддержку с описанием симптома, не
разбирать настройки самостоятельно.
Отдельный признак проблемы на нашей стороне: если у нескольких преподавателей сразу перестаёт работать буквально всё (не только один раздел) — это не про вашу настройку. Если же не работают только проверка работ и генерация материалов, а вход, загрузка файлов и всё остальное исправно — это тоже, скорее всего, временная проблема на нашей стороне, а не у вас — сообщение об этом преподаватель увидит прямо в интерфейсе.
Куда смотреть по типу проблемы
| Симптом | Смотрите |
|---|---|
| Не получается настроить единый вход через IdP университета | Настройка входа по SAML |
| Не получается подключить/запустить ИСПУМ из Moodle | Настройка LTI 1.3 |
| Преподаватель не видит раздел/данные, которые должен видеть (или наоборот, видит лишнее) | Модель доступа |
| Преподаватель «зарегистрировался, но организация не подключилась» | Управление преподавателями — почти всегда устаревшая ссылка-приглашение |
| Обычный вход по email и паролю (не через SSO) | Ниже на этой странице |
| Не загружается файл работы студента | Ниже на этой странице |
Обычный вход по паролю
- «Неверный адрес эл. почты или пароль» — намеренно одно и то же сообщение для несуществующего адреса и неверного пароля, чтобы нельзя было определить, зарегистрирован ли конкретный email. Единственный способ восстановить доступ — ссылка «Забыли пароль?» на странице входа.
- Блокировки аккаунта после N неверных попыток нет. Единственная защита — ограничение по IP-адресу: 10 попыток входа за 15 минут (общее для входа, регистрации и восстановления пароля с одного IP). При превышении — «Слишком много попыток входа. Попробуйте через 15 минут.» Это не связано с конкретным аккаунтом: если несколько преподавателей заходят из-за одного NAT/прокси университета, лимит считается на весь этот IP-адрес общий, а не на каждого отдельно.
- Деактивированный преподаватель может ввести пароль и «войти» — экран входа его не остановит, отказ произойдёт на первом же действии после входа. Если преподаватель говорит «вроде вошёл, но потом всё ломается» — это деактивированный аккаунт, а не техническая ошибка; см. «Управление преподавателями».
- Восстановление пароля тоже намеренно не подтверждает, существует ли адрес: сообщение всегда одно и то же — «Если этот адрес зарегистрирован, письмо со ссылкой отправлено» — ссылка в письме действует 1 час.
Загрузка файлов
Поддерживаются PDF, Word (.docx) и изображения (JPEG, PNG), до 50 МБ на
файл.
| Что видит преподаватель | Причина |
|---|---|
| «Неподдерживаемый формат файла. Загружайте PDF, Word-документ или изображение» | Тип файла не из поддерживаемого списка |
| «Файл слишком большой. Максимум 50 МБ на документ» | Файл больше 50 МБ, но меньше ~51 МБ — сообщение показывается корректно |
| «Файл … весит N МБ — больше 50 МБ» сразу после выбора файла | Файл больше 50 МБ — ИСПУМ проверяет размер до отправки. Сохраните PDF в уменьшенном размере (обычно размер дают картинки) или загрузите документ частями |
| «Файл больше 50 МБ — такой не загрузить» | То же, если файл отправлен в обход проверки (например, со старой версии страницы) — запрос отклоняется веб-сервером ещё до ИСПУМ |
| «Содержимое файла не соответствует его расширению» | Файл повреждён либо его реальное содержимое не совпадает с расширением (например, переименованный файл другого формата) |
Что-то другое / непонятная ошибка
Неожиданные ошибки показываются всплывающим сообщением с текстом «Непредвиденная ошибка. Если она повторяется, свяжитесь с поддержкой» — если видите именно это сообщение, повторите действие один раз; если повторяется — пишите в поддержку с точным временем и тем, что вы делали.
Совместимость браузера отдельно не документирована и не тестируется на устаревших версиях — нужен современный браузер с включённым JavaScript.
Если ничего из перечисленного не объясняет проблему — напишите через форму обратной связи, укажите email преподавателя, точное время и что именно происходило (сообщение об ошибке, если было).