Files
MikrotikManager/backend/src/services/ipsec-existing-certificate-export-model.ts
T

113 lines
12 KiB
TypeScript

import { z } from "zod"
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 { IPSEC_COMMON_NAME, IPSEC_SERVER_CERT, parseIpsecUserComment, resolveIke2ServerCert, selectIke2Peers } from "./ipsec-config.js"
import { certificateRole } from "./certificate-parse.js"
import { resolveIpsecClientTarget, type IpsecServerState } from "./ipsec-live.js"
import { MAX_OWNED_FILE_BYTES } from "./mikrotik.js"
export const IPSEC_EXISTING_CERTIFICATE_EXPORT_OPERATION = "network.ipsec.existing-certificates.export"
/** Explicit existing client/server/other/CA export approval received.
* Every request still requires its own scoped intent and human authorization. */
export const IPSEC_EXISTING_CERTIFICATE_EXPORT_ACTIVATED = true
const selector = z.discriminatedUnion("kind", [z.object({ kind: z.literal("client"), clientId: z.string().min(1).max(256) }).strict(), z.object({ kind: z.literal("certificate"), name: z.string().min(1).max(256) }).strict()])
export const ipsecExistingCertificateExportRequestSchema = z.object({ serverId: z.number().int().positive().safe(), selector, privateKeyExport: z.literal(true), caPrivateKeyExport: z.boolean().default(false), passphrase: z.discriminatedUnion("kind", [z.object({ kind: z.literal("reference"), secretRef: z.string().uuid() }).strict(), z.object({ kind: z.literal("generate") }).strict()]) }).strict()
export type IpsecExistingCertificateExportRequest = z.infer<typeof ipsecExistingCertificateExportRequestSchema>
export const ipsecExistingCertificateExportSelectionSchema = ipsecExistingCertificateExportRequestSchema.omit({ passphrase: true }).strict()
export type IpsecExistingCertificateExportSelection = z.infer<typeof ipsecExistingCertificateExportSelectionSchema>
const digest = z.string().regex(/^[a-f0-9]{64}$/), uuid = z.string().uuid()
export const ipsecExistingCertificateExportAuthoritySchema = z.object({
principal: z.object({ connectionId: uuid, credentialId: uuid, credentialExpiresAt: z.string().datetime() }).strict(), ownerId: z.string().min(1), ownerProof: digest, policyProof: digest, generation: z.string().min(1),
request: ipsecExistingCertificateExportRequestSchema, receiptId: uuid, certificateId: z.string().regex(/^\*[a-z0-9]+$/i).max(100), certificateName: z.string().min(1).max(256), role: z.enum(["ca", "server", "client", "other"]),
sourceProof: digest, expectedProof: digest, referenceProof: digest, requestProof: digest, inputProof: digest, proofRevision: z.literal(1),
}).strict()
export type IpsecExistingCertificateExportAuthority = z.infer<typeof ipsecExistingCertificateExportAuthoritySchema>
export type IpsecExistingCertificateExportState = IpsecPeerDeleteState
type Row = Record<string, string>
export const ipsecExistingCertificateExportSecretPurpose = (serverId: number, target: IpsecExistingCertificateExportRequest["selector"]) => `ipsec-existing-export-passphrase:${serverId}:${target.kind}:${encodeURIComponent(target.kind === "client" ? target.clientId : target.name)}`
const fail = (message: string, code = "STATE_CONFLICT", status = code === "INVALID_INPUT" ? 400 : code === "STATE_UNAVAILABLE" || code === "VERIFICATION_FAILED" ? 502 : 409) => new McpError(code, message, status)
const idKey = (value: string) => value.toLowerCase().replace(/^\*0+(?=[a-z0-9])/, "*")
const nativeId = (value: unknown): value is string => typeof value === "string" && /^\*[a-z0-9]+$/i.test(value) && value.length <= 100
export function validateIpsecExistingCertificateExportState(state: IpsecExistingCertificateExportState) {
if (!state?.source || !Array.isArray(state.protections) || !state.catalogs || Buffer.byteLength(JSON.stringify(state)) > 1048576) throw fail("Неполное состояние экспорта IPsec", "STATE_UNAVAILABLE")
for (const path of [...ipsecPeerDeletePaths, "/file"]) {
const rows = state.catalogs[path]
if (!Array.isArray(rows) || rows.length > 2000 || rows.some(row => !row || !nativeId(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("Неоднозначные имена native объектов IPsec")
for (const row of rows) if (row.name && nativeId(row.name.trim()) && rows.some(other => other !== row && idKey(other[".id"]) === idKey(row.name.trim()))) throw fail("Неоднозначное имя/native ID экспорта")
}
}
export function planIpsecExistingCertificateExport(state: IpsecExistingCertificateExportState, server: ServerRow, raw: unknown, receiptId: string) {
const parsed = ipsecExistingCertificateExportRequestSchema.safeParse(raw)
if (!parsed.success) throw fail("Некорректный запрос приватного экспорта IPsec", "INVALID_INPUT")
const { passphrase: _passphrase, ...selection } = parsed.data
return { ...planIpsecExistingCertificateExportSelection(state, server, selection, receiptId), request: parsed.data }
}
/** Selection and state semantics are shared; material is bound independently by
* each trusted transport, so REST never pretends to own an MCP secret reference. */
export function planIpsecExistingCertificateExportSelection(state: IpsecExistingCertificateExportState, server: ServerRow, raw: unknown, receiptId: string) {
const parsed = ipsecExistingCertificateExportSelectionSchema.safeParse(raw)
if (!parsed.success || !z.string().uuid().safeParse(receiptId).success) throw fail("Некорректный запрос приватного экспорта IPsec", "INVALID_INPUT")
const request = parsed.data
if (request.serverId !== server.id) throw fail("Сервер экспорта не совпал", "INVALID_INPUT")
validateIpsecExistingCertificateExportState(state)
const c = state.catalogs
const live = { server, client: undefined, peers: c["/ip/ipsec/peer"], identities: c["/ip/ipsec/identity"], modeConfigs: c["/ip/ipsec/mode-config"], pools: c["/ip/pool"], policies: c["/ip/ipsec/policy"], nat: c["/ip/firewall/nat"], active: c["/ip/ipsec/active-peers"], certs: c["/certificate"] } as unknown as IpsecServerState
let cert: Row | undefined, userName: string, serverEndpoint: string
if (request.selector.kind === "client") {
const target = resolveIpsecClientTarget(live, request.selector.clientId)
if (target.ambiguous) throw fail("Неоднозначный ID клиента IPsec")
if (!target.identity) throw fail("Клиент IPsec не найден", "NOT_FOUND", 404)
const identity = target.identity, managedName = parseIpsecUserComment(identity.comment)
if (!managedName) throw fail("Не managed-клиент IPsec", "INVALID_INPUT")
const name = identity["remote-certificate"]?.trim()
if (!name || identity["auth-method"]?.trim().toLowerCase() === "pre-shared-key") throw fail("У клиента нет привязанного клиентского сертификата; используйте экспорт по имени")
cert = c["/certificate"].find(row => row.name === name)
userName = managedName
serverEndpoint = String(c["/certificate"].find(row => row.name === IPSEC_SERVER_CERT)?.["common-name"] ?? "").trim() || server.host
} else {
const name = request.selector.name
cert = c["/certificate"].find(row => row.name?.trim() === name)
userName = String(cert?.["common-name"] ?? "").trim() || name
serverEndpoint = String(resolveIke2ServerCert(live.certs, selectIke2Peers(live.peers))?.["common-name"] ?? "").trim() || server.host
}
if (!cert?.name || cert.name !== cert.name.trim()) throw fail("Сертификат экспорта не найден или имя неоднозначно", "NOT_FOUND", 404)
const role = certificateRole(cert, { peerCertNames: c["/ip/ipsec/peer"].map(row => row.certificate ?? ""), identityCertNames: c["/ip/ipsec/identity"].map(row => row["remote-certificate"] ?? "") })
// By-name REST currently permits all roles, including CA. Preserve that
// coverage explicitly; future approval must specifically include CA keys.
if (role === "ca" && !request.caPrivateKeyExport) throw fail("Экспорт CA может раскрыть закрытый ключ центра сертификации и требует отдельного явного caPrivateKeyExport", "APPROVAL_REQUIRED")
const exportPrefix = `mm-ipsec-existing-${receiptId}`, filename = `${exportPrefix}.p12`
if (c["/file"].some(row => row.name?.toLowerCase() === filename.toLowerCase())) throw fail("Receipt-owned имя экспорта уже занято; повтор запрещён")
const dns = c["/ip/ipsec/mode-config"].find(row => row.name?.trim() === IPSEC_COMMON_NAME)?.["static-dns"]?.trim() || undefined
const kinds: Record<string, string> = { "/certificate": "certificate", "/ip/ipsec/peer": "ipsec_peer", "/ip/ipsec/identity": "ipsec_identity", "/file": "router_file" }
return { request, certificateId: cert[".id"], certificateName: cert.name, role, userName, serverEndpoint, dns, exportPrefix, filename, commandCount: 2 as const, companions: Object.entries(c).flatMap(([path, rows]) => rows.map(row => ({ kind: kinds[path] ?? path, id: row[".id"] }))) }
}
/** Legacy REST trims a supplied passphrase and generates for whitespace or a
* too-short trimmed value (formerly after a rejected export). Decide once
* before dispatch; never repeat export with another passphrase. */
export function normalizeIpsecExistingExportPassphrase(raw: string | undefined, generate: () => string) {
if (raw !== undefined && (!z.string().min(8).max(16384).safeParse(raw).success)) throw fail("Некорректный секрет passphrase", "INVALID_INPUT")
const trimmed = raw?.trim()
const value = trimmed && trimmed.length >= 8 ? trimmed : generate()
if (!z.string().min(8).max(16384).safeParse(value).success || value !== value.trim()) throw fail("Не подтверждён пароль приватного экспорта", "INVALID_INPUT")
return value
}
export function projectIpsecExistingCertificateExport(state: IpsecExistingCertificateExportState, filename: string, after: IpsecExistingCertificateExportState) {
validateIpsecExistingCertificateExportState(after)
const old = state.catalogs["/file"], candidates = after.catalogs["/file"].filter(row => row.name === filename && !old.some(prior => idKey(prior[".id"]) === idKey(row[".id"])))
if (candidates.length !== 1) throw fail("Не подтверждён единственный receipt-owned файл экспорта", "VERIFICATION_FAILED")
const row = candidates[0], size = Number(row.size)
if (!Number.isSafeInteger(size) || size <= 0 || size > MAX_OWNED_FILE_BYTES) throw fail("Размер приватного файла вне предела точного /file/get (61438 байт)", "VERIFICATION_FAILED")
const projected = structuredClone(state)
projected.catalogs["/file"].push(structuredClone(row))
return { projected, file: { id: row[".id"], name: filename, size } }
}
export function projectIpsecExistingCertificateCleanup(state: IpsecExistingCertificateExportState, file: { id: string; name: string; size: number }) {
const projected = structuredClone(state), rows = projected.catalogs["/file"], matches = rows.filter(row => row[".id"] === file.id || row.name === file.name)
if (matches.length !== 1 || matches[0][".id"] !== file.id || matches[0].name !== file.name || Number(matches[0].size) !== file.size) throw fail("Ownership временного файла изменился; удаление запрещено", "VERIFICATION_FAILED")
rows.splice(rows.indexOf(matches[0]), 1)
return projected
}