Allow IAS SSO without email and provide explicit identity linking

This commit is contained in:
Aleksandr Meshchryakov
2026-09-28 13:59:19 +02:00
parent ed1b7ec78f
commit d46ae6fc06
11 changed files with 361 additions and 17 deletions

View File

@@ -263,6 +263,19 @@ make pre-commit
ИАС отправляет `POST /api/v1/auth/sso/` с `Content-Type: application/x-www-form-urlencoded`: обязательное поле `sso_token`, необязательное `redirect_path` (локальный путь, по умолчанию `/main`). Вариант URL без завершающего `/` тоже принимает форму напрямую: промежуточного 301, теряющего POST, нет. Для регистрации в ИАС используйте канонический URL со слешем.
Email в SSO-токене необязателен: отсутствующее поле, `null` и пустая строка означают отсутствие почты. Новый SSO-пользователь создаётся с `email=NULL` и `is_verified=false`; фиктивный адрес не генерируется. Переданный непустой email проверяется на формат, длину и конфликты. Если при следующем входе email отсутствует, сохранённый адрес и его признак подтверждения остаются прежними. Обычная регистрация по-прежнему требует email.
Повторный вход использует неизменяемую пару `(iss, user_id)`. Автоматическая первичная привязка к локальному аккаунту по-прежнему требует совпадения логина и непустой почты. При совпадении только логина вход отклоняется. Администратор может явно привязать существующий аккаунт после проверки принадлежности внешнего `user_id` пользователю:
```bash
python src/manage.py link_sso_identity --user-id <local-id> --expected-username <local-login> --subject <ias-user-id> --dry-run
# После проверки соответствия повторить без --dry-run.
```
Команда использует настроенный `SSO_ISSUER`, не переносит уже занятую identity и не меняет локальные права. До первого успешного входа `last_authenticated_at` равен `NULL`. Сам по себе одинаковый логин не является подтверждением принадлежности аккаунта.
Миграция `0010_sso_optional_email` разрешает NULL в email и времени последнего SSO-входа; данные пользователей сохраняются. При откате приложения оставьте эту совместимую схему: обратная миграция к NOT NULL требует предварительно обработать пользователей без почты и ещё не использованные привязки.
После успешной проверки одноразового ES256 JWT backend устанавливает Django session cookie и CSRF cookie и отвечает `303 Location: <redirect_path>`. GET callback возвращает 405; токен в URL не принимается. Пустая форма при включённом SSO возвращает 400, при выключенном — 503.
Перед выпуском проверяйте каждый контур отдельно: `SSO_ENABLED`, issuer, service code/target, соответствие callback у ИАС и доступность публичного ключа в контейнере. Включение dev не включает main. Правка маршрута не заменяет настройку провайдера и полный вход с настоящим SSO-токеном. Не копируйте токены/cookie в логи или отчёты.