Aggiornato a novembre 2026: CardinalHost (attualmente in fase di pre-lancio e documentato su cardinalhost.org) sviluppa client nativi per macOS (Swift/SwiftUI) e Linux (GTK 4/libadwaita) lungo specifiche di protocollo condivise (cardinal-contracts 1.0.0). Sei contratti JSON canonici, 278 vettori di conformità in 13 sezioni e 53 mutazioni sorgente documentate fanno emergere in modo riproducibile le divergenze (attualmente 245 verifiche riuscite, 33 fallimenti aperti e 11 discrepanze censite), affiancati dalla cifratura AES-256-GCM dei profili e dai canali ChaCha20-Poly1305 provati in LAN.
Perché gli strumenti nativi multi-piattaforma devono presidiare la deriva di protocollo
Chi progetta software multi-piattaforma per amministrazione server, trasferimento file e teleassistenza incorpora spesso un motore browser completo come Electron per mantenere una sola interfaccia. Nell’intera famiglia Cardinal — accanto a CardinalMail e CardinalOS — abbiamo scelto deliberatamente di non includere un runtime browser: senza rivendicare benchmark comparativi di memoria o latenza rispetto a runtime di terze parti, lo sviluppo nativo consente a ogni client di dialogare direttamente con le interfacce e le primitive di sicurezza del proprio sistema operativo.
Mantenere due implementazioni native in linguaggi diversi apre però un problema ingegneristico classico: la deriva del protocollo sul filo. Quando un client Swift su macOS dialoga con un client o un agente Python e GTK 4 su Linux, basta una minima discrepanza nella serializzazione dei byte, nella proiezione delle coordinate su schermi HiDPI, nel formato dei nonce AEAD o nella scadenza dei token di consenso per introdurre malfunzionamenti silenziosi o vulnerabilità. I documenti descrittivi sui wiki invecchiano rapidamente. Nel lavoro su CardinalHost presentato nella sezione di ricerca dei nostri progetti le specifiche di protocollo sono quindi dichiarative, sigillate da manifesto SHA-256 ed eseguite progressivamente contro moduli reali — dichiarando apertamente adattatori non ancora integrati e discrepanze aperte.
Due client nativi costruiti sulle primitive di sicurezza del sistema operativo
Prima ancora di scambiare pacchetti in rete, ciascun client utilizza direttamente i meccanismi di protezione nativi della propria piattaforma:
- Client macOS (Swift & SwiftUI): Basato nativamente su Apple
CryptoKite sul Keychain di sistema, unisce il controllo remoto al montaggio di volumi SFTP, SMB, NFS e WebDAV, ai trasferimenti da server a server a due tratte viarsynctramite buffer temporaneo isolato e a una console live da 2 / 4 / 8 host chiusa nel codice e nei test automatici (con collaudo sul campo in corso). - Client Linux (GTK 4 & libadwaita): Progettato nativamente per gli ambienti GNOME moderni, custodisce le credenziali nel GNOME Keyring tramite
libsecrete integra i filesystem remoti attraversoGVfsesshfs. I moduli locali induriti di archivio, indicizzazione e cestino ancorano gli accessi ai descrittori di cartella (dir_fd) con flagO_NOFOLLOWper difendere quei percorsi da sostituzioni TOCTOU tramite symlink. - Manifesti di aggiornamento firmati e telemetria opt-in redatta: Su Linux il controllo aggiornamenti estrae dalla busta JSON esterna (massimo 256 KiB) la stringa grezza firmata e ne valida la firma crittografica Ed25519 prima di decodificare il JSON interno del rilascio o di fidarsi di versioni e URL. La telemetria degli arresti anomali è strettamente opzionale (opt-in), oscura preventivamente percorsi locali e nomi utente ed è collaudata contro un ricevitore mock locale.
Percorsi locali ancorati ai descrittori e staging trasparente da server a server
Due percorsi di gestione dei file mostrano come CardinalHost unisca primitive di sistema e trasparenza sui compromessi attuali. Quando routine locali su Linux operano in cartelle in cui una voce potrebbe essere sostituita con un link simbolico, una verifica basata solo su stringhe di percorso lascia aperta una finestra Time-of-Check-to-Time-of-Use (TOCTOU) tra controllo e apertura.
Nei moduli locali induriti del client Linux (store.py, indicizzatore.py, cestino.py) ancoriamo le operazioni ai descrittori di cartella aperti (dir_fd) combinati con O_NOFOLLOW, cosicché il kernel rifiuti l’apertura se l’elemento finale è un symlink. Sul lato macOS, invece, il trasferimento da server a server (enqueueServerToServer / runServerToServer) automatizza la copia tra due nodi remoti mediante due tratte consecutive rsync con ripresa (resume): riduce il nome remoto a un singolo componente (componenteFileContenuto contro ../), scarica nella cartella temporanea isolata ServerMountApp-xfer-<UUID>, carica verso il server di destinazione e tenta la pulizia best-effort del buffer al termine o in caso di errore (senza garantirne la scomparsa se la rimozione fallisce). Esattamente come dichiarato nel piè di pagina dell’interfaccia macOS, gli elementi transitano dal Mac come buffer temporaneo: non promettiamo streaming in sola memoria senza disco locale né dimezzamenti non misurati dei tempi di trasferimento.
Perché l’ordine di verifica delle firme negli aggiornamenti è decisivo
Lo stesso criterio guida gli aggiornamenti software e la diagnostica degli errori. Interpretare i campi interni di un bollettino prima di autenticarlo significherebbe prendere decisioni su versioni e pacchetti non fidati. In aggiornamenti.py il client Linux legge dalla busta JSON esterna di dimensione limitata soltanto la stringa grezza contenuto e la firma, verifica la firma Ed25519 sui byte UTF-8 esatti rispetto alla chiave pubblica integrata e decodifica il JSON interno — scadenza, piattaforma e numero di versione — esclusivamente dopo l’esito positivo della firma. Allo stesso modo, la batteria di test invia tracce d’errore sintetiche con percorsi e nomi utente civetta a un ricevitore mock locale, facendo fallire il test se un dato non oscurato sopravvive alla serializzazione.
cardinal-contracts 1.0.0: sei specifiche dichiarative e stato reale della convergenza
Il lavoro sulla coerenza tra piattaforme poggia sul pacchetto cardinal-contracts (versione 1.0.0) nel repository infrastrutturale Cardinal. Al posto di regole duplicate nei commenti di Swift e Python, sei specifiche JSON dichiarative canoniche (racchiuse in un pacchetto di 36 file sigillati) definiscono la semantica di riferimento sul filo:
| Specifica di contratto | Dominio tecnico governato | Rischi di deriva presidiati e perimetro |
|---|---|---|
control-input |
Codifica dei codici tasto, maschere dei modificatori, movimento puntatore e assi di scorrimento | Parsing di tasti e puntatore sui ricevitori Linux estratti via AST (emissione client Python ancora distinta) |
capture-geometry |
Dimensioni monitor, fattori di scala HiDPI, aree di ritaglio e proiezione coordinate | Arrotondamenti e casi limite sulle geometrie HiDPI e multi-monitor |
consent-r7 |
Ciclo di vita del token di consenso, finestre temporali, rinnovo e revoca istantanea | Risposte degli emettitori R7 isolati (lettura grant e teardown RDP simulati nel runner) |
session-handshake |
Negoziazione di versione, flag di capacità e degrado deterministico a sola vista | Limiti di apertura stream e grammatica del parser di riga SSH |
h264-sei |
Struttura binaria dei messaggi H.264 SEI user_data_unregistered nel flusso video |
Partizione Annex-B e metadati SEI (inclusi 19 vettori comuni compilati nello smoke test di Swift H264Stream) |
sync-crypto |
Parametri di derivazione chiave, struttura dei nonce, intestazioni di versione e tag AEAD | Parametri KDF, formato dei nonce e rifiuto dei cifrati manomessi nel modulo client Python |
Prima di avviare le verifiche, package_integrity.py controlla un manifesto SHA-256 su tutti i 36 file del pacchetto, impedendo che copie incomplete o alterate falsino l’esito. Il runner Python raccoglie 278 vettori di conformità distribuiti in 13 sezioni insieme a un catalogo di 53 mutazioni sorgente documentate pensate per alterare limiti e rami di validazione su copie temporanee.
Altrettanto essenziale è il registro esplicito di copertura e parità contenuto in coverage.json e discrepancies.json: il pacchetto dichiara apertamente complete_parity = false e censisce 11 discrepanze aperte (D01–D11, relative tra l’altro al comando relativo mr, agli arrotondamenti delle coordinate, allo scroll, agli indici schermo >= 64, agli stati audio SEI sconosciuti e al quoting dello stream SSH) da riconciliare. Mentre python-client (crypto e H.264/SEI), le funzioni pure e i ricevitori input dell’agente Linux estratti via AST e uno smoke test macOS su H264Stream sono oggi eseguibili, l’emissione input/handshake del client Python è marcata not-implemented e l’integrazione XCTest completa in Swift è marcata prepared-not-integrated. Eseguendo l’intero perimetro di 13 sezioni sul checkout corrente dell’infrastruttura vengono valutati tutti i 278 vettori con 245 verifiche riuscite e 33 fallimenti (24 NameError e 9 ValueError nelle sezioni AGENTE e in D11): mostrano che l’isolamento AST dell’agente evoluto va riallineato, senza dimostrare di per sé una modifica del protocollo sul filo.
Sincronizzazione cifrata: cosa è già operativo oggi e cosa è in costruzione
Chi amministra infrastrutture lavorando su più postazioni ha bisogno di allineare configurazioni e cartelle di lavoro senza consegnare i propri inventari a database cloud di terze parti. CardinalHost distingue due livelli crittografici separati:
- Sincronizzazione configurazione lato client (formato
SMv1): Profili di connessione e inventari host vengono cifrati localmente sul dispositivo prima di qualunque trasferimento. Dopo la verifica esplicita del prefisso di versioneSMv1, la chiave simmetrica è derivata dal segreto dell’utente tramite PBKDF2-HMAC-SHA256 con 600.000 iterazioni e salt casuale per busta, proteggendo il contenuto in modo autenticato con AES-256-GCM. Nessuna lista server in chiaro né passphrase lascia il client, e le alterazioni del cifrato vengono respinte dalla verifica del tag GCM. - Canale diretto di sincronizzazione cartelle tra dispositivi: Per il trasferimento diretto senza cloud intermedi, il 1° settembre 2026 CardinalHost ha raggiunto il traguardo del canale cifrato (Sync 1.0): handshake con autenticazione mutua e trasporto autenticato ChaCha20-Poly1305 verificati dal vivo in LAN Mac↔Linux.
Confine esplicito di maturità: Aver dimostrato un canale ChaCha20-Poly1305 mutuamente autenticato tra macOS e Linux in rete locale costituisce la base crittografica di trasporto, non ancora una sincronizzazione continua finita. L’osservazione continua del filesystem, la risoluzione dei conflitti su modifiche concorrenti e la convergenza bidirezionale completa sono tuttora in costruzione, e non dichiariamo equivalenza funzionale con strumenti maturi dedicati come Syncthing.
Circa 238 difetti confermati e corretti nell’audit avversariale dell’agosto 2026
Applicare metodo di ricerca allo sviluppo software significa anche sottoporre sistematicamente il proprio codice a revisione critica prima di affidargli infrastrutture reali. La cronologia di sviluppo su cardinalhost.org registra per l’agosto 2026 un audit interno avversariale che riporta circa 238 difetti confermati e chiusi sul codice — dichiarato espressamente come evidenza interna sul perimetro esaminato e non come certificazione indipendente di prodotto.
Nei moduli di sicurezza e protocollo descritti in questa serie — tra cui dir_fd/O_NOFOLLOW sui percorsi locali Linux, la verifica Ed25519 prima della decodifica JSON in aggiornamenti.py, il gate degli strumenti IA (GateAIAgente e StrumentiAIAgente) e senzaACapo nell’anteprima diagnostica, la guardia sulle scritture _percorso_avvio_vietato e PonteAI — test mirati di regressione presidiano questi confini contro modifiche successive, mentre per il troncamento limita resta ancora da aggiungere uno unit test dedicato in ServerMountAppTests. Portiamo lo stesso rigore basato su contratti verificabili e cancelli automatici anche nelle piattaforme web e software per i nostri clienti, come raccontiamo nella Engineering Note sui controlli automatici di coerenza e traduzione in Django e nella pagina dedicata allo sviluppo di sistemi Python e Django su misura.
Conclusione: ingegneria verificabile al posto degli slogan
Lungo tutti e tre gli articoli dedicati a CardinalHost seguiamo una linea guida costante: ancorare le affermazioni tecniche a moduli nominati nei repository, verifiche documentate e dichiarazione trasparente dei componenti in costruzione e delle discrepanze aperte — dalla cattura nativa Wayland con PipeWire al cancello deterministico dei comandi fino ai contratti di protocollo cross-OS e alla crittografia autenticata. Gli aggiornamenti verso il lancio sono consultabili su cardinalhost.org e nella sezione di ricerca dedicata a CardinalHost nella pagina progetti.
Domande frequenti (FAQ)
Perché rinunciare a un runtime browser integrato consente di collegarsi direttamente alle interfacce e alle primitive di sicurezza di ciascun sistema operativo: Swift e SwiftUI con CryptoKit e Keychain su macOS, GTK 4 e libadwaita con GNOME Keyring (libsecret), GVfs/sshfs e percorsi locali protetti da dir_fd con O_NOFOLLOW su Linux.
Tramite il pacchetto cardinal-contracts 1.0.0: sei specifiche JSON dichiarative (in 36 file verificati da manifesto SHA-256), 278 vettori di conformità in 13 sezioni e 53 mutazioni sorgente documentate controllano i formati sul filo contro moduli reali. I limiti di perimetro sono espliciti: complete_parity è false, il target XCTest Swift completo è prepared-not-integrated, 11 discrepanze aperte sono censite per la riconciliazione e l’esecuzione corrente riporta 245 verifiche riuscite e 33 fallimenti aperti.
I profili di connessione usano il formato versionato SMv1 cifrato interamente lato client prima dell’invio. La chiave viene derivata tramite PBKDF2-HMAC-SHA256 con 600.000 iterazioni e salt casuale, cifrando e autenticando i dati con AES-256-GCM.
No. Il canale cifrato ChaCha20-Poly1305 con autenticazione mutua è stato provato con successo in LAN Mac-Linux il 1° settembre 2026, mentre il monitoraggio continuo e la convergenza automatica dei conflitti a due vie sono attualmente in costruzione.