Основные положения

Краткое описание системы

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-sessionsrootPAM и запуск CLI с UID/GID аутентифицированного пользователя
altera-cli, включая /uploadUID и основной GID пользователяСвязь с основной службой либо обработка файлов пользователя
Основная служба alterarootИдентификация 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 предоставляет непривилегированному пользователю разрешение отправить ту или иную команду модулю, то в полной мере должен осознавать, что данная команда не должна нести деструктивного воздействия на систему или же пользователю/группе пользователей должно оказываться доверие с прилагающейся вместе с этим долей ответственности.