Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- systeme:omnimail:entwurf-v2-1 [03/11/2026 23:58] – [Vorwort] Holger Wehrs
+++ systeme:omnimail:entwurf-v2-1 [04/11/2026 00:30] (aktuell) – OmniMail Teil 4: Benutzertext, ohne Diagramm; OmniBackup™ Holger Wehrs
@@ Zeile 1: / Zeile 1: @@
 ====== OmniMail™ · Dokumentationsentwurf V2.1 ======
-**Stand:** 2026-11-03. **Geltung:** ausschließlich OmniMail für ''omnisrv.de'' auf OMNISRV. Diese eigenständige Entwurfsseite ergänzt [[systeme:omnimail:start|die technische V1-Systemübersicht]] und verändert sie nicht.
+**Stand:** 2026-11-04. **Geltung:** ausschließlich OmniMail für ''omnisrv.de'' auf OMNISRV. Diese eigenständige Entwurfsseite ergänzt [[systeme:omnimail:start|die technische V1-Systemübersicht]] und verändert sie nicht.
 {{ :systeme:omnimail:omnimail-titelbild.png?1100 |OmniMail – Die Mailstraße für omnisrv.de}}
@@ Zeile 376: / Zeile 376: @@
 <WRAP tip round 80% justify>
-===== DNS und Zertifikats-Kurier =====
+===== Zwei getrennte DNS-Wege =====
-Alois verwendet für seine DNS-Abfragen den externen BIND-Dienst; Hildegard nutzt den internen BIND-Dienst. Der Zertifikats-Kurier übernimmt geprüfte Zertifikatspakete aus der Caddy-Welt in geschützte Zielverzeichnisse. Kontrollierte Watcher laden die Zertifikate bei den Maildiensten nach. Private Schlüssel gehören weder in das Wiki noch in Git.
+Alois verwendet für DNS-Abfragen den externen BIND-Dienst; Hildegard nutzt den internen BIND-Dienst. So fragt jeder Postdienst nur die für ihn vorgesehene Namenssicht ab.
+</WRAP>
+----
+====== Teil 3 · Der Zertifikats-Kurier ======
+<WRAP tip round 80% justify>
+===== Warum braucht OmniMail einen Kurier? =====
+Caddy beschafft und verwaltet die TLS-Zertifikate. Die Maildienste sollen dafür weder Caddys gesamtes Zertifikatslager sehen noch untereinander Schlüssel austauschen. Ein lokaler Selektor legt nur die Pakete für ausdrücklich zugelassene Namen in ein geschütztes Eingangsfach. Von dort verteilt der Zertifikats-Kurier die geprüften Pakete an getrennte Zielfächer. Der Kurier selbst hat keine Netzwerkverbindung.
 </WRAP>
@@ Zeile 438: / Zeile 447: @@
 ---
 flowchart LR
-  Q["ext-qipu"] -->|"<span class="edge-row"><span class="spacer">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="pill">&nbsp;DNS&nbsp;</span><span class="spacer">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span>"| E["ext-bind-public"]
+  C["Caddy<br/>ACME-Zertifikate"] --> X["exakter<br/>Selektor"]
-  H["int-mailgateway"] -->|"<span class="edge-row"><span class="spacer">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="pill">&nbsp;DNS&nbsp;</span><span class="spacer">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span>"| I["int-bind-internal"]
+  X --> I["geschütztes<br/>Eingangsfach"]
-  C["Caddy-Zertifikatsspeicher"] --> K["Zertifikats-Kurier"]
+  I --> K["Zertifikats-Kurier<br/>ohne Netz"]
-  K --> T["geschuetzte Zertifikatsziele"]
+  K --> Z["versionierte<br/>Zielfächer"]
-  T --> W["kontrollierter Reload"]
+  Z --> W["lokaler Wächter<br/>und TLS-Reload"]
-  W --> S["Stalwart / Postfix"]
 </mermaid>
 <WRAP info round 80% justify>
-===== Monitoring und Backup =====
+===== Was prüft und verteilt er? =====
-Ein Host-Monitor prüft die Mailstraße und löst bei relevanten Zustandswechseln Alarm aus. Der Alarmdienst nutzt authentifizierte Stalwart-Submission. Borg archiviert die vorgesehenen Daten- und Konfigurationsquellen; ein isolierter Restore wurde geprüft. Eine SMTP-Annahme bestätigt nur die Übergabe an den nächsten Dienst, nicht den tatsächlichen Eingang in einem externen Postfach.
+  - **Eingang:** Der Kurier liest das geschützte Eingangsfach, aber nicht Caddys vollständigen ACME-Speicher.
+  - **Prüfung:** Er kontrolliert, ob Zertifikat und privater Schlüssel zusammenpassen, die Zertifikatskette gültig ist, der Name im SAN steht, noch genügend Gültigkeit bleibt und das Ziel in seiner festen Liste freigeschaltet ist.
+  - **Übergabe:** Erst danach veröffentlicht er ein vollständiges, versioniertes Paket. Der Wechsel auf die neue Version erfolgt atomar; die bisherige funktionsfähige Version bleibt für eine Rücknahme erhalten.
+  - **Aktivierung:** Jeder Dienst sieht nur sein eigenes Zielfach schreibgeschützt. Ein lokaler Wächter bemerkt den Wechsel, lädt das Zertifikat beim Dienst nach und vergleicht anschließend den TLS-Fingerabdruck.
 </WRAP>
-<mermaid>
+<WRAP tip round 80% justify>
-raw
+===== Wer bekommt ein Zertifikat? =====
----
+^ Ziel ^ Wofür? ^ Wie wird es aktiv? ^
-config:
+| Stalwart | IMAPS, Submission und die interne HTTPS-Verwaltung | Stalwarts lokaler TLS-Reload |
-  theme: base
+| Alois | STARTTLS am SMTP-Eingang | lokaler Postfix-Reload |
-  themeVariables:
+| Privater Konfigurationsdienst | HTTPS für AutoConfig und AutoDiscover | kontrollierter Reload des internen Webdienstes |
-    background: "#ffffff"
+</WRAP>
-    primaryColor: "#f3f3f3"
-    primaryTextColor: "#414141"
+<WRAP important round 80% justify>
-    primaryBorderColor: "#d8d8d8"
+===== Wenn etwas schiefgeht =====
-    lineColor: "#969696"
+Ein unvollständiges oder unpassendes Paket wird nicht veröffentlicht. Schlägt das Nachladen fehl, versucht der jeweilige Wächter die vorherige gültige Version wiederherzustellen. Der vorhandene Fünf-Minuten-Zyklus prüft neue Pakete und überspringt unveränderte Versionen. Private Schlüssel gehören ausschließlich in die geschützten Fächer, nicht in diese Seite, ins Git-Repository oder in Protokolle.
-    edgeLabelBackground: "transparent"
+</WRAP>
-    fontFamily: "Roboto,Ubuntu,Aptos,Arial,sans-serif"
-    fontSize: "16px"
-  flowchart:
-    nodeSpacing: 36
-    rankSpacing: 48
-    padding: 18
-  themeCSS: |
-    .node rect {
-      fill: #f3f3f3 !important;
-      stroke: #d8d8d8 !important;
-      stroke-width: 1.1px !important;
-      rx: 24px;
-      ry: 24px;
-    }
-    .node.decision rect {
-      fill: #fafafa !important;
-      stroke-dasharray: 4 4;
-    }
-    .flowchart-link {
-      stroke: #969696 !important;
-      stroke-width: 1.2px !important;
-    }
-    .cluster rect {
-      fill: #fcfcfc !important;
-      stroke: #dedede !important;
-      rx: 20px;
-      ry: 20px;
-    }
-    .nodeLabel p { padding: 10px 0 !important; }
-    .edgeLabel { font-size: 10px !important; }
-    .edgeLabel .labelBkg {
-      background: transparent !important;
-      padding: 0 !important;
-      border: 0 !important;
-    }
-    .edgeLabel .pill {
-      background: #eaf4fb;
-      border-radius: 8px;
-      box-shadow: inset 0 0 0 1px #b8ccdc;
-      display: inline-block;
-      padding: 1px 4px;
-    }
-    .edgeLabel .spacer { visibility: hidden; }
-    .edgeLabel .edge-row { display: inline-flex; align-items: center; }
----
-flowchart LR
-  M["OmniMail-Monitor"] --> A["Alarmdienst"]
-  A -->|"<span class="edge-row"><span class="spacer">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><span class="pill">&nbsp;authentifizierte Submission&nbsp;</span><span class="spacer">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></span>"| S["Stalwart"]
-  D["Mail- und Konfigurationsdaten"] --> B["Borg-Archiv"]
-  B --> R["isolierter Restore-Test"]
-</mermaid>
 ----
-====== Teil 3 · Technische Referenz ======
+====== Teil 4 · Monitoring und Backup ======
+<WRAP info round 80% justify>
+===== Wenn die Mailstraße Hilfe braucht =====
+Ein Host-Monitor prüft die beteiligten Dienste und meldet relevante Zustandswechsel per Info-Mail an das hinterlegte Administrator-Konto. Der Alarmdienst versendet seine Nachricht über Stalwart.
+</WRAP>
+<WRAP tip round 80% justify>
+===== Sicherung und Wiederherstellung =====
+Die Mail- und Konfigurationsdateien werden über das in einem separaten Artikel beschriebene OmniBackup™ in regelmäßigem Rhythmus archiviert. Die Sicherung erfolgt derzeit stündlich in mehrere verschlüsselte Borg-Repositories.
+</WRAP>
+----
+====== Teil 5 · Technische Referenz ======
 <WRAP info round 80% justify>
@@ Zeile 559: / Zeile 533: @@
 Bei Zustellproblemen zuerst Monitorstatus, Postfix-Queues, Stalwart-Health und DNS-Antworten aus den jeweils berechtigten Netzen prüfen. Zertifikatswechsel über den vorhandenen Kurier/Watcher und dessen Fingerprint-Readback bewerten. Die isolierte Borg-Recovery aus M01-DEPLOY-015C-B ist ein Teilnachweis, keine vollständige Ersatzhost-Abnahme. Änderungen an laufenden Maildiensten, DNS, Firewall oder Backup sind nicht Teil dieses Wiki-Entwurfs.
 </WRAP>
-===== VOE und Quellenstand =====
-Die VOE (**V**ereinigung der **O**mniMail-**E**lektriker) verlangt für jede produktive Leitung eine geprüfte Nummer und Verbindungsmatrix. Für die obigen Mailkanten ist keine vollständige autoritative OM-LINK-Liste belegt; deshalb tragen die neuen Diagramme keine erfundenen Leitungsnummern. Verifiziert ist der gesonderte Vertrag ''OM-LINK-ETPW-001'' für die technische QaD-Maestro-Alarmierung, der hier keine zusätzliche allgemeine Mailroute begründet.
-Quellstand: Live-Docker-Inspect und Listener-Readback vom 03.11.2026; M01-DEPLOY-010, 012D, 014 und 015C-B; OmniMail-ROM ''PANTHEON-GRUNDORDNUNG.md''; [[systeme:omnimail:start|V1-Systemübersicht]]; [[https://prv-forgejo.omnisrv.de/hwehrs/omnimail/src/branch/feature/m00-gazette-implementation-20261103/70-PRODUKTIONSQUELLEN/SOURCE-MANIFEST.md|geprüftes Quellmanifest]]. Offen bleiben die vollständige dynamische Konfigurationsabbildung, lückenlose VOE-Leitungsnummern und die visuelle Browserabnahme durch den Benutzer.
 ----