Files
MikrotikManager/backend/src/services/ipsec-certificate-delete.ts
T

73 lines
8.4 KiB
TypeScript

import { z } from "zod"
import { ipsecCertDeleteRequestSchema } from "@mmapp/contracts/ipsec"
import { getServerRowById, type ServerRow } from "../modules/servers/repository/servers-repository.js"
import { McpError } from "../modules/mcp/security.js"
import { readIpsecPeerDeleteState, ipsecPeerDeleteProof, type IpsecPeerDeleteState } from "./ipsec-peer-delete.js"
import { identityDisplayName } from "./ipsec-config.js"
import { observedBoolean } from "./ospf-observed-values.js"
import { maskNetworkSecrets, networkSecretValues } from "./network-observed-read.js"
import { MikrotikClient } from "./mikrotik.js"
import { sameWireguardEndpoint } from "./wireguard-source.js"
import { withApplicationMutationLock, withConfigMutationLock } from "./config-mutation-lock.js"
import { executeGuardedApplicationWrite } from "./config-mutation-policy.js"
import { captureAndAppendRevision } from "./config-revisions.js"
import { captureIpsecSnapshot } from "./ipsec-live.js"
export const ipsecCertificateDeleteSchema = ipsecCertDeleteRequestSchema.extend({ serverId: z.number().int().positive().safe(), force: z.boolean().default(false) }).strict()
export const readIpsecCertificateDeleteState = readIpsecPeerDeleteState
const fail = (code: string, message: string, status = ["MUTATION_OUTCOME_UNKNOWN", "VERIFICATION_FAILED", "STATE_UNAVAILABLE"].includes(code) ? 502 : 409) => new McpError(code, message, status)
export class IpsecCertificateUsedConflict extends McpError {
constructor(public readonly usedBy: string[], name: string) { super("DEPENDENCY_CONFLICT", `Сертификат «${name}» используется: ${usedBy.join(", ")}.`, 409) }
}
export function ipsecCertificateDeleteTarget(state: IpsecPeerDeleteState, name: string, force = false) {
ipsecCertDeleteRequestSchema.parse({ name })
const certs = state.catalogs["/certificate"], matches = certs.filter(row => String(row.name ?? "").trim() === name)
if (!matches.length) throw fail("NOT_FOUND", `Сертификат ${name} не найден`, 404)
if (matches.length !== 1) throw fail("STATE_CONFLICT", "Неоднозначное имя сертификата")
const cert = matches[0]
if (!/^\*[a-z0-9]+$/i.test(cert[".id"]) || cert[".id"].length > 100) throw fail("STATE_UNAVAILABLE", "Не подтверждён точный native ID сертификата")
for (const flag of ["dynamic", "builtin", "default"]) if (cert[flag] !== undefined && observedBoolean(cert[flag]) !== false) throw fail("PROTECTED_OBJECT", "Системный или неподтверждённый сертификат нельзя удалить")
if (certs.some(row => (row.ca ?? "").trim() === name)) throw fail("DEPENDENCY_CONFLICT", "CA содержит выданные сертификаты. Его удаление затронет всю цепочку; отдельное удаление CA здесь недоступно")
const issuerName = (cert.ca ?? "").trim(), issuers = issuerName ? certs.filter(row => (row.name ?? "").trim() === issuerName) : []
if (issuers.length > 1) throw fail("STATE_CONFLICT", "Неоднозначное имя CA-издателя сертификата")
const issuer = issuers[0]
const revoked = cert.revoked && !["false", "no", "0"].includes(cert.revoked)
if (observedBoolean(issuer?.crl) === true && (observedBoolean(cert.issued) !== false || revoked)) throw fail("DEPENDENCY_CONFLICT", "Сертификат выдан CA с CRL и не удаляется отдельно в RouterOS. Удалите только identity, сохранив сертификат. Отзыв выполняется отдельно")
const secrets = networkSecretValues(Object.values(state.catalogs).flat())
const usedBy = maskNetworkSecrets([
...state.catalogs["/ip/ipsec/peer"].filter(row => (row.certificate ?? "").trim() === name).map(row => `peer ${(row.name ?? "").trim()}`),
...state.catalogs["/ip/ipsec/identity"].filter(row => (row.certificate ?? "").trim() === name || (row["remote-certificate"] ?? "").trim() === name).map(row => `identity ${identityDisplayName(row, certs)}`),
], secrets)
if (usedBy.length && !force) throw new IpsecCertificateUsedConflict(usedBy, maskNetworkSecrets(name, secrets))
return { cert, usedBy }
}
export function projectIpsecCertificateDelete(state: IpsecPeerDeleteState, certificateId: string) {
const next = structuredClone(state)
if (!next.catalogs["/certificate"].some(row => row[".id"] === certificateId)) throw fail("STATE_CONFLICT", "Native сертификат не найден")
next.catalogs["/certificate"] = next.catalogs["/certificate"].filter(row => row[".id"] !== certificateId)
return next
}
export async function deleteIpsecCertificateGuarded(server: ServerRow, name: string, force = false, expectedProof?: string, authorize: () => Promise<unknown> = async () => {}, options: { recordRevision?: typeof captureAndAppendRevision; receiptId?: string; checkpoint?: (value: { certificateId: string; commandCount: number; completedCommands: number; afterProof: string }) => Promise<void> } = {}) {
ipsecCertDeleteRequestSchema.parse({ name })
return withApplicationMutationLock(() => withConfigMutationLock([server.id], () => executeGuardedApplicationWrite({ kind: "certificate", id: name }, [server.id], async () => {
const before = await readIpsecCertificateDeleteState(server, authorize)
if (expectedProof && before.proof !== expectedProof) throw fail("STATE_CONFLICT", "Сертификат, источник или зависимости изменились после подготовки")
const { cert } = ipsecCertificateDeleteTarget(before, name, force), certificateId = cert[".id"], desired = await ipsecPeerDeleteProof(projectIpsecCertificateDelete(before, certificateId))
let dispatched = false
try { await MikrotikClient.fromServer(server).delete("/certificate/" + encodeURIComponent(certificateId), 10000, async () => {
const fresh = await readIpsecCertificateDeleteState(server, authorize)
if (fresh.proof !== before.proof || ipsecCertificateDeleteTarget(fresh, name, force).cert[".id"] !== certificateId) throw fail("STATE_CONFLICT", "Сертификат изменился после durable intent; DELETE не отправлен")
await authorize(); dispatched = true
}) } catch (error) { if (!dispatched && error instanceof McpError) throw error; throw fail("MUTATION_OUTCOME_UNKNOWN", "Исход удаления сертификата не подтверждён; повтор запрещён, требуется сверка") }
let after: IpsecPeerDeleteState
try { after = await readIpsecCertificateDeleteState(server, authorize) } catch { throw fail("MUTATION_OUTCOME_UNKNOWN", "DELETE отправлен, но read-back сертификатов недоступен; повтор запрещён") }
if (after.proof !== desired) throw fail("VERIFICATION_FAILED", "Удаление сертификата или сохранность остальной конфигурации не подтверждены; повтор запрещён")
try { await authorize(); await options.checkpoint?.({ certificateId, commandCount: 1, completedCommands: 1, afterProof: after.proof }) } catch { throw fail("MUTATION_OUTCOME_UNKNOWN", "Удаление сертификата проверено, но checkpoint не сохранён; повтор запрещён") }
const historySource = async () => { await authorize(); const fresh = await getServerRowById(server.id); if (!fresh || !sameWireguardEndpoint(fresh, server)) throw fail("STATE_CONFLICT", "Источник истории IPsec изменился") }
const reader = { get: async (path: string) => { await historySource(); if (!Object.hasOwn(after.catalogs, path)) throw fail("STATE_UNAVAILABLE", "Неизвестный каталог истории IPsec"); return structuredClone(after.catalogs[path]) } } as unknown as MikrotikClient
let historyRecorded = false
try { await historySource(); historyRecorded = await (options.recordRevision ?? captureAndAppendRevision)({ serverId: server.id, section: "ipsec", source: "apply", capture: () => captureIpsecSnapshot(server, reader) }) !== null } catch { /* A history failure must never replay DELETE. */ }
return { ok: true, verified: true, name, certificateId, force, receiptId: options.receiptId ?? null, commandCount: 1, completedCommands: 1, afterProof: after.proof, historyRecorded, revisionRecorded: historyRecorded, state: "applied", automaticReplay: false, forwardingVerified: false }
})))
}