chore(backend): добавить поддержку ACME и управление сертификатами

This commit is contained in:
Denozordec
2026-05-12 20:00:25 +07:00
parent bfceb07a23
commit d62d212c86
21 changed files with 2183 additions and 301 deletions
+183
View File
@@ -0,0 +1,183 @@
import { createHash } from "node:crypto"
import * as acme from "acme-client"
import type { Server } from "../db/schema.js"
import {
getAcmeAccountPrivateKey,
getAcmeCloudflareToken,
getAcmeSettingsPublic,
saveAcmeAccountPrivateKey,
} from "./certificates-service.js"
import { MikrotikClient } from "./mikrotik.js"
type CfResponse<T> = { success: boolean; errors?: Array<{ message?: string }>; result?: T }
async function cloudflareRequest<T>(
token: string,
path: string,
init?: RequestInit,
): Promise<T> {
const headers: Record<string, string> = {
Authorization: `Bearer ${token}`,
"Content-Type": "application/json",
}
const res = await fetch(`https://api.cloudflare.com/client/v4${path}`, {
...init,
headers,
})
const json = (await res.json()) as CfResponse<T>
if (!res.ok || !json.success) {
const msg = json.errors?.map((e) => e.message).filter(Boolean).join("; ")
|| `Cloudflare API HTTP ${res.status}`
throw new Error(msg)
}
return json.result as T
}
export async function testCloudflareToken(token: string): Promise<void> {
await cloudflareRequest<Array<{ id: string; name: string }>>(token, "/zones?per_page=1")
}
async function resolveZoneId(token: string, domain: string, defaultZoneId?: string): Promise<string> {
if (defaultZoneId?.trim()) return defaultZoneId.trim()
const labels = domain.split(".").filter(Boolean)
for (let i = 0; i < labels.length - 1; i++) {
const guess = labels.slice(i).join(".")
const zones = await cloudflareRequest<Array<{ id: string; name: string }>>(
token,
`/zones?name=${encodeURIComponent(guess)}`,
)
if (zones[0]?.id) return zones[0].id
}
throw new Error(`Не удалось определить зону Cloudflare для ${domain}`)
}
async function createTxtRecord(
token: string,
zoneId: string,
recordName: string,
value: string,
): Promise<string> {
const created = await cloudflareRequest<{ id: string }>(token, `/zones/${zoneId}/dns_records`, {
method: "POST",
body: JSON.stringify({
type: "TXT",
name: recordName,
content: value,
ttl: 120,
}),
})
return created.id
}
async function deleteTxtRecord(token: string, zoneId: string, recordId: string): Promise<void> {
await cloudflareRequest(token, `/zones/${zoneId}/dns_records/${recordId}`, { method: "DELETE" })
}
function dns01Digest(keyAuthorization: string): string {
return createHash("sha256").update(keyAuthorization).digest("base64url")
}
async function sleep(ms: number) {
await new Promise((resolve) => setTimeout(resolve, ms))
}
async function getOrCreateAccountKey(): Promise<Buffer> {
const existing = getAcmeAccountPrivateKey()
if (existing) return Buffer.from(existing)
const key = await acme.crypto.createPrivateKey()
saveAcmeAccountPrivateKey(key.toString("utf8"))
return key
}
export async function issueCertificateWithCloudflareDns(params: {
server: Server
certName: string
domainNames: string[]
keyType: "rsa2048" | "ec256"
trustStore: string[]
onStep?: (step: string) => void
}): Promise<void> {
const settings = getAcmeSettingsPublic()
const token = getAcmeCloudflareToken()
if (!token) throw new Error("Не настроен Cloudflare API token")
const domains = [...new Set(params.domainNames.map((d) => d.trim().toLowerCase()).filter(Boolean))]
if (domains.length === 0) throw new Error("Нужен хотя бы один домен")
params.onStep?.("acme_order")
const accountKey = await getOrCreateAccountKey()
const client = new acme.Client({
directoryUrl: settings.directoryUrl,
accountKey,
})
const altNames = domains.slice(1)
const privateKey = params.keyType === "ec256"
? await acme.crypto.createPrivateEcdsaKey("P-256")
: await acme.crypto.createPrivateKey(2048)
const [, csr] = await acme.crypto.createCsr({ commonName: domains[0], altNames }, privateKey)
const order = await client.createOrder({
identifiers: domains.map((value) => ({ type: "dns", value })),
})
const authorizations = await client.getAuthorizations(order)
const txtCleanups: Array<{ zoneId: string; recordId: string }> = []
try {
params.onStep?.("dns_challenge")
for (const authz of authorizations) {
const challenge = authz.challenges.find((c) => c.type === "dns-01")
if (!challenge) throw new Error(`Нет DNS-01 challenge для ${authz.identifier.value}`)
const keyAuthorization = await client.getChallengeKeyAuthorization(challenge)
const digest = dns01Digest(keyAuthorization)
const zoneId = await resolveZoneId(token, authz.identifier.value, settings.defaultZoneId)
const recordName = `_acme-challenge.${authz.identifier.value}`
const recordId = await createTxtRecord(token, zoneId, recordName, digest)
txtCleanups.push({ zoneId, recordId })
}
await sleep(15_000)
for (const authz of authorizations) {
const challenge = authz.challenges.find((c) => c.type === "dns-01")
if (!challenge) continue
await client.verifyChallenge(authz, challenge)
await client.completeChallenge(challenge)
await client.waitForValidStatus(authz)
}
params.onStep?.("finalize")
const finalized = await client.finalizeOrder(order, csr)
const certPem = await client.getCertificate(finalized)
params.onStep?.("import")
const clientRos = MikrotikClient.fromServer(params.server)
const safeBase = params.certName.replace(/[^a-zA-Z0-9._-]+/g, "_")
const certFile = `${safeBase}.crt`
const keyFile = `${safeBase}.key`
await clientRos.uploadTextFile(certFile, certPem)
await clientRos.uploadTextFile(keyFile, privateKey.toString("utf8"))
await clientRos.importCertificate({
fileName: certFile,
name: params.certName,
trusted: true,
trustStore: params.trustStore.join(","),
})
await clientRos.importCertificate({
fileName: keyFile,
name: params.certName,
trusted: true,
trustStore: params.trustStore.join(","),
})
} finally {
params.onStep?.("cleanup")
for (const item of txtCleanups) {
try {
await deleteTxtRecord(token, item.zoneId, item.recordId)
} catch {
/* ignore cleanup errors */
}
}
}
}
+97
View File
@@ -0,0 +1,97 @@
import type { CertificateDto } from "@mmapp/contracts/certificates"
export type RosCertificateRow = Record<string, string | undefined>
function parseRosDate(raw: string | undefined): Date | null {
if (!raw?.trim()) return null
const d = new Date(raw)
return Number.isNaN(d.getTime()) ? null : d
}
function fmtDate(d: Date): string {
return d.toISOString().slice(0, 10)
}
function parseSans(raw: string | undefined): string[] {
if (!raw?.trim()) return []
return raw
.split(",")
.map((part) => part.trim())
.map((part) => {
const m = part.match(/^(?:DNS|IP|email):(.+)$/i)
return (m?.[1] ?? part).trim()
})
.filter(Boolean)
}
function parseUsage(raw: string | undefined): CertificateDto["usage"] {
if (!raw?.trim()) return []
const out = new Set<CertificateDto["usage"][number]>()
for (const part of raw.split(",")) {
const token = part.trim().toLowerCase()
if (token === "tls-server") out.add("server")
else if (token === "tls-client") out.add("client")
else if (token === "key-cert-sign") out.add("ca")
else if (token === "crl-sign") out.add("crl-sign")
}
return [...out]
}
function parseFlags(raw: string | undefined): { revoked: boolean; expired: boolean } {
const flags = (raw ?? "").toUpperCase()
return {
revoked: flags.includes("R"),
expired: flags.includes("E"),
}
}
export function mapRosCertificateRow(
serverId: number,
serverName: string,
row: RosCertificateRow,
): CertificateDto | null {
const name = (row.name ?? "").trim()
if (!name) return null
const { revoked, expired: expiredFlag } = parseFlags(row.flags)
const validFrom = parseRosDate(row["invalid-before"])
const validUntil = parseRosDate(row["invalid-after"])
const now = new Date()
const daysLeft = validUntil
? Math.ceil((validUntil.getTime() - now.getTime()) / 86_400_000)
: 0
let status: CertificateDto["status"] = "valid"
if (revoked) status = "revoked"
else if (expiredFlag || (validUntil != null && validUntil.getTime() < now.getTime())) status = "expired"
const keySize = Number.parseInt(String(row["key-size"] ?? "0"), 10)
return {
id: `${serverId}:${name}`,
name,
serverId: String(serverId),
serverName,
commonName: (row["common-name"] ?? name).trim(),
sans: parseSans(row["subject-alt-name"]),
issuedBy: (row.issuer ?? "—").trim() || "—",
validFrom: validFrom ? fmtDate(validFrom) : "—",
validUntil: validUntil ? fmtDate(validUntil) : "—",
daysLeft,
keySize: Number.isFinite(keySize) ? keySize : 0,
usage: parseUsage(row["key-usage"]),
trusted: row.trusted === "true",
status,
acmeStatus: row["acme-status"]?.trim() || undefined,
}
}
export function mapRosCertificates(
serverId: number,
serverName: string,
rows: RosCertificateRow[],
): CertificateDto[] {
return rows
.map((row) => mapRosCertificateRow(serverId, serverName, row))
.filter((row): row is CertificateDto => row != null)
}
@@ -0,0 +1,170 @@
import { eq } from "drizzle-orm"
import type { CertificateDto } from "@mmapp/contracts/certificates"
import { db } from "../db/index.js"
import { acmeSettings, certificateIssueJobs, servers } from "../db/schema.js"
import { mapRosCertificates } from "./certificate-parse.js"
import { MikrotikClient } from "./mikrotik.js"
const SETTINGS_ID = 1
export async function listCertificatesFromServers(): Promise<{
certificates: CertificateDto[]
failures: Array<{ serverId: string; serverName?: string; error: string }>
}> {
const allServers = db.select().from(servers).where(eq(servers.enabled, true)).all()
const certificates: CertificateDto[] = []
const failures: Array<{ serverId: string; serverName?: string; error: string }> = []
await Promise.all(
allServers.map(async (server) => {
try {
const client = MikrotikClient.fromServer(server)
const rows = await client.getCertificates()
certificates.push(...mapRosCertificates(server.id, server.name, rows))
} catch (e) {
failures.push({
serverId: String(server.id),
serverName: server.name,
error: e instanceof Error ? e.message : String(e),
})
}
}),
)
certificates.sort((a, b) => {
if (a.serverId !== b.serverId) return a.serverId.localeCompare(b.serverId)
return a.name.localeCompare(b.name, "ru")
})
return { certificates, failures }
}
export function getAcmeSettingsPublic() {
const row = db.select().from(acmeSettings).where(eq(acmeSettings.id, SETTINGS_ID)).limit(1).all()[0]
if (!row) {
return {
directoryUrl: "https://acme-v02.api.letsencrypt.org/directory",
defaultZoneId: "",
tokenConfigured: false,
updatedAt: undefined as string | undefined,
}
}
return {
directoryUrl: row.directoryUrl,
defaultZoneId: row.defaultZoneId || undefined,
tokenConfigured: Boolean(row.cloudflareApiToken?.trim()),
updatedAt: row.updatedAt,
}
}
export function getAcmeCloudflareToken(): string {
const row = db.select().from(acmeSettings).where(eq(acmeSettings.id, SETTINGS_ID)).limit(1).all()[0]
return row?.cloudflareApiToken?.trim() ?? ""
}
export function getAcmeAccountPrivateKey(): string {
const row = db.select().from(acmeSettings).where(eq(acmeSettings.id, SETTINGS_ID)).limit(1).all()[0]
return row?.accountPrivateKey?.trim() ?? ""
}
export function saveAcmeAccountPrivateKey(pem: string) {
const now = new Date().toISOString()
db.update(acmeSettings)
.set({ accountPrivateKey: pem, updatedAt: now })
.where(eq(acmeSettings.id, SETTINGS_ID))
.run()
}
export function updateAcmeSettings(input: {
directoryUrl?: string
defaultZoneId?: string | null
cloudflareApiToken?: string | null
}) {
const row = db.select().from(acmeSettings).where(eq(acmeSettings.id, SETTINGS_ID)).limit(1).all()[0]
const now = new Date().toISOString()
const next = {
directoryUrl: input.directoryUrl?.trim() || row?.directoryUrl || "https://acme-v02.api.letsencrypt.org/directory",
defaultZoneId:
input.defaultZoneId === null
? ""
: input.defaultZoneId?.trim() ?? row?.defaultZoneId ?? "",
cloudflareApiToken:
input.cloudflareApiToken === null
? ""
: input.cloudflareApiToken?.trim() ?? row?.cloudflareApiToken ?? "",
updatedAt: now,
}
if (row) {
db.update(acmeSettings).set(next).where(eq(acmeSettings.id, SETTINGS_ID)).run()
} else {
db.insert(acmeSettings).values({ id: SETTINGS_ID, accountPrivateKey: "", ...next }).run()
}
return getAcmeSettingsPublic()
}
export function createIssueJobRecord(input: {
id: string
serverId: string
certName: string
domainNames: string[]
keyType: string
trustStore: string
}) {
const now = new Date().toISOString()
db.insert(certificateIssueJobs).values({
id: input.id,
status: "queued",
step: "queued",
serverId: input.serverId,
certName: input.certName,
domainNames: JSON.stringify(input.domainNames),
keyType: input.keyType,
trustStore: input.trustStore,
requestedAt: now,
}).run()
}
export function updateIssueJobRecord(
id: string,
patch: Partial<{
status: "queued" | "running" | "done" | "failed"
step: string
startedAt: string
finishedAt: string
error: string | null
}>,
) {
db.update(certificateIssueJobs).set(patch).where(eq(certificateIssueJobs.id, id)).run()
}
export function getIssueJobRecord(id: string) {
return db.select().from(certificateIssueJobs).where(eq(certificateIssueJobs.id, id)).limit(1).all()[0] ?? null
}
export function toIssueJobDto(row: NonNullable<ReturnType<typeof getIssueJobRecord>>) {
let domainNames: string[] = []
try {
const parsed = JSON.parse(row.domainNames) as unknown
if (Array.isArray(parsed)) domainNames = parsed.map(String)
} catch {
domainNames = []
}
return {
id: row.id,
status: row.status,
step: row.step as "queued" | "acme_order" | "dns_challenge" | "finalize" | "import" | "cleanup" | "done",
serverId: row.serverId,
certName: row.certName,
domainNames,
requestedAt: row.requestedAt,
startedAt: row.startedAt ?? undefined,
finishedAt: row.finishedAt ?? undefined,
error: row.error ?? undefined,
}
}
export function getServerRowByIdString(serverId: string) {
const id = Number.parseInt(serverId, 10)
if (!Number.isFinite(id)) return null
return db.select().from(servers).where(eq(servers.id, id)).limit(1).all()[0] ?? null
}
+27
View File
@@ -431,6 +431,33 @@ export class MikrotikClient {
return this.post<Array<Record<string, string>>>("/tool/bandwidth-test", body, 30_000)
}
async getCertificates(): Promise<Array<Record<string, string | undefined>>> {
const raw = await this.get<unknown>("/certificate")
if (!Array.isArray(raw)) return []
return raw.filter((row): row is Record<string, string | undefined> => row != null && typeof row === "object")
}
async uploadTextFile(fileName: string, contents: string, timeoutMs = 30_000): Promise<void> {
await this.post("/file", { name: fileName, contents }, timeoutMs)
}
async importCertificate(params: {
fileName: string
name: string
trusted?: boolean
trustStore?: string
passphrase?: string
}): Promise<unknown> {
const body: Record<string, string> = {
"file-name": params.fileName,
name: params.name,
trusted: params.trusted === false ? "no" : "yes",
}
if (params.trustStore?.trim()) body["trust-store"] = params.trustStore.trim()
if (params.passphrase?.trim()) body.passphrase = params.passphrase.trim()
return this.post("/certificate/import", body, 60_000)
}
async exportConfigScript(): Promise<string> {
const raw = await this.post<unknown>("/console/export", {}, 30_000)