Files
MikrotikManager/docs/mcp-bandwidth-operator-workflow.md
T

29 lines
10 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.
# Операторский enrollment bandwidth: конечный workflow
Это обязательный этап полного bandwidth-плана. Подпись operator grant подтверждает исходного оператора; сама по себе она не подтверждает остановку executors, mapping native адреса, запись registry или готовность dispatch.
## Действительные APIs и границы
- `sealEmptyBandwidthControlSource` и `seal-bandwidth-control-source.ts` выпускают привязку предварительно установленного пустого control store. Они не создают RouterOS enrollment.
- `createConfiguredBandwidthNodeSource` проверяет bootstrap, independent issuer key, SQL source/catalog/roles на одном lease. Он не выдаёт human enrollment authority.
- `createBandwidthNodeObservationReader` получает настоящий `/system/license` для managed server; v2 `createBandwidthPeerObservationReader` использует настоящий managed/external peer reference и отдельный authenticated management source. `observe` выдаёт private same-reader observation, `inspect` повторно проверяет credentials/source/epoch. JSON лицензии не заменяет observation.
- `createBandwidthNodeRegistry().register` сохраняет canonical UUID и alias, только если genuine observation и original enrollment authority приняты повторными guards. Совпавший keyed typed claim vector использует существующий UUID. Quarantine/tombstone не освобождают unknown occupancy.
- `createBandwidthOperatorEnrollmentPrerequisite` проверяет отдельную pinned Ed25519 подпись исходного operator grant для managed/external `peerRef`, вызывает обязательный независимый fixed `quiescence.verify`, заново получает license native GET v2 и повторно проверяет grant/fence. И `acquire`, и `inspect` проверяют текущий grant/quiescence до чтения management credentials. Исходный monotonic budget захватывается до file IO и связывает signed expiry с исходными wall/monotonic часами; rollback wall clock во время ожидания не продлевает grant. Он не пишет control DB, не выпускает ключи, не имеет runtime getter и не выдаёт execution permit. Verifier передаётся только доверенной server-side композицией и захватывается при создании; в запросе его заменить нельзя. Production verifier должен проверять подлинный executor fence; успешный synthetic callback такого доказательства не даёт.
- `createBandwidthOperatorRegistry` принимает только созданный настоящей factory coordinator: private module WeakSet отвергает structural facade и копию до обращения к source. Он замыкает genuine coordinator и fixed source при создании. Единственный публичный метод `register(prerequisite,scope)` вызывает настоящую managed/external factory, проверяет installation/issuer/quiescence binding и original prerequisite до/после асинхронных registry guards, source SQL и issuer MAC. Для managed он переводит genuine v2 `peerRef.serverId` в v1 evidence; external получает v2 напрямую. Scope/observation/grant expiry не обновляются. Потерянный COMMIT ACK или истечение времени после начала COMMIT сохраняет UNKNOWN без replay. Source обязан независимо pin-ить полный установленный catalog и MAC domains; старый managed-only source не становится external source через этот bridge. Private brand не доказывает writer barrier или production quiescence.
## Конечная последовательность
1. Оператор устанавливает control store, роли, pinned source, independent registry issuer и отдельный operator public-key pin. Закрытые ключи и owner credentials не передаются MCP/модели. При неизвестном результате provisioning сверяют исходный pending/final record и immutable identity, не создают новое generation.
2. Оператор инвентаризирует прежние native bandwidth executors, останавливает их и устанавливает проверяемый fence для их перезапуска. Независимый доверенный quiescence verifier должен проверять именно текущий fence и исходный inventory; подписанное утверждение `executorsStoppedAt` этого не заменяет. Живой executor, недоступный verifier или утрата fence запрещают enrollment.
3. Выбирают настоящий peer reference. Managed: `{kind:'server',serverId}`. External: `{kind:'external',enrollmentId}` с отдельной существующей enrollment записью. `enrollmentId` не является application server ID. Credential provider bandwidth command может быть третьим узлом.
4. По независимому authenticated management channel получают ordered typed `/system/license` claims и fixed management-source binding. Для external без management channel допустим только отдельный trusted external attestor. Полностью неподконтрольный remote без attestor остаётся без independent proof; fake server ID, credential-provider identity и произвольный UUID этот пробел не закрывают.
5. Исходный авторизованный оператор подписывает exact peer/source/epoch/typed-claims, installation, registry issuer, quiescence proof/inventory, grant ID и короткое время действия. Это отдельное полномочие, не обычный network-write. Runtime получает только фиксированный путь к текущему grant и отдельный public pin. Замена/удаление grant отзывает выданный prerequisite.
6. Enrollment coordinator перечитывает и проверяет исходный grant, вызывает fixed quiescence verifier, сам получает настоящий native license observation, сверяет точный signed vector/source и повторяет проверки. Выдаётся opaque same-instance prerequisite. Capability не восстанавливается из JSON и не переживает close/expiry/cancellation.
7. Отдельная операторская транзакция `createBandwidthOperatorRegistry(...).register(prerequisite,scope)` через genuine source использует этот prerequisite в `authorize('register', ...)` и повторно проверяет original authority/quiescence последним guard перед SQL/COMMIT. Она сохраняет стабильный existing canonical node для совпавшего vector; не принимает node UUID из запроса. При потерянном COMMIT ACK оператор сверяет исходную запись, не удаляет unknown и не перевыпускает alias для обхода отказа. Production composition подключает только source, чья подписанная привязка покрывает обе alias-таблицы и соответствующие HMAC domains; отсутствие такого pin запрещает запуск.
8. Оператор отдельно доказывает принадлежность bandwidth wire endpoint этому canonical node и разрешённым source realms/VRF/zone. DNS/NAT/forwarding требуют текущей authority на mapping. Management IP и `/system/license` сами это не доказывают. Только затем fixed runtime resolver может связать exact native target с enrolled incarnation и current original caller authority.
9. После managed/external caller matrix, сохранения оригинальных native body/duration/after-ping/history, writer barrier, restore и multiprocess fault проверки включается mandatory strict gate. Наличие unit-теста или подписанного enrollment grant этого не заменяет.
## Проверяемые текущие ограничения
Prerequisite и registry bridge являются компонентами операторского этапа, а не завершённым production enrollment. Положительная проверка bridge использует настоящий branded coordinator, подписанные synthetic operator files, authenticated localhost license GET и настоящие managed/external registry factories на инертном SQL state machine. Проверены canonical reuse, unknown preservation, исходный revoke/expiry, drift, lost/rows-only/held COMMIT и запрет replay. До устранения синхронного дублирования file guards реальный четырёхсекундный fixture budget истекал; лимиты не увеличивались, before/after проверки реального IO сохранены. В этом пакете не выполняются реальные operator signing/quiescence, RouterOS изменения, production registry mutation, remote upload или deployment. Production quiescence adapter, combined signed source/catalog, independent endpoint mapping и полная caller activation должны иметь собственную проверенную реализацию; synthetic fixtures не являются их production доказательством.