11 KiB
Подписанный источник bandwidth control
Для journal, уже удерживающего собственный core lease, добавлен eventProofOnConnection(event, connection, scope). Он проверяет private same-source provenance и текущий source на том же физическом соединении; fake, foreign и released lease отвергаются. Payload фиксируется до первого await, ключ повторно читается и обнуляется после HMAC. Пятый checkout не требуется: четыре реальные journal-транзакции одновременно доходят до подписи при полностью занятом пуле, затем завершают reserve и подтверждённый no-send. Обычный eventProof(event, scope) сохранён для самостоятельных операций; его нельзя использовать как вложенный checkout в занятой journal-транзакции. Приёмка. Это source snapshot, а не общий атомарный writer barrier или разрешение на native send.
Реализован отдельный компонент допуска, проверяющий операторскую подпись Ed25519, закреплённый публичный ключ, ключ событий, минимальные SQL-права и точный каталог control-схемы. Он не выдаёт общий DB READY, не включает нативные вызовы и не доказывает защиту от отката/клонирования самого control-провайдера. Постоянная привязка CHR и общий transport guard ещё обязательны перед включением speed MCP.
Явная подготовка оператором
Использовать отдельную БД с именем, отличным от БД приложения. Её владельцем должна быть отдельная роль owner, без SUPERUSER, CREATEDB, CREATEROLE, REPLICATION, BYPASSRLS. Runtime и application restore используют другие роли и не состоят в owner/runtime через транзитивное членство. Application restore не получает доступ к mmapp_control или владение control-БД. Проверка источника отказывает при нарушении этих условий.
Роли, БД, существующие ключи и доверенную границу хранения оператор подготавливает отдельно. Backend не генерирует их при запуске. Приватный ключ issuer хранится вне backend; runtime получает только публичный PEM Ed25519, закреплённый SHA256 его SPKI DER и отдельный raw-ключ событий ровно 32 байта. Файлы ключей и конфигурации доступны только соответствующим операторским/runtime ролям ОС. Runtime не должен иметь права менять подписанную конфигурацию, её каталог, ключи или pin.
Для получения фиксированного SQL из текущей сборки:
npm --silent --prefix backend run bandwidth:control:seal -- --print-schema
Команда только печатает DDL. Применить его от имени owner к пустой control-БД. Не копировать старые public-журналы и не создавать namespace автоматически при недоступном источнике. После DDL owner отзывает PUBLIC-права на schema, tables и functions и выдаёт runtime только:
| Объект | Runtime-права |
|---|---|
mmapp_control |
USAGE |
bandwidth_attempts |
SELECT, INSERT, UPDATE |
bandwidth_node_occupancy |
SELECT, INSERT, DELETE |
bandwidth_attempt_events |
SELECT, INSERT |
bandwidth_source_identity |
SELECT |
| Семь фиксированных trigger functions | EXECUTE |
Никаких UPDATE на occupancy, DELETE на attempts/events, TRUNCATE, CREATE, grant options, дополнительных column grants, ownership или опасных helper memberships. Runtime-verifier проверяет фактические права, а не только выполненные GRANT-команды.
Выдача привязки
Подготовить защищённый операторский JSON с полями:
{
"ownerDatabaseUrl": "postgresql://control_owner:OWNER_PASSWORD@control-db:5432/bandwidth_control",
"databaseUrl": "postgresql://control_runtime:RUNTIME_PASSWORD@control-db:5432/bandwidth_control",
"applicationDatabaseUrl": "postgresql://app_runtime:APP_PASSWORD@app-db:5432/mmapp",
"attestationFile": "/etc/mmapp/control/source.json",
"trustKeyFile": "/etc/mmapp/control/issuer-public.pem",
"trustKeySha256": "REPLACE_WITH_SHA256_OF_PUBLIC_SPKI_DER",
"eventKeyFile": "/etc/mmapp/control/event.key",
"issuerPrivateKeyFile": "/secure/operator/issuer-private.pem",
"attestationRef": "Operator change reference identifying this explicit empty-store provisioning"
}
Все пути абсолютные, канонические и различные; файлы не symlink. В командную строку пароли и приватные ключи не передавать. Из операторского окружения выполнить:
npm --prefix backend run bandwidth:control:seal -- --config /secure/operator/control-config.json
Issuer требует уже установленный пустой store и отдельную owner-сессию, блокирует все четыре таблицы, проверяет runtime-права и фиксированный каталог. Создаёт новые installation/generation UUID только в этой явной операции. Подписанный source.json.pending сохраняется с wx, file fsync и parent-directory fsync до INSERT identity/COMMIT; synchronous_commit=on устанавливается явно. После подтверждённого COMMIT настоящий runtime-reader проверяет эту же конфигурацию. Публикация source.json выполняется атомарной ссылкой без замены существующего файла и с повторным directory fsync; pending сохраняется как свидетельство той же попытки. Оба имени указывают на одни данные и должны оставаться защищены от записи runtime.
Окончательный issuer требует поддержки directory fsync. На текущей Windows FS получен EPERM: команда отказывает до SQL и создания файлов. Обхода с ослабленной durability нет. Текущая положительная приёмка относится к reader/реальным ролям и явно synthetic owner-installed identity. Для окончательного issuer ещё нужен положительный Linux/поддерживаемая FS прогон и COMMIT/publish fault-профиль. Ранее успешный прогон issuer до исправления directory durability сохраняется только как исторический результат.
Любой отказ оставляет существующие файлы и identity. Повторная команда не меняет их и не создаёт поколение для обхода отказа. При неопределённом COMMIT или публикации оператор должен сверить оригинальный pending, его подпись, hash и immutable identity. Автоматического recovery/перевыдачи нет; удалять pending или identity ради повторной попытки нельзя. Политика согласованного восстановления самого control-провайдера ещё требует отдельной реализации и приёмки.
Runtime
Поля MMAPP_BANDWIDTH_CONTROL_* перечислены в backend/.env.example. DATABASE_URL остаётся URL приложения; owner URL и приватный ключ issuer backend не получает. PostgreSQL URL допускают только TLS query parameters (sslmode, sslrootcert, sslcert, sslkey, sslpassword) без повторов. Параметры user, host, dbname, options и любые другие overrides отвергаются, чтобы URL username совпадал с проверяемой ролью. Endpoint digest включает имя runtime/БД и параметры соединения, но исключает пароль. Смена endpoint, ключа, схемы, владельца или generation без соответствующей согласованной внешней привязки приводит к отказу.
Конструктор/import не подключается к БД. Каждый checkout и каждая SQL-команда проверяют подписанные файлы и источник до и после выполнения. Срок lease не более 10 секунд. Отсутствующая identity, неверная подпись/pin, дрейф SQL-прав/каталога, quarantined source и истечение допуска не разрешают новый event MAC. Отказ не освобождает занятую пару узлов.
Профили проверки:
npm --prefix backend run test:bandwidth-control-source
npm --prefix backend run test:bandwidth-control-source:pg
npm --prefix backend run test:bandwidth-admission:pg
PostgreSQL-профили создают только изолированный локальный стенд. Доказательства действуют для проверенных ролей, DDL и сценариев; физическая идентичность CHR, native dispatch, capacity/retention и полная эксплуатационная готовность остаются в реестре работ.