SPB Git

Repository Public

architecture.md 4.2 KB

# SP Mail — architecture

État : 2026-11-18. Tout ce qui est décrit ici est déployé, sauf mention « prévu ».

flowchart LR
  subgraph Internet
    MTA[Serveurs de courrier tiers]
    U[Navigateur · app macOS · app iOS]
    APNS[(APNs Apple — prévu)]
  end
  subgraph BHS64["BHS64 — OVH Beauharnois, 51.161.112.61"]
    direction TB
    S25["Stalwart 1.1.1<br/>SMTP :25 (public)"]
    SJ["Stalwart JMAP + gestion<br/>10.67.0.1:8080 et 127.0.0.1:8080 (privé)"]
    DB[("RocksDB /var/lib/stalwart<br/>boîtes, index, file d'attente")]
    AV["ClamAV milter 127.0.0.1:7357"]
    C["Caddy :443<br/>mail.spboucher.ai · mx1 (certificat)"]
    BK["Sauvegarde chiffrée 03:20<br/>/var/backups/sp-mail"]
  end
  subgraph MacLustr["MacLustr — M4M64c (LAN, WireGuard 10.67.0.33)"]
    API["Backend SP Mail :8730<br/>passkeys · sessions · passerelle JMAP · admin"]
    PG[("PostgreSQL sp_mail<br/>identités, secrets de boîtes scellés")]
    BK2["Copie des sauvegardes 03:50<br/>~/backups/sp-mail"]
  end
  MTA <-- "SMTP + STARTTLS" --> S25
  S25 --- DB
  SJ --- DB
  S25 -- scan --> AV
  U -- "HTTPS" --> C
  C -- "WireGuard" --> API
  API -- "JMAP (WireGuard, secret par boîte)" --> SJ
  API --- PG
  BK -- "clé SSH à commande forcée" --> BK2
  API -. "métadonnées minimales" .-> APNS

# Composants et frontières de confiance

Zone Contenu Exposition
Bordure publique (BHS64) Stalwart : réception/envoi SMTP direct, DKIM, SPF/DMARC/iprev entrants, antispam, file d'attente, stockage des boîtes (décision D1 du propriétaire) ; ClamAV ; Caddy 25/tcp (SMTP), 443/tcp (Caddy). Rien d'autre du courrier : pas d'IMAP, pas de submission, pas de console d'administration publics
Gestion du serveur de courrier API JMAP + gestion de Stalwart (:8080, HTTP clair) loopback et interface WireGuard seulement ; ufw n'accepte que 10.67.0.33 (backend)
Backend (M4M64c) identité (passkeys WebAuthn), sessions par appareil, passerelle JMAP, API d'administration, mandataire d'images derrière Caddy (mail.spboucher.ai), joint par WireGuard
Clients web (React/TS), macOS et iOS (SwiftUI, socle SPMailCore) parlent JMAP standard au backend, jamais à Stalwart

Pourquoi une passerelle plutôt que Stalwart exposé directement : une seule surface d'authentification (passkeys), des sessions révocables par appareil, aucun mot de passe de boîte dans un client, et la console de gestion du serveur de courrier hors d'Internet. Chaque boîte a dans Stalwart un mot de passe aléatoire que personne ne connaît ; le backend le garde scellé (AES-256-GCM, clé maîtresse hors base) et l'ajoute aux requêtes relayées. La passerelle refuse la capacité urn:stalwart:jmap et toute méthode x:*.

# Flux

  • Réception : MTA tiers → mx1.spboucher.ai:25 (STARTTLS, certificat Let's Encrypt obtenu par Caddy et recopié vers Stalwart par sp-mail-cert.path) → vérifications SPF/DKIM/DMARC/iprev → ClamAV (refus 550 si infecté, 4xx si l'antivirus est en panne) → antispam (score ≥ 5 → dossier Indésirables, jamais de suppression silencieuse) → boîte.
  • Envoi : client → EmailSubmission/set (passerelle) → file Stalwart → signature DKIM (ed25519 + RSA-2048) → livraison directe au MX du destinataire, IPv4 seulement (ufw reject out du port 25 en IPv6, faute de PTR IPv6). Aucun relais tiers.
  • Lecture : client → https://mail.spboucher.ai/api/jmap/{boîte}/… → backend → Stalwart par WireGuard.
  • Temps réel : EventSource JMAP relayé (états seulement). Push iOS (APNs) : prévu, métadonnées minimales.

# Choix écartés

Écarté Raison
Boîtes stockées sur MacLustr, BHS64 simple relais deux Stalwart à maintenir ; lecture dépendante du réseau résidentiel (IP changée le 2026-09-28, coupures). Réversible : export/import Stalwart
IMAP / submission publics inutiles aux trois clients SP Mail ; surface d'attaque et mots de passe d'application en plus. Ouvrables plus tard
ACME intégré de Stalwart Caddy possède déjà 80/443 sur BHS64
IPv6 pour SMTP pas de PTR IPv6 ; Gmail rejette sans PTR
IA dans le chemin de livraison l'IA (phase G) est un service séparé, optionnel, jamais requis
Files main
Menu

Theme