77 lines
11 KiB
Markdown
77 lines
11 KiB
Markdown
# Подписанный источник 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-транзакции. [Приёмка](mcp-bandwidth-core-same-lease-acceptance-20261026.json). Это 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 из текущей сборки:
|
||
|
||
```powershell
|
||
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 с полями:
|
||
|
||
```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. В командную строку пароли и приватные ключи не передавать. Из операторского окружения выполнить:
|
||
|
||
```powershell
|
||
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. Отказ не освобождает занятую пару узлов.
|
||
|
||
Профили проверки:
|
||
|
||
```powershell
|
||
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 и полная эксплуатационная готовность остаются в [реестре работ](mcp-remaining-work-20261026.md).
|