10 KiB
Операторский 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; v2createBandwidthPeerObservationReaderиспользует настоящий 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/externalpeerRef, вызывает обязательный независимый fixedquiescence.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 v2peerRef.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.
Конечная последовательность
- Оператор устанавливает control store, роли, pinned source, independent registry issuer и отдельный operator public-key pin. Закрытые ключи и owner credentials не передаются MCP/модели. При неизвестном результате provisioning сверяют исходный pending/final record и immutable identity, не создают новое generation.
- Оператор инвентаризирует прежние native bandwidth executors, останавливает их и устанавливает проверяемый fence для их перезапуска. Независимый доверенный quiescence verifier должен проверять именно текущий fence и исходный inventory; подписанное утверждение
executorsStoppedAtэтого не заменяет. Живой executor, недоступный verifier или утрата fence запрещают enrollment. - Выбирают настоящий peer reference. Managed:
{kind:'server',serverId}. External:{kind:'external',enrollmentId}с отдельной существующей enrollment записью.enrollmentIdне является application server ID. Credential provider bandwidth command может быть третьим узлом. - По независимому authenticated management channel получают ordered typed
/system/licenseclaims и fixed management-source binding. Для external без management channel допустим только отдельный trusted external attestor. Полностью неподконтрольный remote без attestor остаётся без independent proof; fake server ID, credential-provider identity и произвольный UUID этот пробел не закрывают. - Исходный авторизованный оператор подписывает exact peer/source/epoch/typed-claims, installation, registry issuer, quiescence proof/inventory, grant ID и короткое время действия. Это отдельное полномочие, не обычный network-write. Runtime получает только фиксированный путь к текущему grant и отдельный public pin. Замена/удаление grant отзывает выданный prerequisite.
- Enrollment coordinator перечитывает и проверяет исходный grant, вызывает fixed quiescence verifier, сам получает настоящий native license observation, сверяет точный signed vector/source и повторяет проверки. Выдаётся opaque same-instance prerequisite. Capability не восстанавливается из JSON и не переживает close/expiry/cancellation.
- Отдельная операторская транзакция
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 запрещает запуск. - Оператор отдельно доказывает принадлежность 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. - После 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 доказательством.