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