Files
MikrotikManager/docs/bandwidth-peer-metadata.md
T

42 lines
8.8 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.
# Private peer metadata: managed-путь OP-M3
29 октября: [genuine guarded managed/external sources](bandwidth-operator-peer-sources.md) приняты и закрывают OP-M3 **как компонент**. OP-M4 и полная эксплуатационная приёмка остаются открыты. Старый standalone managed checker по-прежнему отклоняет external: для него теперь существует отдельный encrypted-profile provider.
Остальная страница описывает первоначальный managed-only срез: 29 новых тестов и 4 сквозных PostgreSQL/localhost-сценария. Его прежние замечания об отсутствии external provider — исторические; актуальные границы и proof нового guarded source приведены по ссылке выше.
## Поток данных
`BandwidthPeerTrustedSource` допускает дополнительный own data-method `assertMetadataCurrent(expected, scope)`. Reader захватывает его при создании. Запрос на проверку не принимает callback, SQL или источник. Если метода нет, `inspectMetadata` отказывает; повторного `read` или другого credential fallback нет.
`reader.inspectMetadata(observation, scope)` принимает только настоящее наблюдение из собственного private WeakMap. Приватный первоначальный snapshot уже содержит credentials, полученные обычным `observe` под прежними guards. Этот snapshot передаётся только захваченному trusted checker внутри сервера; наружу возвращается отдельный wrapper `mmapp-bandwidth-peer-public-metadata-v1` с исходным evidence. Endpoint, пароль или unkeyed password hash не возвращаются.
`coordinator.inspectMetadata(prerequisite, scope)` принимает только уже созданный private prerequisite. Он проверяет текущий подписанный grant до и после reader metadata, неизменность исходных grant/evidence и прежний wall/monotonic horizon. Формат ответа — `mmapp-bandwidth-operator-enrollment-metadata-v1`, данные вложены в `metadata`. Это публичный снимок, не strong inspection или Q/write capability. Старые `acquire`/`inspect` сохраняют прежние Q и credential/native проверки.
Новый путь не делает текущий license GET, не читает source credentials заново и не утверждает наличие текущего Q. Перед настоящим effect будущая закрытая композиция обязана заново проверить оригинальный допуск, физического владельца, source и Q. Получение metadata нельзя использовать вместо этих проверок.
## Managed checker
`createManagedBandwidthPeerMetadataChecker()` инертен. При вызове он использует существующий application pool и один фиксированный `SELECT EXISTS` над `public.servers`. Все факты сравниваются внутри PostgreSQL: ID, enabled, host, port, TLS, verify TLS, username, password и routing endpoint epoch. Результат содержит только `metadata_current`.
В текущей схеме `servers.password` хранится как text; предположение о ciphertext здесь неверно. Checker сравнивает первоначальный приватный пароль как bound parameter, аналогично существующему MCP current snapshot. Это не новая выдача credentials из БД и не вычисление опубликованного password digest. SQL-параметры, endpoint и ошибки драйвера не логируются этим компонентом.
Сохраняются исходные deadline/signal; импорт pool, checkout и query входят в bounded operation. Проверяются настоящий SELECT ACK, rowCount и единственный data-only boolean. Abort, socket error, неверный ответ или позднее соединение приводят к безопасному закрытию; неизвестный release не повторяется, raw error не выдаётся. Дополнительного pool, роли, процесса или миграции нет.
Этот checker принимает только managed peer. External peer отказывается до import/checkout, без подстановки server ID и без повторного получения credentials. Generic trusted protocol позволяет позднее добавить отдельный фиксированный external provider, но сегодня такого production provider нет. Повторное чтение supplied snapshot или его JSON-копии не считается current metadata proof; нужна действующая привязка к реальному management-source record и его generation/endpoint/credentials.
Сам managed SQL checker подтверждает только текущие факты `servers`. Он не аутентифицирует actor, portal claims, `sourceProof` или generation другого service provider. Coordinator проверяет свой текущий signed operator grant; если реальный источник имеет дополнительные original authority/source-generation зависимости, их проверка должна войти в соответствующий fixed metadata adapter до production wiring. В owned-профиле источник management authority задан fixture, а Q verifier синтетический. Эти границы не позволяют считать весь OP-M3 завершённым.
## Что подтверждено
- 29 новых tests: actual localhost license и signed grant/private origins у reader/coordinator; управляемый SQL transport у checker. Покрыты capture зависимостей, отсутствие fallback, getter/Proxy/signal overrides, отмена/дедлайн/close/late output, отозванный grant и source drift.
- Actual owned PG/localhost: signed grant и genuine license создают origin, затем 17 coordinator metadata checks обходятся без новых credential projections, Q или native. Шесть неверных private predicates отклонены при неизменном epoch и неизменной строке — совпадения epoch недостаточно.
- Реальные изменения password/username/host/port/TLS/verify/enabled отклоняются. Штатный trigger меняет epoch; восстановление прежнего значения не оживляет старый origin. Для следующего опыта создаётся новый signed grant и новое наблюдение. Trigger не выключается, epoch не подделывается.
- Удалённый grant и JSON-копия prerequisite отказывают до metadata SQL. Исходные endpoint-поля восстановлены; epoch закономерно продвинут trigger, собственная fixture row удалена при cleanup. Все 39 миграций сохранены.
- Полная peer-регрессия и backend build прошли. Реальные CHR, Docker, рабочая БД и оставшееся окно стенда не использовались.
Прогон: `npm --prefix backend run test:operator-peer-metadata:pg`, только отдельный disposable cluster без restore/другого профиля. [Source-pinned отчёт](mcp-operator-peer-metadata-managed-acceptance-20261028.json).
## Что осталось
Нужен fixed external metadata provider с реальной current management-source привязкой. Затем — интеграция metadata в private fixed registry/effect pipeline на том же физическом lease, с Q на всех реальных effect boundaries и положительным measured-latency прогоном. OP-M3 и OP-M4 остаются открыты; в остатке operator window принято 2/4 внутренних шагов, в S3 — 5/10.