ADR: сетевой
слой meridian-net и подписанные обновления
Статус: предложено, ждёт решения владельца до
23.10.2026 (план 15.10, задача 9 аудита 04, фаза 1). До решения
код пишется за трейтом Transport: выбор реализации — одна
строка, остальной код (манифест, подпись, обновления, API для Hub) от
неё не зависит.
Задача
В десктопе MOffice сети нет. Для беты 0.9 нужны: проверка обновлений, загрузка пакета с прогрессом, установка при выходе и откат; дальше — лицензии, облако, Assist. Требования:
- HTTPS с проверкой сертификата по системному хранилищу (корпоративные корневые сертификаты должны работать).
- Системный прокси (macOS «Сеть → Прокси»,
http(s)_proxy/no_proxyна Linux, WinHTTP-прокси на Windows) и явный прокси из параметров. - Решение № 40 «весь код свой»: сторонние крейты в продукт не входят (только эталоны в тестах).
- Подлинность обновления не зависит от 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).
Подписанный манифест обновлений
- Канал публикует
updates/<канал>/latest.jsonи рядомlatest.json.sig— 64 байта Ed25519 (RFC 8032) поверх"MOFFICE-UPDATE-v1\0" ‖ байты latest.json. Подпись проверяется до разбора JSON. - Открытые ключи зашиты в
meridian-net(KEYS, поkey_id); закрытый — вне репозитория, у владельца/на машине публикации. Смена ключа = выпуск с двумя ключами, затем отзыв старого. - Манифест содержит
channel,version,sequence(растёт с каждой публикацией),expiresи по пакету на цель:url,bytes,sha256,kind. Клиент отказывает при: неверной подписи, чужомkey_id, чужом канале,sequenceменьше уже виденного (откат на старый подписанный манифест), истёкшемexpires(заморозка), несовпадении размера/SHA-256 скачанного пакета, URL неhttps://или с чужим хостом. - Ed25519 — свой код (
meridian-cipher::ed25519), сверка с векторами RFC 8032 и разностный тест противed25519-dalek(только dev-зависимость).
Публичное 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()?; // вернуть прежнюю версиюПрофиль пользователя и документы никогда не входят в пакет и не трогаются обновлением; прежняя версия хранится до следующего успешного обновления.
Последствия
- В DEB добавляется
Depends: libcurl4 | libcurl4t64; в macOS — линковка с Foundation (уже есть через AppKit). - Тесты отказа подмены (подпись, ключ, канал, sequence, expires,
SHA-256, хост) идут без сети на подставном транспорте и входят в обычный
cargo test.