Перейти к содержимому

Как это работает

Как это устроено

Три процесса на сервере с Maran, контракт между ними и правила, которые решают, что корневому демону вообще позволено делать.

На сервере с Maran работают ровно три процесса. Главное проектное решение продукта состоит в разделении между ними, и большинство правил ниже следуют из него.

Три процесса

ПроцессРаботает отДержит
maran-apiнепривилегированного системного пользователявсю бизнес-логику и единственное подключение к базе
maran-agentrootничего: он без состояния и без базы, а единственные настройки, два стартовых значения, лежат в /etc/maran/agent.env
PostgreSQLсобственного пользователяданные панели, на unix-сокете, вообще без TCP-порта

Панель никогда не трогает систему. Агент ничего не решает. В этом вся форма: процесс, который знает, что должно произойти, не имеет привилегий, а процесс с привилегиями знает только, как выполнить фиксированный список вещей.

Контракт между ними

Они говорят через unix-сокет, и передаётся именованная операция с типизированными и проверенными аргументами. Отсюда четыре свойства, и каждое является правилом, а не привычкой:

  • Нет операции, которая запускает переданную вызывающей стороной программу. Ни ограниченной, ни из белого списка, никакой. Поэтому всё, что можно заставить сделать корневой процесс, ограничено конечным списком, который записан и поддаётся ревью.
  • Нигде в обмене нет shell-строки. Домен не экранируется перед попаданием в конфигурационный файл; он проверяется как домен (буквы, цифры, дефисы и точки), и в нём неоткуда взяться переводу строки, который завершит одну директиву и начнёт другую, выбранную вызывающим.
  • Агент проверяет, кто спрашивает. Учётные данные пира на сокете читаются до рассмотрения операции, так что демон знает, какой процесс на другом конце, а не верит тому, что ему сказали.
  • Каждая запускаемая агентом программа ограничена. У каждой есть срок и потолок вывода: проверки и чтения получают 60 секунд, обычные изменения 120, перезагрузки служб 240, запросы к базе 300, установка пакетов 35 минут, резервные копии до 12 часов. По истечении срока убивается вся группа процессов, а не только первый процесс; программа, напечатавшая больше 4 МиБ, убивается, а её вывод отбрасывается. Тайм-аут доходит до панели как обычный результат SYSTEM_FAILURE без вывода инструмента, поэтому зависший валидатор не может заблокировать записи других клиентов.

Запись конфигурационного файла

Каждая привилегированная запись идёт в одном и том же порядке, и именно порядок здесь главное:

  1. отрендерить во временный файл;
  2. fsync;
  3. атомарно переименовать на место;
  4. дать проверить результат самой службе, то есть nginx -t, а не нашему регулярному выражению;
  5. перезагрузить;
  6. откатить файл, если проверка или перезагрузка отказали.

Один плохой рендер не может уронить остальные сайты сервера, потому что о качестве рендера судит собственный парсер сервера.

Изоляция между аккаунтами

  • Аккаунт создаётся как настоящий пользователь Linux со своим домашним каталогом и правами файловой системы.
  • Его PHP работает в собственном пуле php-fpm под собственным uid, и файловые операции идут от этого пользователя и никогда от root.
  • Таблицы арендаторов ограничены аккаунтом на уровне базы, фильтрами запросов, которые автоматический тест проверяет, обходя всю модель.
  • Запрос чужого ресурса отвечает 404, а не 403, поэтому ошибка никогда не подтверждает, что строка существует.

Чего сознательно нет

Ни брокера сообщений, ни сайдкара, ни второго демона. Фоновая работа идёт по надёжным очередям в PostgreSQL, а собственная часть Maran на сервере состоит из трёх процессов из таблицы выше. Рядом с ними установщик настраивает службы, ради которых существует хостинговый сервер и которыми управляет агент: веб-сервер, PHP, сервер баз данных для аккаунтов хостинга, SFTP, брандмауэр и планировщик, а также службу FTPS, которую оператор включает сам.

Платные модули этого тоже не меняют: это модули на C#, которые управляют операциями, уже собранными в открытом агенте. Агент никогда не загружает внешний код, поэтому лицензия не может добавить новую привилегированную возможность.