Files
MikrotikManager/docs/mcp-bandwidth-control-source.md
T

77 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Подписанный источник 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).