Files
MikrotikManager/docs/mcp-bandwidth-peer-v2.md
T

28 lines
8.3 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 peer v2: внешний узел и общий canonical registry
Внутренняя ссылка `BandwidthPeerRef` различает управляемый сервер и внешний enrollment UUID. `credentialServerId` выбирает источник bandwidth-credentials отдельно от фактического получателя. Внешний узел не создаёт фиктивный сервер Manager. Общий execution host сохраняет исходные address/VRF/zone, body и duration.
`bandwidth-peer-observation.ts` выполняет настоящий аутентифицированный `GET /system/license` через фиксированный server-owned management source. Оба вида peer получают непрозрачное наблюдение того же экземпляра reader, исходный wall/monotonic срок и typed claims. Наблюдение внешнего получателя не выдаёт ему право выполнять source-команду. License observation само по себе не доказывает mapping bandwidth-адреса, физическую уникальность или защиту от клонирования.
Внешний registry расширяет owner-installed control schema двумя таблицами aliases/events. Узлы, issuer key, claim/node MAC domains и registry advisory lock общие с managed registry. Одинаковый typed claim vector даёт тот же canonical node; новый external alias не освобождает неизвестную занятую пару. Aliases нельзя перепривязать или активировать после terminal retirement. Потерянный ACK реального COMMIT требует сверки и возвращает `UNKNOWN`, без автоматического повтора.
Signed bootstrap v2 явно связывает исходный и внешний DDL и combined catalog pin. V1 serialization и hash сохранены; старая v1-проверка отвергает добавленный footprint с входящими FK. Никакого автоматического обновления pin, выпуска ключа или enrollment при старте нет. V2 source и participant fence проверяют обе роли, оба каталога, authority, исходные файлы и ключи на существующем lease.
Для v2 эти metadata берутся одним bounded MATERIALIZED SQL snapshot. Используются прежние строгие pure validators; before/after file/key/actor guards сохранены. Readonly alias resolver отдельно читает alias, узел, enrollment event и authority одним SELECT в одном MVCC snapshot и проверяет все четыре MAC. Он не выполняет BEGIN/COMMIT, DML, enrollment или очистку occupancy. Все оставшиеся асинхронные границы сохраняют исходные identity/authority/binding проверки. Это устраняет лишние roundtrips без увеличения пятисекундного срока наблюдения.
Операторская композиция принимает отдельный Ed25519 signed grant, genuine coordinator и непрозрачный prerequisite. Grant привязан к исходному времени до первого file IO; откат часов не продлевает его. Текущий grant и независимый quiescence verifier проверяются до чтения credentials и повторно после IO. Bridge вызывает настоящие managed/external registry factories. Подписанное заявление оператора не заменяет действующий writer barrier.
Production MCP original provider для `routing.measure` формирует body из настоящего sealed service input и сам выбирает native destination address. Он проверяет исходный service step, SQL-состояние, актуальный доступ, scope, endpoints, existing generation/key и первоначальный срок. Source adapter допускает только исходные managed endpoints; право на внешний peer через credential provider не выводится.
## Граница текущей поставки
V2 host проверен на owned PostgreSQL с настоящими signed source/bootstrap, canonical alias resolution, mixed participant fence, reserve/arm/complete, localhost native POST и durable unknown. В этом профиле original-context и independent wire-mapping providers явно синтетические: он подтверждает исполнение host, а не готовность production mapping attestor или всех callers. Операторская композиция дополнительно прошла настоящую цепочку signed grant → license GET → configured source → PostgreSQL registry для обоих видов peer; проверены отзыв до credentials и отзыв после ACK реального COMMIT. Независимый quiescence verifier в этом тесте моделируется, эксплуатационный adapter ещё открыт.
Общий cross-writer barrier остаётся обязательным до активации. Transaction-scoped shared registry check, завершившийся до фактической конструкции HTTP-запроса, не закрывает окно final check → native dispatch. Дополнительное чтение не заменяет удержание и передачу владения. Нельзя объявлять эту границу решённой по зелёному localhost-тесту.
Открыты production independent wire mapping (включая external/NAT/DNS/VRF/zone), полный operator workflow с действующим quiescence/barrier, original providers и migration всех REST/scheduler/MCP/direct callers, after-ping/history полного speed workflow, публичная mediation и сетевая приёмка. Доступны два CHR; трёхузловую приёмку это не закрывает.
Проверки компонента: `npm --prefix backend run test:bandwidth-peers`; owned SQL/HTTP профиль: `npm --prefix backend run test:bandwidth-peers:pg`. Последний создаёт отдельный localhost-кластер с 39 штатными миграциями в application DB и явной owner-installed control schema. Профиль не выполняет production enrollment, terminal restore, деплой, обращения к CHR или отправку уведомлений.
Повторная приёмка после восстановления сервиса разрешений описана в [текущем отчёте](mcp-bandwidth-resumed-checks-20261026.json). Private permit-bound HTTP/TLS handoff применён в исходниках: запрос не пишет bytes до готовности сокета и повторной проверки полномочий, барьер удерживается до `ClientRequest.finish` и закрывается до длинного ответа. Проверены очередь Agent, свежий/повторно используемый TLS socket, отзыв, отмена, исходный body и one-shot permit. Это ещё не настоящий SQL producer или общий writer barrier. Отдельный набор: `npm --prefix backend run test:bandwidth-native-dispatch`; для синтетического TLS-сертификата требуется `MMAPP_TEST_OPENSSL` с путём к установленному OpenSSL. Deadline-sensitive наборы запускаются одним test worker; сроки и проверки не меняются. Изолированный operator suite проходит, общий peer suite и SQL profiles пока не приняты целиком; исторические результаты выше не заменяют эту приёмку.