SPB Git

Repository Public

api.test.ts 12.0 KB 203 lines typescript

1import assert from "node:assert/strict"2import crypto from "node:crypto"3import { after, before, test } from "node:test"4import { ApiError, Client, ORIGIN, cli, startServer, stopServer, tokenOf, until } from "../harness"56const run = crypto.randomBytes(3).toString("hex")7const A = `it-a-${run}@stg.spboucher.ai`8const B = `it-b-${run}@stg.spboucher.ai`9const admin = new Client("web")10const member = new Client("web")11let mbA = "", mbB = "", acctA = "", acctB = ""1213async function rejects(p: Promise<unknown>, status: number, code?: string) {14  await assert.rejects(p, (e: unknown) => e instanceof ApiError && e.status === status && (!code || e.code === code))15}16async function boxes(c: Client, mb: string, acct: string) {17  const r = await c.jmap(mb, [["Mailbox/get", { accountId: acct, properties: ["role", "name"] }, "m"]])18  return Object.fromEntries(r[0][1].list.map((m: any) => [m.role ?? m.name, m.id])) as Record<string, string>19}2021before(startServer)22after(async () => {23  // Les boîtes d'essai et leur courrier sont supprimés du serveur de courrier.24  for (const id of [mbA, mbB]) if (id) await admin.call("DELETE", `/api/admin/mailboxes/${id}?purge=delete-all-mail`).catch(() => {})25  await stopServer()26})2728test("premier administrateur : lien à usage unique, puis refusé", async () => {29  const token = tokenOf(await cli("bootstrap"))30  assert.equal((await admin.call("POST", "/api/enroll/check", { token })).purpose, "bootstrap")31  await admin.enroll(token, "owner", "Propriétaire")32  const me = await admin.call("GET", "/api/me")33  assert.equal(me.user.role, "admin")34  await rejects(new Client().enroll(token, "intrus", "Intrus"), 403, "invalid_token")35  await assert.rejects(cli("bootstrap"))36})3738test("sans session : 401 ; requête intersite : 403", async () => {39  await rejects(new Client().call("GET", "/api/me"), 401)40  const r = await fetch(`${ORIGIN}/api/logout`, { method: "POST", headers: { origin: "https://evil.example", cookie: admin.cookie, "x-spmail": "1" } })41  assert.equal(r.status, 403)42  const r2 = await fetch(`${ORIGIN}/api/logout`, { method: "POST", headers: { origin: ORIGIN, cookie: admin.cookie } }) // sans l'en-tête dédiée43  assert.equal(r2.status, 403)44})4546test("invitation d'un membre, boîtes créées sur le vrai serveur de courrier", async () => {47  await member.enroll(tokenOf(await cli("invite")), "membre", "Membre")48  const users = await admin.call("GET", "/api/admin/users")49  const m = users.find((u: any) => u.handle === "membre")50  mbA = (await admin.call("POST", "/api/admin/mailboxes", { address: A, display_name: "Essai A" })).id51  mbB = (await admin.call("POST", "/api/admin/mailboxes", { address: B, display_name: "Essai B", user_id: m.id })).id52  await rejects(admin.call("POST", "/api/admin/mailboxes", { address: A }), 409, "address_taken")53  await rejects(admin.call("POST", "/api/admin/mailboxes", { address: `x@not-hosted-${run}.example` }), 400, "unknown_domain")54  await rejects(member.call("GET", "/api/admin/overview"), 403)55  await rejects(member.call("POST", "/api/admin/mailboxes", { address: `z-${run}@stg.spboucher.ai` }), 403)56})5758test("session JMAP réécrite : aucune URL ni capacité interne ne fuit", async () => {59  const s = await admin.call("GET", `/api/jmap/${mbA}/session`)60  acctA = s.primaryAccounts["urn:ietf:params:jmap:mail"]61  acctB = (await member.call("GET", `/api/jmap/${mbB}/session`)).primaryAccounts["urn:ietf:params:jmap:mail"]62  assert.equal(s.username, A)63  for (const k of ["apiUrl", "uploadUrl", "downloadUrl", "eventSourceUrl"]) assert.ok(String(s[k]).startsWith(`${ORIGIN}/api/jmap/${mbA}/`), k)64  assert.ok(!JSON.stringify(s).includes("10.67.0.1") && !JSON.stringify(s).includes("18080"))65  assert.ok(!("urn:stalwart:jmap" in s.capabilities))66})6768test("cloisonnement : la boîte d'un autre est introuvable, la gestion du serveur est interdite", async () => {69  await rejects(member.call("GET", `/api/jmap/${mbA}/session`), 404)70  await rejects(member.jmap(mbA, [["Mailbox/get", { accountId: acctA }, "m"]]), 404)71  await rejects(admin.jmap(mbA, [["x:Account/get", { ids: null }, "a"]], ["urn:ietf:params:jmap:core", "urn:stalwart:jmap"]), 403, "forbidden_capability")72  await rejects(admin.jmap(mbA, [["x:Account/get", { ids: null }, "a"]]), 403, "forbidden_method")73  // même avec le bon identifiant de compte Stalwart, la boîte B refuse les données du compte A74  const r = await member.jmap(mbB, [["Email/query", { accountId: acctA }, "q"]])75  assert.equal(r[0][0], "error")76})7778test("envoi réel A → B avec pièce jointe et Unicode, réception, fil, téléchargement", async () => {79  const bx = await boxes(admin, mbA, acctA)80  const payload = crypto.randomBytes(40_000)81  const up = await admin.raw("POST", `/api/jmap/${mbA}/upload/${acctA}/`, new Uint8Array(payload), { "content-type": "application/pdf" })82  assert.equal(up.status, 200)83  const blob = (await up.json()) as { blobId: string; size: number }84  assert.equal(blob.size, payload.length)85  // un fichier texte ou JSON est téléversé comme des octets, jamais interprété par le serveur86  for (const type of ["text/plain", "application/json"]) {87    const r2 = await admin.raw("POST", `/api/jmap/${mbA}/upload/${acctA}/`, new Uint8Array(Buffer.from('{"a":1}')), { "content-type": type })88    assert.equal(r2.status, 200, type)89    assert.equal(((await r2.json()) as { size: number }).size, 7)90  }91  let idents = (await admin.jmap(mbA, [["Identity/get", { accountId: acctA }, "i"]]))[0][1].list92  if (!idents.length) {93    const c = await admin.jmap(mbA, [["Identity/set", { accountId: acctA, create: { n: { name: "Essai A", email: A } } }, "c"]])94    idents = [{ id: c[0][1].created.n.id }]95  }96  const subject = `Recette ${run} — été, naïve, 日本語, 📎`97  const r = await admin.jmap(mbA, [98    ["Email/set", { accountId: acctA, create: { e: {99      mailboxIds: { [bx.drafts]: true }, keywords: { $draft: true }, from: [{ name: "Essai A", email: A }], to: [{ name: "Essai B", email: B }], subject,100      bodyValues: { t: { value: "Bonjour — ça marche ? €" }, h: { value: "<p>Bonjour — <b>ça marche</b> ? €</p><script>alert(1)</script>" } },101      textBody: [{ partId: "t", type: "text/plain" }], htmlBody: [{ partId: "h", type: "text/html" }],102      attachments: [{ blobId: blob.blobId, type: "application/pdf", name: "pièce jointe.pdf", disposition: "attachment" }] } } }, "e"],103    ["EmailSubmission/set", { accountId: acctA, create: { s: { identityId: idents[0].id, emailId: "#e" } },104      onSuccessUpdateEmail: { "#s": { [`mailboxIds/${bx.drafts}`]: null, [`mailboxIds/${bx.sent}`]: true, "keywords/$draft": null } } }, "s"]])105  assert.ok(r[0][1].created?.e, JSON.stringify(r[0][1]))106  assert.ok(r[1][1].created?.s, JSON.stringify(r[1][1]))107108  const bxB = await boxes(member, mbB, acctB)109  const got = await until(async () => {110    const q = await member.jmap(mbB, [111      ["Email/query", { accountId: acctB, filter: { inMailbox: bxB.inbox } }, "q"],112      ["Email/get", { accountId: acctB, "#ids": { resultOf: "q", name: "Email/query", path: "/ids" }, properties: ["subject", "from", "attachments", "threadId", "bodyValues", "textBody"], fetchTextBodyValues: true }, "g"]])113    return q[1][1].list.find((m: any) => m.subject === subject)114  }, "message reçu dans la boîte B")115  assert.equal(got.from[0].email, A)116  assert.equal(got.attachments[0].name, "pièce jointe.pdf")117  assert.match(Object.values<any>(got.bodyValues)[0].value, /ça marche \? €/)118  // (la vérification DKIM/SPF/DMARC porte sur les envois externes réels : docs/test-report.md)119  const att = got.attachments[0]120  const dl = await member.raw("GET", `/api/jmap/${mbB}/download/${acctB}/${att.blobId}/${encodeURIComponent(att.name)}?accept=application%2Fpdf`)121  assert.equal(dl.status, 200)122  assert.match(dl.headers.get("content-disposition")!, /^attachment/)123  assert.match(dl.headers.get("content-security-policy")!, /sandbox/)124  assert.ok(Buffer.from(await dl.arrayBuffer()).equals(payload))125  // la pièce jointe de B n'est pas téléchargeable par la session de A126  assert.notEqual((await admin.raw("GET", `/api/jmap/${mbB}/download/${acctB}/${att.blobId}/x?accept=application%2Fpdf`)).status, 200)127128  // le message est dans « Envoyés » chez A, plus dans les brouillons129  const sent = await admin.jmap(mbA, [["Email/query", { accountId: acctA, filter: { inMailbox: bx.sent } }, "q"], ["Email/query", { accountId: acctA, filter: { inMailbox: bx.drafts } }, "d"]])130  assert.equal(sent[0][1].ids.length, 1)131  assert.equal(sent[1][1].ids.length, 0)132})133134test("flux d'événements : un changement d'état arrive sans contenu de message", async () => {135  const ctrl = new AbortController()136  const r = await fetch(`${ORIGIN}/api/jmap/${mbB}/eventsource?types=*&closeafter=no&ping=10`, { headers: { cookie: member.cookie }, signal: ctrl.signal })137  assert.equal(r.status, 200)138  assert.match(r.headers.get("content-type")!, /text\/event-stream/)139  const reader = r.body!.getReader()140  const bxB = await boxes(member, mbB, acctB)141  await member.jmap(mbB, [["Mailbox/set", { accountId: acctB, create: { n: { name: `Dossier ${run}`, parentId: null } } }, "c"]])142  let text = ""143  const t0 = Date.now()144  const deadline = Date.now() + 15000145  while (Date.now() < deadline && !/event: state/.test(text)) {146    const { value, done } = await reader.read()147    if (done) break148    text += Buffer.from(value).toString()149  }150  ctrl.abort()151  console.log(`    événement reçu en ${Date.now() - t0} ms`)152  assert.match(text, /event: state/)153  assert.ok(!text.includes("Recette"), "aucun sujet ni corps dans le flux")154  assert.ok(bxB.inbox)155})156157test("app native : même identité, jeton propre à l'appareil, révocation à distance", async () => {158  const phone = new Client("native")159  await phone.login(admin) // même clé d'accès (passkey synchronisée), session distincte160  assert.ok(phone.bearer.length > 30)161  assert.equal((await phone.call("GET", "/api/me")).session.kind, "native")162  assert.equal((await phone.jmap(mbA, [["Mailbox/get", { accountId: acctA, properties: ["role"] }, "m"]]))[0][0], "Mailbox/get")163  // un jeton natif ne vaut pas cookie, et inversement164  assert.equal((await fetch(`${ORIGIN}/api/me`, { headers: { cookie: `spmail_session=${phone.bearer}` } })).status, 401)165  const sessions = await admin.call("GET", "/api/sessions")166  const s = sessions.find((x: any) => x.kind === "native")167  assert.ok(s && !s.current)168  await admin.call("DELETE", `/api/sessions/${s.id}`)169  await rejects(phone.call("GET", "/api/me"), 401)170})171172test("mandataire d'images : destinations internes refusées (SSRF)", async () => {173  for (const u of ["http://127.0.0.1:18080/jmap/session", "http://10.67.0.1:8080/", "http://169.254.169.254/latest/meta-data/", "http://[::1]/", "file:///etc/passwd", "http://localhost/", "https://user:pw@example.org/a.png"]) {174    const r = await admin.raw("GET", `/api/img?u=${encodeURIComponent(u)}`)175    assert.ok([400, 403].includes(r.status), `${u} → ${r.status}`)176  }177  assert.equal((await fetch(`${ORIGIN}/api/img?u=${encodeURIComponent("https://example.org/a.png")}`)).status, 401)178})179180test("récupération : nouveau lien, anciennes sessions révoquées", async () => {181  const fresh = new Client("web")182  await fresh.enroll(tokenOf(await cli("recover", "membre")))183  await rejects(member.call("GET", "/api/me"), 401)184  assert.equal((await fresh.call("GET", "/api/me")).user.handle, "membre")185  assert.equal((await fresh.call("GET", "/api/passkeys")).length, 2)186  await fresh.call("POST", "/api/logout")187  await rejects(fresh.call("GET", "/api/me"), 401)188})189190test("administration : vue d'ensemble et DNS lus en direct", async () => {191  const o = await admin.call("GET", "/api/admin/overview")192  assert.equal(o.server.reachable, true)193  assert.ok(o.domains.some((d: any) => d.name === "stg.spboucher.ai"))194  assert.ok(o.accounts.some((a: any) => a.address === A))195  const dns = await admin.call("GET", "/api/admin/dns")196  const stg = dns.find((d: any) => d.domain === "stg.spboucher.ai")197  assert.equal(stg.mx.ok, true)198  assert.equal(stg.dkim.ok, true)199  assert.equal(stg.mxHost.ok, true)200  const log = await admin.call("GET", "/api/admin/audit")201  assert.ok(log.some((l: any) => l.action === "mailbox.create"))202})203
Files main
Menu

Theme