Основные положения
Краткое описание системы
Altera — в широком смысле — это совокупность нескольких служебных программ-посредников между клиентами и программами управления системой. Клиент передаёт JSON, Altera определяет пользователя, проверяет доступ к операции и пересылает разрешённый запрос backend-модулю.
Altera — в узком смысле — основная служба Altera, которая подключается к модулям бекенда по запросу пользователя, поддерживает долгоживущие постоянные каналы двустороннего взаимодействия с модулями в дочерних процессах, авторизовывает запросы пользователя к модулям через Polkit и завершает процессы модулей при отсутствии дальнейшей необходимости в их использовании.
Пути работы с backend3 и backend4
Локально:
Локальный клиент / altera-cli [пользователь]
│ JSON Lines поверх Unix-сокета
▼
Unix-вход Altera [root] → проверка доступа → backend-модуль
Через браузер:
Браузер
│ WebSocket
▼
Web-вход Altera [служебный пользователь]
│ JSON Lines поверх Unix-сокета
▼
Служба управления сессиями Altera [root]
│ stdin / stdout
▼
Служба управления сессиями Altera вызывает altera-cli под UID/GID пользователя
│ JSON Lines поверх Unix-сокета
▼
Unix-вход Altera [root] → проверка доступа → backend-модуль
Права процессов
В стандартной схеме права распределены следующим образом:
| Процесс | Права | Назначение |
|---|---|---|
altera-web | Служебный пользователь и группа altera | Приём HTTP/WebSocket и связь со службой сессий |
altera-sessions | root | PAM и запуск CLI с UID/GID аутентифицированного пользователя |
altera-cli, включая /upload | UID и основной GID пользователя | Связь с основной службой либо обработка файлов пользователя |
Основная служба altera | root | Идентификация Unix-клиента, проверка доступа и управление backend-процессами |
| Backend-модуль | root | Выполнение разрешённых операций управления системой |
altera-web и altera-sessions неразрывно связанные процессы. Их коммуникация происходит через отдельный Unix-сокет, и при подключении через него altera-sessions разрешает запросы только от процессов с UID пользователя altera, от которого запускается altera-web — все остальные будут отклонены.
altera-sessions читает только строго типизированные сообщения от altera-web: login, logout и запрос запустить altera-cli от имени непривилегированного пользователя. Остальные сообщения altera-sessions пересылает сырыми байтами в дочерние процессы пользователей, где они будут прочитаны в среде с ограничениями авторизовавшегося пользователя, или отклоняет.
Главные положения текущей архитектуры
- Web, служба управления сессиями и основная служба Altera работают в разных процессах с разным уровнем допуска.
- Основная служба Altera может использоваться независимо от других компонентов; другие компоненты только расширяют возможности связи с бекендами.
- Модули бекенда (версии 3 или 4) запускаются основной службой Altera в долгоживущих дочерних процессах, которые завершаются только тогда, когда в них отпадает необходимость.
- При коммуникации браузера с
altera-webиспользуется протокол WebSocket; основа коммуникации компонентов альтеры между собой через Unix-сокеты — JSON Lines. /upload— отдельный WebSocket-протокол: файлы обрабатывает пользовательский CLI, а не привилегированный backend.
Обязанности модуля бекенда
Модуль реализует предметную операцию: чтение настроек, изменение конфигурации, управление службой и т. п. Он проверяет смысл и допустимость параметров, соблюдает свой формат ответа и сообщает о завершении запроса.
Модуль работает в системе с правами root. По умолчанию любые команды от непривилегированного пользователя к модулю запрещены. Если разработчик через политику Polkit предоставляет непривилегированному пользователю разрешение отправить ту или иную команду модулю, то в полной мере должен осознавать, что данная команда не должна нести деструктивного воздействия на систему или же пользователю/группе пользователей должно оказываться доверие с прилагающейся вместе с этим долей ответственности.