SPB Git

Repository Public

stalwart.ts 8.7 KB 147 lines typescript

1// Client de gestion Stalwart (JMAP, capacité urn:stalwart:jmap) et coffre des secrets de boîtes.2import crypto from "node:crypto"3import { config } from "./config.js"4import { bad } from "./util.js"56function key(): Buffer {7  const k = Buffer.from(config.masterKey, "base64")8  if (k.length !== 32) throw new Error("SPMAIL_MASTER_KEY must be 32 bytes, base64-encoded")9  return k10}11export function seal(plain: string): Buffer {12  const iv = crypto.randomBytes(12)13  const c = crypto.createCipheriv("aes-256-gcm", key(), iv)14  const body = Buffer.concat([c.update(plain, "utf8"), c.final()])15  return Buffer.concat([Buffer.from([1]), iv, c.getAuthTag(), body])16}17export function unseal(blob: Buffer): string {18  if (blob[0] !== 1) throw new Error("unknown secret format")19  const d = crypto.createDecipheriv("aes-256-gcm", key(), blob.subarray(1, 13))20  d.setAuthTag(blob.subarray(13, 29))21  return Buffer.concat([d.update(blob.subarray(29)), d.final()]).toString("utf8")22}2324export const basic = (user: string, password: string) => "Basic " + Buffer.from(`${user}:${password}`).toString("base64")25const adminAuth = () => basic(config.stalwartAdminUser, config.stalwartAdminPassword)2627type Call = [string, Record<string, unknown>, string]28export async function adminCall(calls: Call[]): Promise<Call[]> {29  const r = await fetch(`${config.stalwartUrl}/jmap/`, {30    method: "POST",31    headers: { authorization: adminAuth(), "content-type": "application/json" },32    body: JSON.stringify({ using: ["urn:ietf:params:jmap:core", "urn:stalwart:jmap"], methodCalls: calls }),33    signal: AbortSignal.timeout(6_000),34  }).catch(() => { throw bad("mail_server_unavailable", 502, "The mail server is unreachable") })35  if (!r.ok) throw bad("mail_server_unavailable", 502, `Stalwart management API answered ${r.status}`)36  const j = (await r.json()) as { methodResponses: Call[] }37  for (const [name, res] of j.methodResponses) if (name === "error") throw bad("mail_server_error", 502, String(res.type ?? "error"))38  return j.methodResponses39}4041export async function getAll(type: string, properties?: string[]): Promise<Record<string, any>[]> {42  const r = await adminCall([[`x:${type}/query`, { limit: 500 }, "q"], [`x:${type}/get`, { "#ids": { resultOf: "q", name: `x:${type}/query`, path: "/ids" }, ...(properties ? { properties } : {}) }, "g"]])43  return (r[1][1].list as Record<string, any>[]) ?? []44}4546export async function listDomains() {47  const r = await adminCall([["x:Domain/get", { ids: null, properties: ["name", "enable", "description"] }, "d"]])48  return r[0][1].list as { id: string; name: string; enable: boolean }[]49}5051/** Crée un compte Stalwart avec un mot de passe aléatoire (jamais montré à personne) et rend son identifiant. */52export async function createAccount(address: string, description: string): Promise<{ id: string; secret: string }> {53  const [local, domain] = address.toLowerCase().split("@")54  const dom = (await listDomains()).find((d) => d.name === domain)55  if (!dom) throw bad("unknown_domain", 400, `Domain ${domain} is not hosted here`)56  const existing = await getAll("Account", ["emailAddress", "aliases", "name"])57  if (existing.some((a) => a.emailAddress === address.toLowerCase())) throw bad("address_taken", 409)58  const secret = crypto.randomBytes(30).toString("base64url")59  const r = await adminCall([["x:Account/set", { create: { n: { "@type": "User", name: local, domainId: dom.id, description, credentials: { "0": { "@type": "Password", secret } } } } }, "c"]])60  const created = (r[0][1].created as Record<string, { id: string }> | undefined)?.n61  if (!created) throw bad("mail_server_error", 502, JSON.stringify(r[0][1].notCreated ?? {}).slice(0, 300))62  return { id: created.id, secret }63}6465/** Remplace le mot de passe d'un compte existant (rotation ou adoption d'un compte créé hors SP Mail). */66export async function rotateSecret(stalwartId: string): Promise<string> {67  const secret = crypto.randomBytes(30).toString("base64url")68  const r = await adminCall([["x:Account/set", { update: { [stalwartId]: { credentials: { "0": { "@type": "Password", secret } } } } }, "u"]])69  if (!(r[0][1].updated && stalwartId in (r[0][1].updated as object))) throw bad("mail_server_error", 502, JSON.stringify(r[0][1].notUpdated ?? {}).slice(0, 300))70  return secret71}7273export async function destroyAccount(stalwartId: string) {74  await adminCall([["x:Account/set", { destroy: [stalwartId] }, "d"]])75}7677export async function setAliases(stalwartId: string, aliases: string[]) {78  const doms = await listDomains()79  const value: Record<string, unknown> = {}80  aliases.forEach((a, i) => {81    const [local, domain] = a.toLowerCase().split("@")82    const dom = doms.find((d) => d.name === domain)83    if (!dom) throw bad("unknown_domain", 400, `Domain ${domain} is not hosted here`)84    value[String(i)] = { name: local, domainId: dom.id }85  })86  const r = await adminCall([["x:Account/set", { update: { [stalwartId]: { aliases: value } } }, "u"]])87  if (!(r[0][1].updated && stalwartId in (r[0][1].updated as object))) throw bad("mail_server_error", 502, JSON.stringify(r[0][1].notUpdated ?? {}).slice(0, 300))88}8990// ------------------------------------------------------------------ extensions pour /api/v1 (adresses, quotas, listes)91const setOk = (r: Call[], kind: "created" | "updated" | "destroyed", id: string) => {92  const v = r[0][1][kind] as Record<string, unknown> | string[] | undefined93  return Array.isArray(v) ? v.includes(id) : !!v && id in v94}95const setErr = (r: Call[]) => JSON.stringify(r[0][1].notCreated ?? r[0][1].notUpdated ?? r[0][1].notDestroyed ?? {}).slice(0, 300)9697let domainCache: { at: number; list: { id: string; name: string; enable: boolean }[] } | undefined98/** Domaines hébergés (cache 60 s). */99export async function hostedDomains(fresh = false) {100  if (!fresh && domainCache && Date.now() - domainCache.at < 60_000) return domainCache.list101  domainCache = { at: Date.now(), list: await listDomains() }102  return domainCache.list103}104export async function domainIdOf(address: string): Promise<string> {105  const domain = address.split("@")[1]106  const dom = (await hostedDomains()).find((d) => d.name === domain) ?? (await hostedDomains(true)).find((d) => d.name === domain)107  if (!dom) throw bad("unknown_domain", 400, `Domain ${domain} is not hosted here`)108  return dom.id109}110export async function domainNameById(id: string): Promise<string | undefined> {111  return ((await hostedDomains()).find((d) => d.id === id) ?? (await hostedDomains(true)).find((d) => d.id === id))?.name112}113114export type StalwartAlias = { name: string; domainId: string; enable?: boolean; description?: string | null }115export type StalwartAccount = {116  id: string; name: string; emailAddress: string; aliases: Record<string, StalwartAlias>; quotas: Record<string, number>117  permissions: { "@type": string; enabledPermissions?: Record<string, boolean>; disabledPermissions?: Record<string, boolean> }; usedDiskQuota?: number118}119export async function getAccount(stalwartId: string): Promise<StalwartAccount | null> {120  const r = await adminCall([["x:Account/get", { ids: [stalwartId], properties: ["name", "emailAddress", "aliases", "quotas", "permissions", "usedDiskQuota"] }, "g"]])121  return ((r[0][1].list as StalwartAccount[]) ?? [])[0] ?? null122}123export async function updateAccount(stalwartId: string, patch: Record<string, unknown>) {124  const r = await adminCall([["x:Account/set", { update: { [stalwartId]: patch } }, "u"]])125  if (!setOk(r, "updated", stalwartId)) throw bad("mail_server_error", 502, setErr(r))126}127128// Listes de diffusion Stalwart : un alias à plusieurs destinations locales.129export type StalwartList = { id: string; name: string; domainId: string; emailAddress: string; recipients: Record<string, boolean> }130export async function getList(id: string): Promise<StalwartList | null> {131  const r = await adminCall([["x:MailingList/get", { ids: [id] }, "g"]])132  return ((r[0][1].list as StalwartList[]) ?? [])[0] ?? null133}134export async function createList(address: string, recipients: string[]): Promise<string> {135  const r = await adminCall([["x:MailingList/set", { create: { n: { name: address.split("@")[0], domainId: await domainIdOf(address), recipients: Object.fromEntries(recipients.map((a) => [a, true])) } } }, "c"]])136  const id = (r[0][1].created as Record<string, { id: string }> | undefined)?.n?.id137  if (!id) throw bad("mail_server_error", 502, setErr(r))138  return id139}140export async function updateList(id: string, recipients: string[]) {141  const r = await adminCall([["x:MailingList/set", { update: { [id]: { recipients: Object.fromEntries(recipients.map((a) => [a, true])) } } }, "u"]])142  if (!setOk(r, "updated", id)) throw bad("mail_server_error", 502, setErr(r))143}144export async function destroyList(id: string) {145  await adminCall([["x:MailingList/set", { destroy: [id] }, "d"]])146}147
Files main
Menu

Theme