Подпись пакетов¶
Дистрибутив, собранный с integrity = "rsa", подписывает пакеты закрытым
ключом RSA и запускает их с проверкой по открытому ключу. Сам по себе tt
ничего не проверяет: в нём нет провайдера контроля целостности (см.
Build a distribution of tt).
Создание ключей¶
Ключи хранятся в формате PEM: закрытый - в PKCS#1 или PKCS#8, открытый - в PKIX или PKCS#1, как их создаёт openssl:
$ openssl genrsa -out private.pem 2048
$ openssl rsa -in private.pem -pubout -out public.pem
Подпись архива¶
Команда tt package pack --with-integrity-check private.pem подписывает
собираемый архив. В корень пакета помещаются два файла с хешами, рядом с
каждым из которых лежит подпись RSASSA-PSS (.sig): hashes.json перечисляет
всё, что загружает Tarantool, - исходные тексты на Lua, разделяемые
библиотеки, конфигурации кластера шаблонов и скрипты, запускаемые записями
экземпляров, - а env_hashes.json содержит все остальные файлы пакета:
манифест, lock-файл, VERSION, описания экземпляров, программы в .rocks/bin/.
Для каждой среды выполнения, которую архив включает в _runtime/,
создаётся собственный env_hashes.json, в котором перечислены её исполняемый
файл и заголовочные файлы tarantool по путям, куда их раскладывает
tt package install. Подписанный пакет запускает только собственные файлы:
если запись шаблона запускает скрипт или бинарный файл вне пакета либо
программу, которая не собирается в .rocks/bin/, сборка пакета завершается
с ошибкой. Точно так же отвергается запись экземпляра Tarantool с env и
наличие каталога var/ в корне пакета (см. ниже структуру каталогов в Tarantool
Enterprise). Пакет нельзя подписать с флагом --without-deps, поскольку
при установке такого пакета скачиваются зависимости, которые никто не
подписывал.
Установка подписанного архива¶
Команда tt --integrity-check public.pem package install устанавливает
только подписанный архив - в область установки пользователя или системы: версия
и каждая включённая среда выполнения проверяются перед размещением на месте
(их подписи, каждый перечисленный файл и то, что в списке учтены все файлы),
поэтому изменённый или добавленный файл отвергается. Среда выполнения, уже
установленная в этом месте через tt binary или при более ранней установке,
обязана быть подписанной: если у неё нет собственных файлов с хешами, она
получает файлы архива и проверяется по ним.
Запуск с проверкой¶
Команда tt --integrity-check public.pem instance start проверяет каждое
приложение в его собственном каталоге - в проекте или в установленной версии - и
в каталогах сред выполнения, на которых оно работает, независимо от того, из
какого каталога запущен tt, и запускает только то, что ими подписано: tarantool
приложения, который обязан быть подписанным tarantool из архива, а не бинарным
файлом из PATH, скрипт записи, бинарный файл внешнего процесса, который ищется
только в .rocks/bin/ приложения, и сам tt, запускающий процесс-наблюдатель
(watchdog), который обязан быть включённым в пакет. Watchdog повторно проверяет
их каждые --integrity-check-period секунд и при ошибке проверки останавливает
экземпляр навсегда. Tarantool получает hashes.json приложения для проверки
того, что он загружает.
Ограничения¶
Пара хоста в <root>/etc/<app>/ не входит в пакет, и приложение, запускаемое по
ней, при включённых проверках отвергается; оно запускается по шаблону своего
пакета, --template. Подписанная установка в область установки проекта, чей
корень установки проект делит с гостевыми пакетами, и подпись проекта в процессе
разработки пока не поддерживаются. Подписи содержат случайную соль, поэтому
подписанный архив, в отличие от неподписанного, не воспроизводится бит в бит.
С флагом --integrity-check tt читает манифесты и исполняемые файлы
внешних модулей также через
проверку, и файл, не перечисленный ни в одном подписанном файле с хешами,
отвергается: модуль вне подписанного дерева пропускается с предупреждением,
а модуль, чей исполняемый файл не подписан, не запускается.
Структура каталогов в Tarantool Enterprise¶
tt передаёт экземпляру пути структуры каталогов - каталоги данных, pid-файл,
сокеты и журнал - через переменные TT_*_DEFAULT его окружения. Tarantool
Enterprise при проверке целостности запускается с пустым окружением, поэтому под
--integrity-check эти переменные до него не доходят, и он возвращается к
значениям по умолчанию Tarantool относительно своего рабочего каталога (каталога
установленной версии): var/lib/<instance> для данных,
var/run/<instance>/tarantool.pid и var/run/<instance>/tarantool.control, а
также var/log/<instance>/tarantool.log для файла журнала.
Подписанная установка превращает эти значения по умолчанию в саму структуру
каталогов. Команда tt package install --integrity-check создаёт в версии
var/lib, var/run и var/log как ссылки на <root>/var/lib/<app>,
<root>/var/run/<app> и <root>/var/log/<app>, поэтому конфигурация, не
указывающая пути явно, сохраняет данные, pid-файл и сокет консоли экземпляра в
структуре каталогов корня, где их находит tt, точно так же, как без проверок.
Каждая версия приложения ссылается на те же каталоги, поэтому данные переживают
обновление, а удаление версии удаляет её ссылки, но не сами данные. Ссылки не
входят в состав подписанного содержимого, и подписанный пакет не может содержать
собственный каталог var/: сборка пакета завершится с ошибкой.
tt instance start --integrity-check создаёт недостающие ссылки в версии -
установленной до того, как их стал делать tt, - если у неё есть права на запись
туда, и отказывается запускать экземпляр, в версии которого на этом месте
находится что-то другое.
Конфигурация может по-прежнему задавать пути сама - в кластерной
конфигурации пакета или в его хранилище конфигураций; tt считывает каталоги
данных, сокет консоли и первый unix-сокет из iproto.listen из конфигурации
экземпляра с подстановкой {{ instance_name }}, {{ replicaset_name }} и
{{ group_name }}. В области установки системы, корнем которого в Linux служит
/opt/tarantool, для пакета <app>:
snapshot:
dir: /opt/tarantool/var/lib/<app>/{{ instance_name }}
wal:
dir: /opt/tarantool/var/lib/<app>/{{ instance_name }}
vinyl:
dir: /opt/tarantool/var/lib/<app>/{{ instance_name }}
quiver:
dir: /opt/tarantool/var/lib/<app>/{{ instance_name }}
process:
pid_file: /opt/tarantool/var/run/<app>/{{ instance_name }}/tarantool.pid
console:
socket: /opt/tarantool/var/run/<app>/{{ instance_name }}/tarantool.control
iproto:
listen:
- uri: unix/:/opt/tarantool/var/run/<app>/{{ instance_name }}/tarantool.sock
Параметр quiver.dir есть только в Tarantool Enterprise; Tarantool Community
его отвергает. Перемещение путей по умолчанию через process.work_dir
невозможно: Tarantool ищет модули приложения, в том числе app.file, в своём
рабочем каталоге и после его переноса ничего там не находит.
То, что проверки отсекают вместе с окружением, остаётся недоступным, как было и в tt 2:
- По умолчанию нет адреса iproto: экземпляр слушает то, что указано в
секции
iproto.listenего конфигурации, и командеtt connect --binaryнужен указанный там unix-сокет;tt connectчерез сокет консоли работает и без него. - Журнал выводится в стандартный поток ошибок экземпляра, который tt записывает
в
tt.logструктуры каталогов, откуда его читаетtt instance logs; директиваlog.to: fileзаписываетtarantool.logрядом с ним. - Переменная
envиз записи экземпляра Tarantool до него не доходит: сборка подписанного пакета иtt instance start --integrity-checkотвергают запись, задающую её, а значения должны находиться в конфигурации. Внешний процесс сохраняет свои переменныеenv: их запускает tt. - Запись, запускающая собственный скрипт, при проверках отвергается: tt запускает её через лаунчер, берущий скрипт и пути экземпляра из окружения. Вместо этого экземпляр настраивается конфигурацией кластера.