Files
MikrotikManager/backend/src/services/ipsec-server-init-model.ts
T

146 lines
16 KiB
TypeScript

import { ipsecInitRequestSchema } from "@mmapp/contracts/ipsec"
import type { ServerRow } from "../modules/servers/repository/servers-repository.js"
import { McpError } from "../modules/mcp/security.js"
import { ipsecPeerDeletePaths, type IpsecPeerDeleteState } from "./ipsec-peer-delete.js"
import { observedBoolean } from "./ospf-observed-values.js"
import { IPSEC_CA_CERT, IPSEC_COMMON_NAME, IPSEC_SERVER_CERT, IPSEC_POLICY_GROUP, ipsecManagedComment, ipsecServerCertificateNames, isIpsecManagedComment, poolRangesFromCidr, selectIke2Peers, selectSharedIke2Identity } from "./ipsec-config.js"
import { identityRosBody, selectIpsecNatInterface } from "./ipsec-ros.js"
import { assertPoolMutationDependencies } from "./ipsec-pool-dependencies.js"
type Row = Record<string, string>
export type IpsecServerInitState = IpsecPeerDeleteState
export const ipsecServerInitRequest = ipsecInitRequestSchema.strict()
export interface IpsecServerInitCommand { action: "create" | "update" | "sign"; path: string; fields: Row; id?: string; name?: string }
const fail = (message: string, code = "STATE_CONFLICT") => new McpError(code, message, code === "INVALID_INPUT" ? 400 : code === "STATE_UNAVAILABLE" ? 502 : 409)
const exactId = (value: unknown): value is string => typeof value === "string" && /^\*[a-z0-9]+$/i.test(value) && value.length <= 100
const idKey = (value: string) => value.toLowerCase().replace(/^\*0+(?=[a-z0-9])/, "*")
export function validateIpsecServerInitState(state: IpsecServerInitState, nat: boolean) {
if (!state?.source || !state.catalogs || !Array.isArray(state.protections)) throw fail("Неполное состояние IPsec", "STATE_UNAVAILABLE")
for (const path of [...ipsecPeerDeletePaths, ...(nat ? ["/ip/route", "/interface"] : [])]) {
const rows = state.catalogs[path]
if (!Array.isArray(rows) || rows.length > 2000 || rows.some(row => !row || !exactId(row[".id"]) || Object.values(row).some(value => typeof value !== "string")) || new Set(rows.map(row => idKey(row[".id"]))).size !== rows.length) throw fail("Неполный native-каталог IPsec", "STATE_UNAVAILABLE")
const names = rows.map(row => row.name?.trim()).filter(Boolean)
if (path !== "/ip/ipsec/active-peers" && new Set(names).size !== names.length) throw fail("Неоднозначное имя IPsec")
for (const row of rows) if (row.name && exactId(row.name.trim()) && rows.some(other => other !== row && idKey(other[".id"]) === idKey(row.name.trim()))) throw fail("Неоднозначное имя/native ID IPsec")
}
}
export function planIpsecServerInit(state: IpsecServerInitState, server: ServerRow, raw: unknown) {
const parsed = ipsecServerInitRequest.safeParse(raw)
if (!parsed.success) throw fail("Некорректные поля инициализации IPsec", "INVALID_INPUT")
const body = parsed.data, ranges = poolRangesFromCidr(body.poolCidr), namesForCertificate = ipsecServerCertificateNames(body.serverEndpoint)
if (Number(body.serverId) !== server.id || !ranges || !namesForCertificate || (body.dns !== undefined && /[\x00-\x1f\x7f]/.test(body.dns))) throw fail("Некорректный сервер, endpoint, DNS или пул IPsec", "INVALID_INPUT")
validateIpsecServerInitState(state, body.createNatRule)
const c = state.catalogs, commands: IpsecServerInitCommand[] = [], companions: Array<{ kind: string; id: string }> = []
const kinds: Record<string, string> = { "/ip/ipsec/peer": "ipsec_peer", "/ip/ipsec/identity": "ipsec_identity", "/ip/ipsec/mode-config": "ipsec_mode_config", "/ip/pool": "ip_pool", "/certificate": "certificate", "/ip/ipsec/profile": "ipsec_profile", "/ip/ipsec/proposal": "ipsec_proposal", "/ip/ipsec/policy/group": "ipsec_policy_group", "/ip/ipsec/policy": "ipsec_policy", "/ip/firewall/nat": "firewall_nat" }
// Include the full raw closure, including foreign consumers and every protection.
for (const path of ipsecPeerDeletePaths) for (const row of c[path]) companions.push({ kind: kinds[path] ?? path, id: row[".id"] })
const named = (path: string, name: string) => { const row = c[path].find(item => item.name?.trim() === name); if (row && row.name !== name) throw fail("Не подтверждено точное имя IPsec"); return row }
const system = (row: Row) => { for (const flag of ["dynamic", "builtin", "default"]) if (row[flag] !== undefined && observedBoolean(row[flag]) !== false) throw fail("Системный объект IPsec нельзя изменять", "PROTECTED_OBJECT") }
const peer = named("/ip/ipsec/peer", IPSEC_COMMON_NAME)
const managedPeer = peer && isIpsecManagedComment(peer.comment)
const refs: Record<string, string> = { peer: "/ip/ipsec/peer", "mode-config": "/ip/ipsec/mode-config", "address-pool": "/ip/pool", certificate: "/certificate", "remote-certificate": "/certificate", ca: "/certificate", profile: "/ip/ipsec/profile", proposal: "/ip/ipsec/proposal", group: "/ip/ipsec/policy/group", "policy-template-group": "/ip/ipsec/policy/group" }
const alias = (value: string, row: Row) => value.trim() === row.name || (exactId(value.trim()) && idKey(value.trim()) === idKey(row[".id"]))
const references = (value: string | undefined, path: string, row: Row): boolean => {
if (!value?.trim()) return false
// An exact scalar name wins over CSV interpretation (certificate names may
// themselves contain commas). Otherwise inspect every list member.
if (c[path].some(item => alias(value, item))) return alias(value, row)
return value.split(",").some(part => alias(part, row))
}
const issuedBy = (child: Row, parent: Row) => {
if (references(child.ca, "/certificate", parent) || references(child.issuer, "/certificate", parent)) return true
const issuer = child.issuer?.trim(), cn = parent["common-name"]?.trim()
return !!issuer && !!cn && (issuer === cn || issuer.split(/[,/]/).some(part => part.trim().replace(/^CN\s*=\s*/i, "") === cn))
}
const consumers = (path: string, row: Row) => Object.entries(c).flatMap(([p, rows]) => rows.filter(item => Object.entries(refs).some(([field, target]) => target === path && references(item[field], path, row)) || (path === "/certificate" && p === "/certificate" && issuedBy(item, row))).map(item => ({ path: p, row: item })))
const pool = named("/ip/pool", IPSEC_COMMON_NAME)
const allowedPoolConsumers = [
...c["/ip/pool"].filter(row => isIpsecManagedComment(row.comment)).map(row => ({ path: "/ip/pool", id: row[".id"] })),
...c["/ip/ipsec/mode-config"].filter(row => isIpsecManagedComment(row.comment) || (row.name === IPSEC_COMMON_NAME && managedPeer) || c["/ip/ipsec/identity"].some(identity => isIpsecManagedComment(identity.comment) && references(identity["mode-config"], "/ip/ipsec/mode-config", row))).map(row => ({ path: "/ip/ipsec/mode-config", id: row[".id"] })),
]
assertPoolMutationDependencies(c, pool ? [pool] : [], allowedPoolConsumers)
const owned = (path: string, row: Row) => {
system(row)
const legacy = row.name === IPSEC_COMMON_NAME && ["/ip/ipsec/profile", "/ip/ipsec/mode-config"].includes(path) && managedPeer
const group = path === "/ip/ipsec/policy/group" && row.name === IPSEC_POLICY_GROUP && c["/ip/ipsec/policy"].some(p => references(p.group, path, row) && isIpsecManagedComment(p.comment))
if (!isIpsecManagedComment(row.comment) && !legacy && !group) throw fail("Имя IPsec занято чужим объектом", "PROTECTED_OBJECT")
for (const consumer of consumers(path, row)) {
if (consumer.path === "/certificate" && consumer.row[".id"] === row[".id"]) continue
if (consumer.path === "/ip/ipsec/policy" && observedBoolean(consumer.row.dynamic) === true) continue
const legacyMc = consumer.path === "/ip/ipsec/mode-config" && consumer.row.name === IPSEC_COMMON_NAME && managedPeer
if (!isIpsecManagedComment(consumer.row.comment) && !legacyMc) throw fail("Объект IPsec используется чужой конфигурацией", "DEPENDENCY_CONFLICT")
}
}
const upsert = (path: string, fields: Row, row = fields.name ? named(path, fields.name) : undefined) => {
if (row) owned(path, row)
commands.push({ action: row ? "update" : "create", path, fields, ...(row ? { id: row[".id"] } : {}) })
}
const certificate = (name: string, fields: Row, ca?: string) => {
const row = named("/certificate", name)
if (row) { owned("/certificate", row); if (!row["invalid-after"]?.trim() || !row.fingerprint?.trim()) throw fail("Существующий неподписанный сертификат требует отдельного проверенного плана; подпись разрешена только новому ACK-owned сертификату"); if (ca && row.ca !== ca) throw fail("Серверный сертификат подписан другим CA"); return row }
commands.push({ action: "create", path: "/certificate", fields: { name, ...fields } }, { action: "sign", path: "/certificate/sign", name, fields: { name, ...(ca ? { ca } : {}), "days-valid": fields["days-valid"] } })
return undefined
}
const ca = certificate(IPSEC_CA_CERT, { "common-name": "MikrotikManager IPsec CA", "key-size": "4096", "key-usage": "key-cert-sign,crl-sign", "days-valid": String(body.caDaysValid), comment: ipsecManagedComment("CA") })
if (!ca || observedBoolean(ca.trusted) !== true) commands.push({ action: "update", path: "/certificate", ...(ca ? { id: ca[".id"] } : { name: IPSEC_CA_CERT }), fields: { trusted: "yes" } })
certificate(IPSEC_SERVER_CERT, { "common-name": namesForCertificate.endpoint, "subject-alt-name": namesForCertificate.san, "key-size": "2048", "key-usage": "digital-signature,key-encipherment,tls-server", "days-valid": String(body.serverDaysValid), comment: ipsecManagedComment("server") }, IPSEC_CA_CERT)
const comment = ipsecManagedComment("IKEv2 road-warrior")
upsert("/ip/ipsec/profile", { name: IPSEC_COMMON_NAME, "hash-algorithm": "sha256", "enc-algorithm": "aes-256,aes-192,aes-128", "dh-group": "modp2048", "nat-traversal": "yes" })
upsert("/ip/ipsec/proposal", { name: IPSEC_COMMON_NAME, "auth-algorithms": "sha256", "enc-algorithms": "aes-256-cbc,aes-192-cbc,aes-128-cbc", "pfs-group": "modp2048", comment })
upsert("/ip/pool", { name: IPSEC_COMMON_NAME, ranges, comment })
upsert("/ip/ipsec/mode-config", { name: IPSEC_COMMON_NAME, "address-pool": IPSEC_COMMON_NAME, responder: "yes", ...(body.dns ? { "static-dns": body.dns } : {}) })
const group = named("/ip/ipsec/policy/group", IPSEC_POLICY_GROUP)
if (group) owned("/ip/ipsec/policy/group", group); else commands.push({ action: "create", path: "/ip/ipsec/policy/group", fields: { name: IPSEC_POLICY_GROUP } })
const templates = c["/ip/ipsec/policy"].filter(row => row.comment?.trim() === comment && observedBoolean(row.template) === true)
if (templates.length > 1) throw fail("Неоднозначный шаблон IPsec")
upsert("/ip/ipsec/policy", { "src-address": "0.0.0.0/0", "dst-address": body.poolCidr, proposal: IPSEC_COMMON_NAME, group: IPSEC_POLICY_GROUP, comment, ...(!templates.length ? { template: "yes" } : {}) }, templates[0])
upsert("/ip/ipsec/peer", { name: IPSEC_COMMON_NAME, address: "0.0.0.0/0", "exchange-mode": "ike2", passive: "yes", profile: IPSEC_COMMON_NAME, comment })
const names = [...new Set([...selectIke2Peers(c["/ip/ipsec/peer"]).map(row => row.name!), IPSEC_COMMON_NAME])]
const listener = selectSharedIke2Identity(c["/ip/ipsec/identity"], names) as Row | undefined
if (listener) { owned("/ip/ipsec/identity", listener); if (listener["policy-template-group"] !== IPSEC_POLICY_GROUP) commands.push({ action: "update", path: "/ip/ipsec/identity", id: listener[".id"], fields: { "policy-template-group": IPSEC_POLICY_GROUP } }) }
else commands.push({ action: "create", path: "/ip/ipsec/identity", fields: identityRosBody({ peerName: IPSEC_COMMON_NAME, modeConfig: IPSEC_COMMON_NAME, certificate: IPSEC_SERVER_CERT, comment: ipsecManagedComment("IKEv2 listener"), authMethod: "certificate", policyTemplateGroup: IPSEC_POLICY_GROUP }) })
for (const identity of c["/ip/ipsec/identity"]) if (identity !== listener && identity.peer === IPSEC_COMMON_NAME && isIpsecManagedComment(identity.comment) && (!identity["policy-template-group"] || identity["policy-template-group"] === "default")) { owned("/ip/ipsec/identity", identity); commands.push({ action: "update", path: "/ip/ipsec/identity", id: identity[".id"], fields: { "policy-template-group": IPSEC_POLICY_GROUP } }) }
if (body.createNatRule) {
const out = selectIpsecNatInterface(c["/ip/route"], c["/interface"]), natComment = ipsecManagedComment("интернет клиентам VPN")
const matches = c["/ip/firewall/nat"].filter(row => row.comment?.trim() === natComment && row.chain === "srcnat")
if (matches.length > 1) throw fail("Неоднозначное правило NAT IPsec")
upsert("/ip/firewall/nat", { chain: "srcnat", action: "masquerade", "src-address": body.poolCidr, "out-interface": out, "ipsec-policy": "out,none", comment: natComment }, matches[0])
}
// Every existing dependency of every command must resolve exactly. New names are
// permitted only if an earlier command creates them within this reviewed plan.
const created = new Set<string>()
for (const command of commands) {
for (const [field, path] of Object.entries(refs)) {
const value = command.fields[field]
if (!value || ["none", "auto", "ignore"].includes(value) || created.has(`${path}:${value}`)) continue
if (c[path].filter(row => row.name === value || row[".id"] === value).length !== 1) throw fail("Не подтверждена зависимость IPsec")
}
if (command.action === "create" && command.fields.name) created.add(`${command.path}:${command.fields.name}`)
}
return { commands, companions, target: { kind: "ipsec_server", id: String(server.id) } }
}
export function projectIpsecServerInit(state: IpsecServerInitState, command: IpsecServerInitCommand, options: { assignedId?: string; observedRow?: Row; ownedCertificateIds?: Set<string> } = {}) {
const next = structuredClone(state), rows = next.catalogs[command.action === "sign" ? "/certificate" : command.path]
if (!rows) throw fail("Неизвестный каталог IPsec", "STATE_UNAVAILABLE")
if (command.action === "update") {
const row = rows.find(item => command.id ? item[".id"] === command.id : item.name === command.name)
if (!row || (!command.id && !options.ownedCertificateIds?.has(row[".id"]))) throw fail("Не подтверждён объект изменения IPsec", "VERIFICATION_FAILED")
Object.assign(row, command.fields)
} else if (command.action === "sign") {
const row = rows.find(item => item.name === command.name), observed = options.observedRow
if (!row || !options.ownedCertificateIds?.has(row[".id"]) || !observed || observed[".id"] !== row[".id"] || !observed["invalid-after"]?.trim() || !observed.fingerprint?.trim()) throw fail("Не подтверждена подпись нового сертификата", "VERIFICATION_FAILED")
const generated = new Set(["ca", "ca-crl-host", "serial-number", "fingerprint", "invalid-before", "invalid-after", "expires-after", "akid", "skid", "issuer", "private-key", "issued", "status", "trusted"])
for (const key of new Set([...Object.keys(row), ...Object.keys(observed)])) if (!generated.has(key) && observed[key] !== row[key]) throw fail("При подписи изменены исходные поля сертификата", "VERIFICATION_FAILED")
if (command.fields.ca && observed.ca !== command.fields.ca) throw fail("CA подписи не подтверждён", "VERIFICATION_FAILED")
rows[rows.indexOf(row)] = structuredClone(observed)
} else {
const row = options.observedRow, id = options.assignedId
if (!row || !exactId(id) || row[".id"] !== id || rows.some(item => idKey(item[".id"]) === idKey(id)) || Object.values(row).some(value => typeof value !== "string")) throw fail("Не подтверждён ACK нового объекта", "VERIFICATION_FAILED")
for (const flag of ["dynamic", "builtin", "default"]) if (row[flag] !== undefined && observedBoolean(row[flag]) !== false) throw fail("Создан системный объект", "VERIFICATION_FAILED")
for (const [key, value] of Object.entries(command.fields)) if (row[key] !== value && !(["disabled", "responder", "template", "nat-traversal", "passive", "trusted"].includes(key) && observedBoolean(row[key]) !== null && observedBoolean(row[key]) === observedBoolean(value))) throw fail("Поля нового объекта не подтверждены", "VERIFICATION_FAILED")
rows.push(structuredClone(row))
}
return next
}