CODLAB / Blog · Software & Entwicklung

Ausführbare Protokollverträge, AES-256-GCM-Synchronisation und Mutationstests zwischen macOS und Linux in CardinalHost

15 Nov 2026 CODLAB Team 9 min

Stand November 2026: CardinalHost (aktuell vor dem Marktstart auf cardinalhost.org dokumentiert) entwickelt native Clients für macOS (Swift/SwiftUI) und Linux (GTK 4/libadwaita) entlang gemeinsamer Protokollverträge (cardinal-contracts 1.0.0). Sechs deklarative Spezifikationen, 278 Prüfvektoren in 13 Abschnitten und 53 dokumentierte Quellmutationen machen Abweichungen reproduzierbar sichtbar (aktuell 245 bestandene Prüfungen, 33 offene Fehler, 11 dokumentierte Diskrepanzen), ergänzt um AES-256-GCM-Konfigurationsschutz und im LAN erprobte ChaCha20-Poly1305-Kanäle.

Warum native Systemwerkzeuge über Betriebssystemgrenzen hinweg auf Protokolldrift achten müssen

Wer heute eine plattformübergreifende Anwendung für Serververwaltung, Dateitransfer und Fernwartung entwirft, bündelt häufig eine eingebettete Browser-Laufzeit wie Electron, um nur eine Oberfläche zu pflegen. Innerhalb der Cardinal-Familie — neben CardinalMail und CardinalOS — haben wir uns bewusst gegen einen eingebetteten Webbrowser entschieden: Ohne vergleichende Speicher- oder Latenz-Benchmarks gegen Drittwerkzeuge zu behaupten, erlaubt uns der native Aufbau, auf jedem Zielsystem unmittelbar die vorgesehenen Betriebssystem- und Sicherheits-APIs zu nutzen.

Native Implementierungen in zwei unterschiedlichen Ökosystemen erzeugen jedoch eine anspruchsvolle ingenieurwissenschaftliche Herausforderung: Wenn ein macOS-Client in Swift mit einem Linux-Client oder Linux-Agenten in Python und GTK 4 kommuniziert, genügt eine winzige Abweichung bei Byte-Reihenfolgen, Koordinatenrundungen auf HiDPI-Monitoren, Nonce-Längen oder Ablaufzeiten von Zustimmungstokens, um subtile Fehler oder Sicherheitslücken auszulösen. Prosadokumentation in Wikis veraltet erfahrungsgemäß schon nach wenigen Wochen. Unsere Antwort in CardinalHost im Forschungsbereich unserer Projektübersicht lautet deshalb: Protokollspezifikationen müssen maschinenlesbar, per Manifest versiegelt und schrittweise gegen reale Module prüfbar sein — samt transparenter Ausweisung noch offener Lücken.

Zwei native Clients, eine gemeinsame Sicherheitsdisziplin

Bevor zwei Systeme Daten austauschen, nutzt jeder Client die Sicherheitsmechanismen seiner Plattform direkt, statt eigene Behelfslösungen zu erfinden:

  • macOS-Client (Swift & SwiftUI): Nutzt Apples CryptoKit für kryptografische Operationen und speichert Zugangsdaten in der System-Keychain. Neben entfernter Bildschirmarbeit integriert die Anwendung Dateisystem-Mounts für SFTP, SMB, NFS und WebDAV, zweistufige Server-zu-Server-Übertragungen per rsync über einen isolierten temporären Puffer sowie eine im Code und in automatisierten Tests geschlossene 2 / 4 / 8-Live-Konsole (Felderprobung laufend).
  • Linux-Client (GTK 4 & libadwaita): Fügt sich nativ in moderne GNOME-Arbeitsumgebungen ein, speichert Geheimnisse im GNOME Keyring über libsecret und bindet entfernte Dateisysteme über GVfs und sshfs an. Gehärtete lokale Speicher-, Index- und Papierkorb-Routinen arbeiten über geöffnete Verzeichnis-Deskriptoren (dir_fd) mit dem Flag O_NOFOLLOW, um Symlink-Verwechslungen (TOCTOU) an diesen Pfaden abzuwehren.
  • Signierte Update-Manifeste und redigierte Opt-in-Telemetrie: Unter Linux entnimmt der Update-Prüfer aus der äußeren JSON-Hülle (maximal 256 KiB) zunächst den signierten Rohtext und verifiziert dessen Ed25519-Signatur, bevor das innere Release-JSON geparst oder Versionsnummern und Download-Pfade ausgewertet werden. Eine optionale Absturz-Telemetrie ist standardmäßig deaktiviert (Opt-in), schwärzt Pfade sowie Benutzernamen vorab und wird in der Testsuite gegen einen lokalen Mock-Empfänger verifiziert.

Deskriptor-gesicherte lokale Pfade und ehrliches Server-zu-Server-Staging

Zwei konkrete Dateipfade zeigen, wie CardinalHost lokale Schutzmechanismen und transparente Grenzen kombiniert. Wenn lokale Verwaltungsroutinen unter Linux Verzeichnisse verarbeiten, in denen sich symbolische Verknüpfungen ändern könnten, entsteht bei reinen String-Pfadprüfungen ein bekanntes Zeitfenster für Time-of-Check-to-Time-of-Use-Effekte (TOCTOU): Zwischen Prüfung und Öffnen könnte ein Eintrag gegen einen Symlink auf ~/.ssh oder lokale Konfigurationsdateien getauscht werden.

In den gehärteten Modulen des Linux-Clients (store.py, indicizzatore.py, cestino.py) verankern wir Dateizugriffe daher an geöffneten Verzeichnis-Deskriptoren (dir_fd) mit O_NOFOLLOW, sodass der Systemaufruf bei einem Symlink am Zielpunkt abbricht. Auf macOS wiederum automatisiert der Server-zu-Server-Transfer (enqueueServerToServer / runServerToServer) den Kopiervorgang zwischen zwei entfernten Rechnern über zwei aufeinanderfolgende rsync-Läufe mit Wiederaufnahme (Resume): Der Dateiname wird auf eine einzelne Pfadkomponente bereinigt (componenteFileContenuto gegen ../-Ausbruch), in einem isolierten temporären Verzeichnis (ServerMountApp-xfer-<UUID>) zwischengespeichert, zum Zielserver hochgeladen und anschließend per Best-Effort bereinigt. Genau wie in der Programmoberfläche offen ausgewiesen, laufen die Elemente dabei als temporärer Puffer über den Mac — wir behaupten weder ein plattenloses In-Memory-Streaming noch ungemessene Geschwindigkeitsgewinne.

Warum die Reihenfolge der Signaturprüfung bei Updates sicherheitsentscheidend ist

Ein ähnliches Prinzip gilt für Software-Updates und Fehlerberichte. Wer das innere Release-Manifest bereits vor der kryptografischen Prüfung interpretiert, trifft Versions- und Download-Entscheidungen auf Basis nicht authentifizierter Daten. In aggiornamenti.py liest der Linux-Client aus der größenbegrenzten äußeren JSON-Hülle lediglich das Rohfeld contenuto und die Signatur aus, prüft zunächst die Ed25519-Signatur gegen den fest hinterlegten öffentlichen Schlüssel über die exakten UTF-8-Bytes und parst erst nach gültiger Signatur das innere JSON samt Ablaufdatum, Plattformpaket und Versionsnummer. Ebenso überprüfen wir die streng optionale Absturz-Telemetrie automatisiert: Die Testsuite sendet künstliche Ausnahmefälle mit sensiblen Testpfaden an einen lokalen Mock-Empfänger, der den Lauf sofort abbricht, falls ein ungeschwärzter Benutzername oder Dateipfad im Paket verbleibt.

cardinal-contracts 1.0.0: Sechs kanonische Spezifikationen und offene Konvergenzbilanz

Das Fundament der plattformübergreifenden Protokollarbeit bildet das Paket cardinal-contracts in Version 1.0.0. Statt Protokollregeln doppelt in Swift- und Python-Kommentaren zu pflegen, definieren sechs kanonische deklarative JSON-Spezifikationen (eingebettet in ein Paket aus insgesamt 36 manifestgesicherten Dateien) das Referenzverhalten auf dem Draht:

Vertragsspezifikation Technischer Regelungsgegenstand Geprüfte Fehlerrisiken & Abgrenzung
control-input Kodierung von Tastaturcodes, Modifikatoren, Zeigerbewegungen und Scroll-Achsen Abweichende Tastatur-/Zeigerformate auf den geprüften Linux-Empfängern (Client-Emission noch separat)
capture-geometry Monitorauflösungen, Skalierungsfaktoren, Ausschnittgrenzen und Koordinatenabbildung Rundungs- und Grenzabweichungen bei HiDPI- und Multi-Monitor-Geometrien
consent-r7 Zustandsautomat für Sitzungszustimmung, Zeitfenster, Erneuerung und sofortigen Widerruf Abweichende Antwortformate isolierter R7-Emitter (Grant-Lesen und RDP-Abbau im Runner simuliert)
session-handshake Versionsaushandlung, Fähigkeits-Flags und deterministischer Rückfall auf Nur-Ansicht Parser- und Grenzwerte für Stream-Eröffnung und SSH-Zeilengrammatik
h264-sei Struktur der eingebetteten user_data_unregistered-SEI-Nachrichten im H.264-Strom Annex-B-Aufteilung und SEI-Metadaten (inklusive 19 gemeinsamer Smoke-Vektoren gegen Swift H264Stream)
sync-crypto Schlüsselableitung, Nonce-Format, Versionspräfixe und Authentifizierungs-Tags KDF-Parameter, Nonce-Aufbau und Ablehnung manipulierter Chiffrate im Python-Client

Bevor Konformitätstests anlaufen, prüft package_integrity.py ein SHA-256-Manifest über alle 36 Paketdateien, damit weder unbemerkte Dateiänderungen noch unvollständige Checkouts Ergebnisse verfälschen. Der Python-Runner umfasst 13 Prüfabschnitte mit insgesamt 278 Konformitätsvektoren sowie einen Katalog von 53 dokumentierten Quellmutationen, die in isolierten Arbeitskopien Grenzwerte und Validierungen verfälschen.

Genauso wichtig wie dieser Umfang ist der in coverage.json und discrepancies.json offen ausgewiesene Ist-Stand: Das Paket weist ausdrücklich complete_parity = false und 11 offene Diskrepanzen (D01–D11, etwa zu Relativbewegungen mr, Koordinatenrundungen, Scroll-Grenzen, Bildschirmindizes ab 64, Audio-SEI-Zuständen und SSH-Stream-Quoting) zur schrittweisen Bereinigung aus. Während python-client (Krypto und H.264/SEI), die per AST isolierten Linux-Agentenfunktionen samt Eingabe-Empfängern sowie ein macOS-Smoke-Test für H264Stream ausführbar sind, ist die Python-Client-Emission für Eingabe/Handshake als not-implemented und das vollständige Swift-XCTest-Ziel als prepared-not-integrated markiert. Beim Lauf gegen den aktuellen Infrastruktur-Stand prüft der Runner alle 278 Vektoren in 13 Abschnitten und meldet 245 bestandene Prüfungen sowie 33 Fehlermeldungen (24 NameError und 9 ValueError in den AGENTE-Abschnitten und D11): Sie zeigen, dass die AST-Isolation des weiterentwickelten Agenten nachgeführt werden muss, ohne für sich genommen bereits eine Änderung des Drahtprotokolls zu beweisen.

Verschlüsselte Synchronisation: Was heute steht und was sich im Aufbau befindet

Administratoren wechseln regelmäßig zwischen Büro-Workstation und mobilem Rechner. CardinalHost unterscheidet dabei streng zwischen zwei unterschiedlichen Synchronisationsaufgaben mit jeweils eigenem kryptografischem Profil:

  1. Clientseitige Konfigurationssynchronisation (Format SMv1): Verbindungsprofile und Host-Inventare werden bereits auf dem Endgerät verschlüsselt, bevor ein einziges Byte übertragen oder abgelegt wird. Nach expliziter Prüfung des Versionspräfixes SMv1 leitet CardinalHost aus dem Benutzerschlüssel mittels PBKDF2-HMAC-SHA256 und 600.000 Iterationen samt zufälligem Salt pro Umschlag den symmetrischen Schlüssel ab und schützt die Nutzdaten authentifiziert über AES-256-GCM. Klartext-Konfigurationen oder Passphrasen verlassen den Client nicht; Manipulationen am Chiffrat scheitern an der GCM-Tag-Prüfung.
  2. Direkter Ordner-Synchronisationskanal zwischen Geräten: Für den direkten Dateiaustausch ohne fremde Cloud-Speicher erreichte CardinalHost am 1. September 2026 den Meilenstein für den verschlüsselten Transportkanal (Sync 1.0): Ein Handshake mit gegenseitiger Authentifizierung (Mutual Authentication) und ein mit ChaCha20-Poly1305 gesicherter Datenstrom wurden erfolgreich im realen Mac↔Linux-LAN verifiziert.

Klare Abgrenzung des Reifegrads: Ein verifizierter, gegenseitig authentifizierter Mac↔Linux-Kanal im lokalen Netz ist das kryptografische Fundament — aber noch keine fertige Dauer-Synchronisation. Kontinuierliche Hintergrundüberwachung, Konfliktauflösung bei gleichzeitigen Änderungen und vollständige Zwei-Wege-Konvergenz über längere Offline-Phasen befinden sich aktiv im Aufbau. Wir erheben daher bewusst keinen Anspruch auf Funktionsgleichheit mit jahrelang gereiften Spezialwerkzeugen wie Syncthing.

Rund 238 behobene Befunde im internen Adversarial Audit vom August 2026

Forschungsorientierte Softwareentwicklung bedeutet auch, den eigenen Code systematisch auf Schwachstellen zu prüfen, bevor Kunden ihm produktive Infrastruktur anvertrauen. In der Entwicklungs-Chronik auf cardinalhost.org ist für August 2026 ein internes adversariales Audit dokumentiert, das rund 238 bestätigte und im Code behobene Fehler nennt — ausdrücklich ausgewiesen als interner Nachweis für den geprüften Umfang und nicht als unabhängige Produktzertifizierung.

In den hier beschriebenen Sicherheits- und Protokollmodulen — darunter dir_fd/O_NOFOLLOW in den lokalen Linux-Pfaden, die Ed25519-Signaturprüfung vor dem JSON-Parse in aggiornamenti.py, das KI-Werkzeug-Gate (GateAIAgente und StrumentiAIAgente) und senzaACapo in der Diagnosevorschau, der Schreibwächter _percorso_avvio_vietato sowie PonteAI — sichern gezielte Regressionstests diese Grenzen gegen spätere Umbauten ab, während für die Ausgabekürzung limita in ServerMountAppTests noch ein eigener Einheitstest offen ist. Dieselbe Methodik aus expliziten Verträgen, automatisierten Prüfskripten und strikter Mehrsprachigkeits-Konsistenz setzen wir in unserer Kundenarbeit ein — dokumentiert in unserer Engineering Note zu automatisierten Konsistenz- und Übersetzungsprüfungen in Django sowie in unserer Individualentwicklung robuster Python- und Django-Systeme.

Fazit: Überprüfbare Systemtechnik statt Marketing-Versprechen

Über alle drei Forschungs- und Architekturbeiträge hinweg folgt CardinalHost einer einheitlichen Leitlinie: Technische Aussagen auf konkrete Module im Code, dokumentierte Prüfverfahren und eine offene Benennung heutiger Grenzen sowie offener Diskrepanzen zu stützen — von Wayland über PipeWire und die Befehlssperre bis hin zu Cross-OS-Verträgen und authentifizierter Kryptografie. Wer den weiteren Fortschritt bis zum Marktstart verfolgen möchte, findet den aktuellen Stand jederzeit auf cardinalhost.org sowie in unserer Projektübersicht zu CardinalHost.

Häufig gestellte Fragen (FAQ)

Warum nutzt CardinalHost native Clients in Swift und GTK 4 statt einer Electron-Oberfläche?

Weil CardinalHost ohne eingebettete Browser-Laufzeit direkt an die nativen Oberflächen- und Sicherheitsmechanismen des jeweiligen Betriebssystems anbindet: Swift und SwiftUI mit CryptoKit und System-Keychain unter macOS sowie GTK 4 und libadwaita mit GNOME Keyring (libsecret), GVfs/sshfs und dir_fd/O_NOFOLLOW-geschützten Dateipfaden unter Linux.

Wie erkennt CodLab Protokolldrift zwischen macOS- und Linux-Komponenten in CardinalHost?

Über das Paket cardinal-contracts 1.0.0: Sechs deklarative JSON-Spezifikationen (in 36 per SHA-256-Manifest gesicherten Paketdateien), 278 Konformitätsvektoren in 13 Abschnitten und 53 dokumentierte Quellmutationen prüfen Drahtformate gegen reale Module. Das Paket weist Grenzen offen aus: complete_parity ist false, die volle Swift-XCTest-Integration ist als prepared-not-integrated markiert, 11 Diskrepanzen sind zur Bereinigung dokumentiert, und der aktuelle Lauf meldet 245 bestandene Prüfungen bei 33 offenen Abweichungen.

Wie wird die Synchronisation von Verbindungsprofilen kryptografisch geschützt?

Verbindungsprofile werden im Format SMv1 vollständig clientseitig verschlüsselt. Die Schlüsselableitung nutzt PBKDF2-HMAC-SHA256 mit 600.000 Iterationen und zufälligem Salt; die Nutzdaten werden authentifiziert mit AES-256-GCM geschützt.

Ist die direkte Ordnersynchronisation zwischen Geräten bereits vollständig abgeschlossen?

Nein. Der gegenseitig authentifizierte und mit ChaCha20-Poly1305 verschlüsselte Übertragungskanal wurde am 1. September 2026 erfolgreich im Mac-zu-Linux-LAN verifiziert. Kontinuierlicher Dauerbetrieb und automatische Zwei-Wege-Konvergenz bei Konflikten befinden sich jedoch noch im Aufbau.

Teilen Sie diesen Artikel

Kunden

Noch keine Kommentare. Schreiben Sie den ersten!

Einen Kommentar hinterlassen

Wird nicht veröffentlicht

Verwandte Artikel

Projekt im Kopf?

Wir entwickeln maßgeschneiderte Software und KI-Lösungen. Lassen Sie uns gemeinsam Ihr nächstes Projekt starten.

Kostenloses Erstgespräch