Skip to Content

Sicurezza

L’Appliance funziona su hardware e in una rete che gestisci tu. IronFlock fornisce il software e le sue impostazioni predefinite; quanto bene l’Appliance sia protetta dipende anche dalla modalità che scegli, dalla rete che la circonda e dall’host su cui gira. Questa pagina è la checklist per questa parte.

Cosa Protegge Ciascuna Modalità

L’Appliance funziona in una di tre modalità, descritte in HTTPS e certificati. Si differenziano per ciò che viene cifrato e verificato:

HTTP semplice (predefinito)HTTPS con una CA autogenerataHTTPS con il tuo certificato aziendale
Browser verso l’ApplianceNon cifratoHTTPSHTTPS
Cookie di loginNon contrassegnati come secureSecureSecure
Collegamento del dispositivo (porta 18080)Non cifratoNon cifratoHTTPS su 443
Immagini delle app e aggiornamenti dell’agent per i dispositiviNon cifratiNon cifratiHTTPS su 443
Tunnel di accesso remoto dei dispositiviCifrato, server non verificatoCifrato, server non verificatoCifrato e verificato
Passkey e chiavi di sicurezzaSolo dall’Appliance stessaSìSì

Usa HTTPS con il tuo certificato aziendale ovunque l’Appliance condivida una rete con altri sistemi. È l’unica modalità in cui i dispositivi connessi verificano con chi stanno comunicando. Le altre due modalità sono adatte a un segmento di rete raggiungibile solo dall’Appliance, dai suoi dispositivi e dai suoi operatori.

Cosa Resta Non Cifrato

Anche con HTTPS, una parte del traffico non è cifrata. Pianifica la tua rete tenendone conto:

  • Il collegamento del dispositivo sulla porta 18080 è pubblicato su ogni interfaccia di rete in ogni modalità. Vi si connettono l’agent del dispositivo dell’Appliance stessa e le app in esecuzione sull’Appliance e, in modalità HTTP semplice e con una CA autogenerata, anche tutti i dispositivi connessi.
  • I tunnel di accesso remoto verso l’Appliance (porta 7000) sono cifrati in modalità HTTP semplice e con una CA autogenerata, ma i dispositivi non possono verificare il certificato dell’Appliance. Chi ha accesso al percorso di rete potrebbe spacciarsi per il server dei tunnel dell’Appliance. Gli agent dei dispositivi registrano un avviso quando si connettono in questo modo.
  • Le connessioni tra i servizi all’interno dell’Appliance, ad esempio verso i suoi database, non sono cifrate. Non lasciano l’host.
  • I dati a riposo non sono cifrati dall’Appliance. Usa la cifratura del sistema operativo o del disco dell’host se l’Appliance memorizza dati sensibili o se potrebbe lasciare i tuoi locali.

Checklist di Hardening

  • Scegli la modalità adatta alla tua rete (vedi Cosa Protegge Ciascuna Modalità).
  • Limita chi può raggiungere le porte dell’Appliance. L’installazione non apre nulla nel tuo firewall, e Docker pubblica le porte dell’Appliance aggirando le consuete regole in ingresso del firewall dell’host (ufw, firewalld). Filtra nella catena DOCKER-USER o sul firewall di rete: l’installazione lascia un modello in /opt/ironflock/docker-user-firewall.sh.example. Consenti le porte dei dispositivi (18080, 15001, 15002, 7000, 30000–30049) solo dalle reti dei tuoi dispositivi — vedi Dispositivi che si Connettono all’Appliance.
  • Mantieni aggiornato il sistema operativo dell’host e limita chi vi ha un account. Chiunque abbia accesso root sull’host può leggere tutti i segreti dell’Appliance.
  • Usa le chiavi SSH invece delle password per l’accesso amministrativo all’host.
  • Configura la sincronizzazione oraria — vedi Sincronizzazione oraria (NTP).
  • Cambia la password di amministratore dopo il primo accesso e configura un secondo fattore per l’account amministratore.
  • Richiedi un secondo fattore a tutti non appena tutti gli account ne hanno uno (vedi Account e Accesso).
  • Proteggi con un secondo fattore l’account ironflock.com proprietario dell’istanza: ha accesso amministrativo all’Appliance dal cloud.
  • Disattiva la connessione cloud se nessuno ha bisogno di lavorare sull’Appliance da ironflock.com (vedi Connessione Cloud).
  • Installa solo app di cui ti fidi. Le app girano sull’Appliance e sui tuoi dispositivi con ampio accesso all’host, compresi i file di configurazione dell’Appliance.
  • Mantieni aggiornata l’Appliance (vedi Aggiornamenti).
  • Verifica ironflock prima dell’installazione iniziale (vedi Verificare ironflock Prima dell’Installazione Iniziale).

Account e Accesso

  • Account amministratore: ogni Appliance riceve una propria password di amministratore all’installazione; ironflock appliance install la mostra una sola volta. Se la perdi, impostane una nuova come descritto in Operatività Locale — questo chiude anche tutte le sessioni di amministratore.
  • I nuovi utenti possono registrarsi solo con un invito da un progetto sull’Appliance. Senza invito la registrazione viene rifiutata, anche tramite social login.
  • Secondo fattore: gli utenti possono configurare un’app di autenticazione (TOTP), passkey o chiavi di sicurezza e codici di recupero. Passkey e chiavi di sicurezza richiedono HTTPS. L’opzione --2fa di ironflock appliance install o di ironflock appliance configure imposta la policy, che resta valida anche dopo gli aggiornamenti:
    • available — gli utenti possono configurare un secondo fattore, ma non viene mai richiesto.
    • effective (predefinito) — gli utenti che hanno un secondo fattore devono usarlo.
    • required — ogni utente deve usare un secondo fattore. Assicurati prima che ogni account ne abbia uno: un utente che ne è privo non potrà più accedere.
  • Le sessioni durano 24 ore.
  • Accesso da ironflock.com: l’account ironflock.com che ha creato la chiave dell’istanza è collegato all’account amministratore dell’Appliance. Gli utenti che inviti collegano i propri account ironflock.com — vedi Collegamento degli Account. Un utente può rimuovere questo collegamento in qualsiasi momento. Per bloccare ogni accesso da ironflock.com, l’amministratore disattiva la connessione cloud.

Segreti sull’Host

ironflock appliance install genera i segreti dell’Appliance una sola volta, all’installazione, e li conserva negli aggiornamenti. Si trovano in /opt/ironflock/:

FileContenutoAccesso
.envPassword e chiavi di tutti i servizi, la password iniziale di amministratore, credenziali del proxy e SMTPSolo root (0600)
license.envLa chiave dell’istanza, e ciò che la convalida della licenza memorizza con essaRoot e i servizi IronFlock (0640)
certs/Il certificato HTTPS e la sua chiave; con una CA autogenerata anche la chiave della CAChiavi private solo root (0600)
registry-token-certs/La chiave che firma i token per il download delle immagini delle appSolo il servizio del registro (0600)
.env.prev, rotation.logIl .env precedente all’ultima rotazione; quando e di quale segreto è stata eseguita la rotazione, senza valoriSolo root (0600)

L’installazione esegue inoltre il login di Docker al registro IronFlock con la tua chiave dell’istanza, quindi anche la configurazione Docker di root la contiene.

Includi questi file nei tuoi backup e proteggi i backup come l’Appliance stessa. Non eliminare mai .env e non lasciare che un’installazione lo generi di nuovo: i database e i dati cifrati dipendono dai suoi valori. Per sostituire un segreto, eseguine la rotazione.

Cosa puoi sostituire da solo:

  • Password di amministratore: nel profilo, oppure con sudo ironflock appliance reset-admin-password (vedi Operatività Locale).
  • Certificato HTTPS: il tuo certificato con sudo ironflock appliance configure --tls-cert <file> --tls-key <file> (vedi HTTPS e certificati). Un certificato della CA dell’Appliance stessa si rinnova da solo: un controllo settimanale ne firma uno nuovo quando mancano meno di 30 giorni.
  • Chiave dell’istanza: nella sezione licenza del profilo amministratore, oppure con sudo ironflock appliance configure --license-file <file>, dove il file contiene la nuova chiave. La nuova chiave deve aprire il registro IronFlock prima di essere scritta.
  • Credenziali SMTP: in .env, poi riavvia con sudo ironflock appliance restart.
  • Proxy: con sudo ironflock appliance configure (vedi Dietro un Proxy Aziendale).
  • Segreti interni dei servizi: sudo ironflock appliance rotate <NAME>, vedi sotto.

Rotazione di un Segreto Interno

sudo ironflock appliance rotate <NAME> dà un nuovo valore a un segreto di .env mentre l’Appliance è in funzione. Il nuovo valore va prima dove è custodito quello vecchio (un ruolo del database, il file del dispositivo dell’agent, la coppia di chiavi dei token del registro), poi in .env. Vengono ricreati solo i servizi che leggono il segreto, e il comando verifica che siano di nuovo integri. Il .env precedente alla modifica resta come .env.prev, e rotation.log elenca ogni rotazione, mai un valore. ironflock appliance rotate --help elenca i nomi di cui può eseguire la rotazione. Vedi ironflock appliance rotate.

Esegui le rotazioni via SSH o sulla console dell’Appliance, non nel terminale del dispositivo dell’Appliance stessa in IronFlock: una rotazione che riavvia i servizi da cui dipende questo terminale lo interrompe.

SegretiCosa fa una rotazione
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET e gli altri segreti dei serviziI servizi che lo usano si riavviano; le loro connessioni tornano entro pochi secondi.
KRATOS_SECRETS_COOKIEI nuovi accessi usano la nuova chiave; le sessioni avviate prima restano valide, perché la chiave precedente viene conservata fino alla rotazione successiva.
POSTGRES_PASSWORD, PGPASSWORD_*, DATASERVICE_PASSWORDIl ruolo del database riceve la nuova password, poi i suoi servizi si riavviano. Prima chiede; --yes risponde.
REGISTRY_TOKEN_KEYI token per il download delle immagini delle app vengono firmati con una nuova chiave; i token firmati prima restano validi fino alla rotazione successiva. Prima chiede; --yes risponde.
APPLIANCE_DEVICE_SECRETIl dispositivo dell’Appliance stessa riceve una nuova credenziale; il suo agent si riavvia e torna online entro un minuto. Prima chiede; --yes risponde.
FILE_CRED_KEYLe app conservano i loro file; il loro accesso allo storage passa alla nuova chiave. Per le credenziali S3 dirette delle app, scegli --keep-direct-access o --revoke-direct-access. Le credenziali mantenute continuano a funzionare, per una rotazione pianificata: chi conosce la chiave precedente può ancora ricavarle, perciò le impostazioni di storage di ogni app le segnalano da sostituire, e sudo ironflock appliance revoke-direct-access rimuove in seguito quelle rimaste. Le credenziali revocate smettono di funzionare e vengono rimosse subito, ad esempio dopo una sospetta fuga di dati. Prima chiede (--yes risponde) e richiede la versione dell’Appliance 1.6.23 o successiva.
APPLIANCE_ADMIN_PASSWORDUna nuova password iniziale di amministratore, come con ironflock appliance reset-admin-password.

Esegui la rotazione di FLEETDB_SECRET_KEYS, KRATOS_SECRETS_CIPHER e delle due chiavi OBJECTSTORE_ADMIN_* solo insieme al team IronFlock: i dati memorizzati con esse dipendono da esse. La chiave dell’istanza si cambia nel profilo amministratore o con ironflock appliance configure, non con rotate.

Connessioni in Uscita e Telemetria

Le destinazioni a cui si connette l’Appliance sono elencate in Configurazione del Firewall; tutte queste connessioni sono cifrate.

  • La convalida della licenza invia la chiave di licenza, un’impronta dell’hardware e i token di accesso delle connessioni dell’Appliance all’App Store online.
  • L’assistente AI invia i prompt attraverso il gateway LLM di IronFlock, a meno che tu non configuri un gateway tuo.
  • Nessuna telemetria. L’Appliance non invia analisi d’uso: né la UI dell’Appliance né i suoi servizi riportano l’utilizzo a IronFlock o a terzi.
  • Dal browser dell’utente: le tile delle mappe vengono caricate da Mapbox e l’input vocale usa il servizio di riconoscimento vocale Deepgram. Queste connessioni sono effettuate dal browser, non dall’Appliance.

Aggiornamenti

  • Gli aggiornamenti dell’Appliance vengono avviati dall’amministratore (vedi Manutenzione) e sono firmati da IronFlock. ironflock verifica l’elenco delle versioni disponibili e il manifest di release della nuova versione con la chiave di rilascio dell’Appliance che contiene, poi ogni file della nuova versione e ogni immagine container rispetto a quel manifest. Un file modificato o non firmato, o qualsiasi immagine diversa da quella rilasciata, interrompe l’aggiornamento prima che sull’Appliance cambi qualcosa. Un aggiornamento non riporta mai l’Appliance a una versione precedente di propria iniziativa e, se un aggiornamento fallisce, l’Appliance torna alla versione che eseguiva in precedenza.
  • Gli aggiornamenti dell’agent del dispositivo sono firmati. Ogni agent verifica la firma prima di applicare un aggiornamento ed esegue il rollback se la nuova versione non si avvia — vedi Aggiornamenti dell’Agent del Dispositivo.
  • Il sistema operativo dell’host, Docker compreso, è sotto la tua responsabilità.

Verificare ironflock Prima dell’Installazione Iniziale

L’Appliance verifica da sola ogni aggiornamento: ironflock verifica ogni release dell’Appliance con la chiave di rilascio dell’IronFlock Appliance che contiene, prima di installarla. Ciò di cui ti fidi sulla parola è lo script di installazione di ironflock, che viene eseguito come root. Verificalo prima che venga eseguito, come descritto in Verificare prima lo script di installazione: gpg deve riportare una firma valida della chiave IronFlock Bootstrap con l’impronta F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788. Lo script a sua volta verifica ironflock con quella chiave prima di installarlo. Entrambe le chiavi sono elencate in Chiavi di Firma.

Backup e Ripristino

Per eseguire il backup dell’intera Appliance, arrestala con sudo ironflock appliance stop e copia:

  • la cartella /opt/ironflock/, compresi .env, license.env, certs/ e registry-token-certs/;
  • i volumi Docker dell’Appliance (docker volume ls), che contengono i database, i file, il Local App Store e i file degli utenti.

Poi riavviala con sudo ironflock appliance start. Conserva .env insieme ai volumi dello stesso momento: i dati cifrati nei volumi possono essere letti solo con le chiavi contenute in quel .env.

I soli segreti possono essere salvati mentre l’Appliance è in funzione:

sudo ironflock appliance backup -o /root/appliance-secrets.tar.gz

L’archivio contiene .env, license.env, la CA, le chiavi dei token del registro, l’inventario dei segreti e rotation.log; solo root può leggere il file. Un FLEETDB_SECRET_KEYS o un FILE_CRED_KEY perso non si può recuperare in nessun altro modo: cifra l’archivio e conservalo con i backup dei volumi.

Per ripristinare i segreti su un’Appliance installata, esegui il ripristino con --force mentre è in funzione, poi riavviala affinché ogni servizio legga i file ripristinati:

sudo ironflock appliance restore appliance-secrets.tar.gz --force sudo ironflock appliance restart

Il .env dell’Appliance precedente al ripristino resta come .env.prev. Su una macchina nuova, installa ironflock, esegui sudo ironflock appliance restore appliance-secrets.tar.gz, poi installa l’Appliance come di consueto, con la chiave dell’istanza e le opzioni usate in precedenza, ad esempio --tls. Vedi ironflock appliance backup e ironflock appliance restore.

Dismissione

  1. Trasferisci o rilascia la licenza mentre l’Appliance è ancora online — vedi Trasferire la Licenza su Nuovo Hardware.

  2. Rimuovi il software:

    sudo ironflock appliance remove --purge sudo ironflock agent remove

    ironflock appliance remove --purge rimuove i servizi, i container e la rete dell’Appliance, il login di Docker al registro IronFlock, le modifiche che la sua installazione ha apportato all’host e, con --purge, anche i suoi dati: la directory di installazione /opt/ironflock con .env e license.env, i volumi Docker e le immagini. ironflock agent remove rimuove poi l’agent del dispositivo proprio dell’Appliance. Ogni comando elenca ciò che rimuove e prima chiede; --yes risponde. Docker resta installato, e così ironflock in /usr/local/bin. Vedi ironflock appliance remove e ironflock agent remove.

  3. Se l’hardware lascia i tuoi locali, cancella il suo disco in modo sicuro — i comandi precedenti eliminano i file, ma non li sovrascrivono.

Impostazioni che Indeboliscono la Sicurezza

Alcune impostazioni esistono solo per la risoluzione dei problemi. Lasciale non impostate in produzione:

  • AGENT_UPDATE_ALLOW_UNSIGNED — consente a un agent del dispositivo di applicare aggiornamenti non firmati. Funziona solo come until=<time>, al massimo 24 ore in anticipo, e poi scade da solo.
  • TUNNEL_AUTHZ_ENFORCE=false — consente ai dispositivi di aprire tunnel senza dimostrare la propria identità.
  • ?tls.rejectUnauthorized=false in SMTP_CONNECTION_URI — accetta qualsiasi certificato dal tuo server di posta.
  • --2fa available — i secondi fattori non vengono mai richiesti.
Last updated on