Аутентификация и жизненный цикл подключения

Последовательность веб-подключения

  1. Браузер отправляет POST /auth/login с username и password.
  2. Altera выполняет pam_authenticate и pam_acct_mgmt, создаёт Bearer-сессию и возвращает token, token_type, expires_in.
  3. Браузер открывает WebSocket с подпротоколами altera и bearer.<token>.
  4. Altera проверяет сессию, подписывает соединение на её отзыв и запускает CLI под UID/GID пользователя.
  5. CLI подключается к Unix-входу основной службы Altera, где определяется UnixPeer. Процесс backend создаётся при открытии сессии модуля.
  6. JSON-запрос проходит от браузера через цепочку altera-web -> altera-sessions -> altera-cli к основной службе Altera, где для непривилегированного пользователя проверяется Polkit и только разрешённый запрос передаётся в stdin backend.
  7. Logout или истечение Bearer-сессии завершают связанные WebSocket с попыткой отправить Close 1008.
  8. Logout, истечение сессии и обрыв веб-соединения не являются отменой или откатом операций. Основная служба продолжает обработку принятой очереди. Уже переданные backend-модулю операции могут завершиться; остальные запросы проходят обычные проверки доступа, включая проверку жизнеспособности процесса клиента при авторизации через Polkit.

Ветвь root обходит проверку Polkit. Интерактивный Challenge описан на странице Polkit и интерактивная авторизация. Последовательность предполагает успешное создание процессов и соединений.

Bearer-токен и реестр сессий

После успешных pam_authenticate и pam_acct_mgmt Altera создаёт независимую серверную сессию. Для неё getrandom генерирует 32 криптографически случайных байта; клиент получает 64 шестнадцатеричных символа. Токен не содержит имени пользователя, UID/GID или других данных сессии.

Вход выполняется обычным HTTP-запросом:

POST /auth/login
Content-Type: application/json

{"username":"ivan","password":"..."}

При успехе сервер возвращает JSON:

{"token":"<64 шестнадцатеричных символа>","token_type":"Bearer","expires_in":3600, "user": "ivan", "auth_level": "user"}

В памяти altera-sessions хранится соответствие token → {username, expires_at, revoked}. expires_at отсчитывается монотонным временем, подписка sync::watch уведомляет все соединения этой сессии об отзыве. Срок действия задаётся через ALTERA_JWT_TTL (по умолчанию 3600 секунд, а для systemd-сервиса 86400 секунд); истёкшие записи очищаются с интервалом 60 секунд. При перезапуске altera-sessions память сессий очищается.

При WebSocket-подключении Altera проверяет токен в реестре и одновременно подписывает соединение на его отзыв. По сохранённому имени пользователя Altera получает UID и основной GID из системной базы пользователей; затем от этих идентификаторов запускается пользовательский altera-cli. Допуск к backend-операциям по-прежнему определяется основной службой Altera через Polkit.

Особенности идентификации пользователя

PAM-вход проверяет пароль и доступность учётной записи через pam_authenticate и pam_acct_mgmt. Полный PAM-сеанс ОС не открывается. В Bearer-сессии сохраняется имя из запроса входа; итоговое PAM_USER, если PAM преобразовал имя, не считывается. Это нужно учитывать при выборе PAM-конфигурации.

Сессия хранит имя пользователя, а UID/GID определяются заново при каждом WebSocket-подключении. Если учётную запись удалить и создать другую с тем же именем, действующий токен может соответствовать уже другой учётной записи. При таких изменениях нельзя полагаться на неизменность идентичности владельца токена.

Время жизни сессии и соединений

СущностьВремя жизни
Bearer-сессияДо истечения TTL, POST /auth/logout либо перезапуска altera-sessions
WebSocketОт Upgrade до Close, ошибки, heartbeat timeout, отзыва или истечения сессии
Веб-CLIСоздаётся на конкретное WebSocket-соединение; при Logout/TTL sessions убивает CLI
Сессия модуляПринадлежит соединению; может пережить закрытие клиентского соединения на время обработки принятой очереди
Диалог PolkitПринадлежит модулю в данном соединении; ограничен тайм-аутом
Upload-файлПосле подтверждённого finish сохраняется независимо от соединения

Один токен может использоваться одновременно в нескольких веб-соединениях, и каждое соединение получает свой CLI. Каждый успешный POST /auth/login создаёт отдельную Bearer-сессию, даже для того же пользователя. Вход сам по себе не запускает CLI.

Отзыв и истечение сессии завершают все связанные с ней WebSocket, включая /ws, фиксированные пути модулей и /upload. Сервер отправляет Close с кодом 1008, если транспорт позволяет доставить кадр; попытка ограничена одной секундой, чтобы недоступный клиент не задерживал завершение CLI.

Выход из сессии

Для выхода используется обычный HTTP-запрос без тела:

POST /auth/logout
Authorization: Bearer <token>

При корректно сформированном заголовке сервер отзывает указанную сессию и возвращает 204 No Content без тела. Тот же код возвращается для уже отозванного, истёкшего или неизвестного токена. Отсутствующий, некорректный или повторяющийся Authorization приводит к 401 Unauthorized. Для ответов /auth/login и /auth/logout устанавливается Cache-Control: no-store.

Logout прекращает новые подключения по данному токену (401 при попытке WebSocket Upgrade) и завершает все уже открытые с ним веб-сокеты. Другие самостоятельно выданные токены того же пользователя не затрагиваются. Клиент удаляет токен из своего состояния после успешного выхода.

Прямой Unix-клиент

Для Unix-клиента основной службы Altera веб-токен не нужен. Сервер получает учётные данные соединения средствами ОС и формирует UnixPeer. В обычной сборке используется SO_PEERPIDFD, который реализован в ядре Linux 6.5 и выше.

Для версий ядра старее 6.5 (например, которое используется в реализации ALT Linux для процессоров Эльбрус) реализован другой протокол идентификации. Он включается через feature flag legacy-unix-peer. Суть: CLI передаёт дополнительное доказательство с /proc-дескриптором. Это выбор на этапе сборки, а не прозрачное переключение после неудачного запроса. Совместимость нужно учитывать для собственного Unix-клиента.

Источники