MOffice

ADR: сетевой слой meridian-net и подписанные обновления

Статус: предложено, ждёт решения владельца до 23.10.2026 (план 15.10, задача 9 аудита 04, фаза 1). До решения код пишется за трейтом Transport: выбор реализации — одна строка, остальной код (манифест, подпись, обновления, API для Hub) от неё не зависит.

Задача

В десктопе MOffice сети нет. Для беты 0.9 нужны: проверка обновлений, загрузка пакета с прогрессом, установка при выходе и откат; дальше — лицензии, облако, Assist. Требования:

  1. HTTPS с проверкой сертификата по системному хранилищу (корпоративные корневые сертификаты должны работать).
  2. Системный прокси (macOS «Сеть → Прокси», http(s)_proxy/no_proxy на Linux, WinHTTP-прокси на Windows) и явный прокси из параметров.
  3. Решение № 40 «весь код свой»: сторонние крейты в продукт не входят (только эталоны в тестах).
  4. Подлинность обновления не зависит от TLS: манифест подписан Ed25519, ключ зашит в приложение.

Варианты

Вариант Как Плюсы Минусы
А. HTTPS средствами ОС (рекомендую) macOS — NSURLSession (Foundation, вызовы через objc_msgSend, как в meridian-platform); Linux — системный libcurl.so.4 через dlopen (≈ 12 функций); Windows — WinHTTP TLS, сертификаты, прокси, HTTP/2 и обновления безопасности — забота ОС; ноль своего TLS-кода; размер +0 МБ три обвязки по 300–500 строк; на Linux нужен libcurl4 (есть в Ubuntu/Debian по умолчанию; в DEB — Depends)
Б. Свой TLS 1.3 X.509, ECDHE, AEAD, проверка цепочки на своём коде одна реализация на все ОС месяцы работы и аудит безопасности; отзыв сертификатов, корпоративные УЦ и прокси — всё своё; высокий риск
В. rustls + ureq сторонние крейты быстро, кроссплатформенно нарушает решение № 40; собственное хранилище корней, корпоративные УЦ — отдельная работа; +2–3 МБ
Г. Внешняя программа curl запуск /usr/bin/curl (есть в macOS, Windows 10+, почти всех Linux) работает сегодня, прокси из окружения зависимость от наличия и версии программы; хуже контроль ошибок; прогресс через разбор вывода

Рекомендация

Вариант А. Г остаётся запасной реализацией (тесты, отладка, ОС без libcurl): уже реализован и проверен, включается переменной MOFFICE_NET_TRANSPORT=curl. Б и В не берём.

Порядок: трейт + Г (неделя 1, сделано) → Linux libcurl и macOS NSURLSession (неделя 2) → WinHTTP (фаза 2).

Подписанный манифест обновлений

Публичное API для Hub (S2)

let updater = meridian_net::Updater::new(meridian_net::UpdaterConfig::for_current_install()?);
let info: UpdateInfo = updater.check_updates(Channel::Beta)?;      // None-версия = «обновлений нет»
let staged = updater.download(&info, &mut |p: Progress| ...)?;      // фоновая загрузка, проверка SHA-256
updater.install_on_exit(&staged)?;                                  // отметка «поставить при выходе»
// при выходе Hub / при запуске: updater.apply_pending()?            // перестановка с копией прежней версии
updater.rollback()?;                                                // вернуть прежнюю версию

Профиль пользователя и документы никогда не входят в пакет и не трогаются обновлением; прежняя версия хранится до следующего успешного обновления.

Последствия