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

8.3 KiB
Raw Blame History

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 или отправку уведомлений.

Повторная приёмка после восстановления сервиса разрешений описана в текущем отчёте. 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 пока не приняты целиком; исторические результаты выше не заменяют эту приёмку.