Files
MikrotikManager/backend/src/modules/mcp/ros-prefix.ts
T
DenozordecandClaude Opus 5.5 6584644112 fix(mcp): проверять права раз на этап, читать каталоги параллельно, отказ VRF только повторный
Решение владельца 2026-11-19 (ускорение и упрощение проверок при той же итоговой защите):
- права шага RouterOS доказываются свежей проверкой на границах этапа (начало шага,
  прямо перед отправкой, сразу после ACK, перед каждой записью); чтения внутри этапа
  повторно используют доказательство моложе 2 с. Сервисные шаги проверяют права на
  каждый вызов, как раньше: их проверка общая для чтений и записей;
- независимые каталоги при проверках и в снимке VRF читаются параллельно (пул REST
  ограничивает 2 соединениями на роутер), порядок снимка прежний; после ACK изменённый
  каталог читается один раз;
- конфликт каталога в проверке перед отправкой помечает операцию «не отправлено»;
- VRF: помеченный отказ классификатора окончательный, только если тот же отказ
  повторился на свежем чтении (в пределах 8 повторов).

Интеграционный набор PostgreSQL: 164 проверки пройдены; общие 92 проверки 401 -> 354 с.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-19 11:06:29 +07:00

54 lines
3.8 KiB
TypeScript

import { fingerprint, McpError } from "./security.js"
import { isSingletonRosResource, readRosSnapshot, rosSnapshotVersion, type RosSnapshot, type RosStep } from "./resources.js"
import { verifyRosStepSnapshots } from "./ros-step-verification.js"
import { acknowledgedCreateId } from "./native-create-identity.js"
const key = (snapshot: Pick<RosSnapshot, "serverId" | "resource">) => `${snapshot.serverId}:${snapshot.resource}`
function valid(snapshot: RosSnapshot): boolean {
if (snapshot.projectionVersion !== rosSnapshotVersion(snapshot.resource) || typeof snapshot.sourceProof !== "string" || !/^[a-f0-9]{64}$/.test(snapshot.sourceProof) || !Array.isArray(snapshot.rows) || snapshot.fingerprint !== fingerprint(snapshot.rows)) return false
if (isSingletonRosResource(snapshot.resource)) return snapshot.rows.length === 1 && !!snapshot.rows[0] && typeof snapshot.rows[0] === "object" && !Array.isArray(snapshot.rows[0])
const ids = snapshot.rows.map(acknowledgedCreateId)
return ids.every(id => id !== undefined) && new Set(ids).size === ids.length
}
function matches(expected: RosSnapshot, current: RosSnapshot): boolean {
return valid(current) && key(expected) === key(current) && expected.sourceProof === current.sourceProof && expected.fingerprint === current.fingerprint
}
/** The baseline advances only after a complete, acknowledged projected change. */
export function createRosPrefix(snapshots: RosSnapshot[], read: typeof readRosSnapshot = readRosSnapshot) {
let expected = new Map<string, RosSnapshot>()
for (const snapshot of snapshots) {
if (!valid(snapshot)) throw new McpError("PLAN_EXPIRED", "Сетевой снимок имеет устаревший контракт; подготовьте новый план", 409)
const previous = expected.get(key(snapshot))
if (previous && !matches(previous, snapshot)) throw new McpError("STATE_CONFLICT", "Неоднозначный исходный сетевой снимок", 409)
expected.set(key(snapshot), structuredClone(snapshot))
}
// Independent catalogs are read concurrently (the shared REST pool bounds it to 2 per router).
const checkMap = async (map: Map<string, RosSnapshot>, beforeRead: () => Promise<unknown>, code: string, alreadyRead?: string) => {
await Promise.all([...map.values()].filter(snapshot => key(snapshot) !== alreadyRead).map(async snapshot => {
const current = await read(snapshot.serverId, snapshot.resource, beforeRead, snapshot.sourceProof)
if (!matches(snapshot, current)) throw new McpError(code, "Сетевой источник или ожидаемая конфигурация изменились; повтор записи запрещён", 409)
}))
await beforeRead()
}
return {
async check(beforeRead: () => Promise<unknown> = async () => {}) {
await checkMap(expected, beforeRead, "STATE_CONFLICT")
},
before(step: RosStep): RosSnapshot {
const snapshot = expected.get(key(step))
if (!snapshot) throw new McpError("STATE_CONFLICT", "Нет исходного снимка сетевого шага", 409)
return structuredClone(snapshot)
},
async advance(step: RosStep, result: unknown, after: RosSnapshot, beforeRead: () => Promise<unknown> = async () => {}) {
const before = expected.get(key(step))
if (!before || !valid(after) || before.sourceProof !== after.sourceProof || !verifyRosStepSnapshots(step, result, before, after)) throw new McpError("VERIFICATION_FAILED", "Изменение сетевого каталога не совпало с подтверждённым шагом", 409)
const next = new Map(expected)
next.set(key(after), structuredClone(after))
// `after` is the caller's fresh post-ACK read of the target; re-read only the other catalogs.
await checkMap(next, beforeRead, "VERIFICATION_FAILED", key(after))
expected = next
},
}
}