Перейти к содержимому
SceneCMS
Все статьи

Что вошло в 1.2 — и почему маркетплейс проверяет пакеты офлайн

Разбираем релиз, в котором появился маркетплейс, и логику проверки подписи, которой не нужна сеть.

В версии 1.2 в админке появился маркетплейс: модули и темы ставятся одной кнопкой, а не через FTP. Интересное здесь не кнопка.

Zip из интернета — это код, который вы исполняете

Установить пакет значит положить PHP-файлы на сервер, где они выполняются с теми же правами, что и продукт. Это серьёзное действие для ссылки на скачивание, а большинство экосистем плагинов просто просят доверять каталогу.

Мы не хотели, чтобы это доверие было единственным барьером, поэтому пакет маркетплейса — подписанный артефакт:

marketplace-manifest.json     slug, версия, каждый файл с SHA-256
marketplace-manifest.sig      подпись Ed25519 над манифестом
files/<path>                  содержимое

Публичный ключ лежит внутри продукта. Проверка идёт локально, до распаковки, и не требует сети: каталог может быть недоступен, пакет всё равно проверяем.

Что проверяется, по порядку

  1. Подпись публичным ключом из установки.
  2. Контрольная сумма каждого файла против манифеста.
  3. Slug, тип и версия внутри module.json или theme.json против подписанного манифеста.
  4. Диапазон совместимости против версии CMS.
  5. Что каждый путь остаётся внутри целевого каталога — path traversal именно запрещается, а не «санитизируется».

Пакет с одним изменённым байтом падает на шаге 2. Пакет, выдающий себя за другой продукт, — на шаге 3.

Установить — не значит включить

Два решения, которые выглядят мелкими и важны на практике:

  • После установки модуль выключен. Включаете, когда готовы.
  • Тема не активна, пока вы не нажмёте Activate. В момент, когда файлы легли на диск, витрина не меняется.

Установку, которая молча меняет рабочий сайт, невозможно отлаживать в пятницу вечером. Установка, которая кладёт файлы и ждёт, скучна — в этом и смысл.

Откат — часть установки

Предыдущая сборка уезжает в storage/app/marketplace/rollback до того, как встанет новая, а замена атомарна. Если копирование упало на середине, старая сборка возвращается, и сайт продолжает рендериться.

Принцип тот же, что у апдейтера: неудачное изменение должно оставить систему в том состоянии, в котором она была до нажатия кнопки.

Лицензия, которая не ломает работающие сайты

Для установки нового нужна действующая лицензия. Уже установленное работает бессрочно, в том числе после окончания года поддержки.

Асимметрия намеренная. Истёкшая лицензия должна приостанавливать магазин, а не выключать билетную кассу площадки в субботу. Продукт блокирует покупку нового и никогда не трогает способность сайта продавать.

Заметки о продукте