Guida Utente

Un vault crittografato, offline-first, per password, file e note private.

OneCritto conserva tutti i tuoi dati sensibili localmente all’interno di un vault crittografato. La crittografia utilizza AES-256-GCM con una chiave master derivata tramite Argon2id. Nessun cloud, nessuna telemetria.

1. Gestione del Vault

Il tuo spazio di lavoro crittografato è contenuto in un singolo file .onecritto.

Crea un Nuovo Vault

Crea un nuovo vault crittografato e scegli una password master robusta. La chiave di cifratura viene derivata localmente tramite Argon2id.

Utenti Linux: durante la creazione di un nuovo vault, assicurati che il nome del file termini con .onecritto (es. miovault.onecritto). Su Linux l'estensione non viene aggiunta automaticamente. Senza di essa, il filtro di selezione file non mostrerà il vault al momento dell'apertura.

Apri un Vault Esistente

Apri un file .onecritto esistente. Solo i metadati delle voci (titoli, credenziali, connessioni SSH) vengono decrittati in memoria. I file cifrati restano come blob su disco e vengono decrittati on demand quando li apri o li esporti.

Salvataggio

Le voci password vengono salvate nel vault al click su Salva. I file vengono cifrati e archiviati appena li aggiungi con Aggiungi.

Backup

Il vault è un singolo file. Copialo e conservalo dove preferisci.

2. Campi Sicuri

I dati sensibili non vengono mai memorizzati in componenti UI standard.

Modalità Mascherata e Visibile

Puoi mostrare o nascondere i caratteri in qualsiasi momento. La copia funziona anche quando il testo è mascherato.

Sicurezza di Memoria e Clipboard

I buffer sicuri vengono cancellati al blocco o alla modifica dei campi. Il contenuto della clipboard viene eliminato automaticamente dopo 20 secondi.

3. File Crittografati

Archivia e gestisci file in modo sicuro all’interno del vault.

Aggiungi File

I file vengono crittografati immediatamente quando vengono aggiunti al vault.

Apri File

I file vengono decrittati in un’area temporanea sicura (~/.onecritto/temp/) e rimossi automaticamente alla chiusura o all'avvio dell'applicazione. Inoltre i file vengono puliti in modo sicuro da disco quando clicchi il pulsante Pulisci temp (icona gomma, in basso a destra nel tab File).

Esporta File

Esporta i file quando hai bisogno di un controllo manuale. I file esportati non sono crittografati. Assicurati di eliminarli in modo sicuro quando non sono più necessari.

Pulizia Manuale Cartella Temporanea

Il pulsante Pulisci temp (icona gomma, in basso a destra nel tab File) consente di svuotare la cartella temporanea in qualsiasi momento. Tutti i file temporanei vengono sovrascritti con dati casuali prima della cancellazione (secure wipe). Al termine viene mostrato un messaggio di conferma.

Consiglio: utilizza questa funzione dopo aver consultato file sensibili, per non lasciarli in chiaro su disco più del necessario.

Nota: i file aperti da altre applicazioni potrebbero non essere eliminati. Chiuderli prima e riprovare.

Contatore File Temporanei

Un'etichetta Files: N accanto al pulsante Pulisci temp mostra quanti file in chiaro sono attualmente nella cartella temporanea. Il contatore si aggiorna automaticamente quando ci si connette con ssh , all'apertura di un file o pulizia. Quando indica Files: 0, nessun file decifrato rimane su disco.

4. Note Sicure

Note crittografate archiviate in modo sicuro all'interno del vault.

Le note vengono memorizzate come normali voci del vault con la categoria Nota. Ogni voce dispone di un campo Note dedicato (multiriga, cifrato) che supporta contenuti lunghi. La ricerca globale filtra anche le note. Nessun testo in chiaro viene mai scritto su disco.

5. Password e Credenziali

Gestisci in modo sicuro credenziali e accessi.

Campi della Voce

Ogni voce contiene: Titolo (obbligatorio), URL, Username, Password, Note e Categoria (Password / Nota / Altro). Una barra di robustezza in tempo reale viene mostrata durante la digitazione della password. Data di creazione e data dell'ultimo cambio password vengono tracciate automaticamente.

Campi Protetti

I campi username, password e note utilizzano buffer di memoria sicuri char[] — mai Java String. I buffer vengono azzerati al blocco o alla modifica del campo.

Generatore di Password

Genera password robuste e copiale in sicurezza nei campi. Due modalità:

  • Forte — lunghezza configurabile (8–40), set di caratteri (maiuscole, minuscole, cifre, simboli), opzione per evitare caratteri ambigui (0/O, 1/l/I).
  • Mnemonica — password pronunciabili basate su sillabe (4–12 sillabe), con cifre e simboli opzionali.

Entrambe le modalità mostrano un punteggio di robustezza in tempo reale basato sullo stesso motore Sentinel.

Ricerca e Categorie

Un campo di ricerca globale filtra le voci istantaneamente per titolo, username, categoria e note. Tre categorie predefinite: Password, Nota, Altro.

Menu Contestuale — Copia Rapida

Clic destro su qualsiasi riga della tabella password per copiare Password o Username nella clipboard di sistema. Compare un countdown di 20 secondi in alto a sinistra, con colore progressivo (ciano > 10 s, arancione ≤ 10 s, rosso ≤ 5 s). Allo scadere, la clipboard viene svuotata automaticamente. La copia utilizza lo stesso pattern sicuro char[] di SecureTextField.

6. Sentinel — Monitor Salute del Vault

Introdotto nella versione 2.2.0, Sentinel è il motore di sicurezza integrato che analizza continuamente la salute del tuo vault.

Badge di Salute

Dopo aver aperto il vault, un badge di salute appare nella barra degli strumenti con un punteggio da 0 a 100. Il colore riflette il livello di sicurezza — dal verde (eccellente) al rosso (intervento critico necessario).

Dashboard Sentinel

Clicca sul badge per aprire la dashboard completa. Mostra il punteggio complessivo, una barra di progresso colorata e sei contatori: Critico, Debole, Discreto, Buono, Forte e Duplicati.

Punteggio Password

Ogni password viene valutata su una scala da 0 a 100 in base a entropia, lunghezza, varietà di caratteri e rilevamento di password comuni. Varianti leet-speak (es. p@$$w0rd), pattern da tastiera, ripetizioni e duplicati vengono penalizzati.

Piano di Rotazione

Una tabella prioritizzata elenca le voci che richiedono attenzione — dalle password comuni o criticamente deboli ai duplicati e alle password più vecchie di 90 giorni. Ogni riga mostra il titolo della voce e il motivo della rotazione.

Colonna Robustezza

La tabella delle password include una colonna Robustezza con una barra di progresso colorata — per una panoramica visiva istantanea. Le voci con password vuota vengono mostrate come “Vuoto” e sono escluse dall'analisi.

Password Coach

Seleziona una voce e apri il Password Coach per suggerimenti personalizzati ordinati per severità:

  • Critico — password comune, duplicata, trovata in breach, nessuna password impostata.
  • Avviso — pattern da tastiera, ripetizioni, bassa entropia, password più vecchia di 365 giorni.
  • Info — password più vecchia di 90 giorni, stima del tempo di crack offline, suggerimenti di miglioramento.
  • OK — nessun problema rilevato.

Il coach mostra inoltre il punteggio numerico, una barra di robustezza colorata e una stima del tempo di crack.

Aggiornamenti in Tempo Reale

Sentinel rianalizza automaticamente il vault ogni volta che apri, aggiungi, modifichi o elimini delle voci. Il generatore di password utilizza lo stesso motore di punteggio per garantire piena coerenza.

7. Breach Control — Scanner Password Violate

Introdotto nella versione 2.6.0, Breach Control verifica le tue password salvate contro i data breach noti — senza mai inviarle in rete.

Come Funziona

Breach Control interroga il database Have I Been Pwned tramite il protocollo k-anonymity. Vengono inviati solo i primi 5 caratteri dell'hash SHA-1 — la tua password non lascia mai il dispositivo.

Scansione Completa del Vault

Avvia una scansione di tutte le voci del vault con un solo click. Una barra di avanzamento mostra il progresso in tempo reale.

Risultati Chiari

Ogni voce viene contrassegnata con un'icona colorata: sicura (nessun breach trovato), esposta (con il numero di breach noti), oppure errore (problema di rete). Un riepilogo finale mostra lo stato complessivo del vault.

Cache di Sessione

I risultati vengono memorizzati nella sessione corrente per evitare richieste di rete ripetute in caso di nuova scansione.

8. SSH Connection Manager

Introdotto nella versione 2.7.0, l'SSH Connection Manager permette di salvare, organizzare e lanciare sessioni SSH utilizzando chiavi private conservate in modo sicuro all'interno del vault cifrato.

Prerequisito

Prima di creare una connessione SSH, aggiungi la tua chiave privata SSH (es. id_rsa, id_ed25519 o un file .pem) come file cifrato nel vault tramite File → Aggiungi.

Creare una Connessione

Apri il tab SSH e premi Aggiungi. Compila i campi: Nome connessione, Host, Porta (default 22), Username, e seleziona la Chiave SSH dal menu a tendina (elenca le chiavi già salvate nel vault). L'anteprima in basso mostra in tempo reale il comando SSH che verrà eseguito. Premi Salva.

Modificare o Eliminare

Doppio click sulla riga o pulsante Modifica per modificare una connessione. Pulsante Elimina per rimuoverla (con conferma).

Connettersi

Seleziona una connessione e premi Connetti. OneCritto esegue automaticamente: decifratura della chiave privata in un file temporaneo protetto, impostazione dei permessi restrittivi (richiesti da SSH), apertura del terminale nativo del sistema operativo con il comando SSH completo. Il terminale si apre con la sessione SSH già avviata.

Sicurezza

La chiave privata SSH viene decifrata solo al momento della connessione, in un file temporaneo nella cartella ~/.onecritto/temp/. Il file temporaneo viene sovrascritto con dati casuali e cancellato alla chiusura o all'apertura di OneCritto, oppure quando si preme il pulsante Pulisci temp (secure delete). La chiave non resta mai in chiaro su disco in modo permanente. Le connessioni SSH sono salvate all'interno del vault .onecritto, protette dalla stessa crittografia AES-256-GCM e derivazione chiave Argon2id.

9. Import CSV

Importa le password direttamente da file CSV esportati da tutti i principali password manager.

Riconoscimento automatico e matching intelligente

OneCritto riconosce i CSV di 10 piattaforme: Chrome / Edge, Firefox, Safari, Bitwarden, KeePass, LastPass, 1Password, Dashlane, NordPass e Proton Pass. I campi vengono mappati automaticamente con confidenza alta.

Per i formati sconosciuti, un algoritmo a 3 livelli identifica le colonne tramite corrispondenza per sinonimi, similarità Jaro-Winkler e analisi euristica dei valori (URL, email, stringhe ad alta entropia).

Anteprima e controllo

Un'anteprima a due pannelli mostra il mapping proposto con indicatori di confidenza e la lista delle entry pronte per l'import. Ogni colonna può essere riassegnata manualmente; ogni entry può essere inclusa o esclusa singolarmente. L'anteprima si aggiorna in tempo reale.

Come usarlo

  1. Esporta le password dal tuo attuale gestore in formato CSV.
  2. Clicca Import nella barra strumenti di OneCritto.
  3. Seleziona il file — la sorgente viene rilevata automaticamente.
  4. Verifica il mapping e scegli le entry da importare.
  5. Clicca Import — fatto.

Il CSV viene elaborato interamente sul tuo dispositivo. Dopo l'import, Sentinel valuta ogni nuova password e aggiorna il Vault Health Score. Le entry importate vengono cifrate con AES-256-GCM / Argon2id come tutte le altre.

10. Export su Android

Introdotto nella versione 2.10.0, l'export mobile invia le voci password selezionate all'app OneCritto per Android in un file cifrato che solo il tuo telefono può aprire — via cavo USB, senza cloud e senza account.

Requisiti

  • Desktop: OneCritto 2.10.0 (Windows o Linux).
  • Telefono: OneCritto Mobile 1.0.1 su Android 12 (API 31) o successivo — necessario per tenere la chiave privata nel chip di sicurezza.
  • Collegamento: un cavo USB, con il telefono in modalità Trasferimento file.
  • Rete: nessuna. L'app Android non richiede il permesso Internet.

Nota: il rilevamento automatico del telefono funziona su Windows e Linux. macOS non parla il protocollo MTP, quindi lì resta disponibile solo la modalità manuale (incollando a mano il codice di abbinamento).

Fase 1 — Abbinare il telefono (una tantum)

  1. Nell'app Android, genera ed esporta la chiave di abbinamento.
  2. Collega il telefono al computer con il cavo USB, in modalità Trasferimento file.
  3. Sul desktop premi Abbina dispositivo mobile: il computer trova il telefono e legge la chiave da solo, senza che tu debba cercare o copiare file.
  4. Le due app mostrano lo stesso codice di 8 cifre. Controlla che coincidano e conferma.

Nessun file di configurazione, nessun QR da inquadrare, nessun codice lungo da digitare. Colleghi il cavo, premi un pulsante, confronti 8 cifre.

Fase 2 — Esportare le password

  1. Sul desktop premi il pulsante di export mobile e scegli le voci da inviare.
  2. Salva il file cifrato (estensione .onecritto-vault) e copialo sul telefono via cavo.
  3. Nell'app Android importa il file: le voci compaiono nel vault del telefono.

Ripeti questa fase ogni volta che serve; l'abbinamento non va rifatto.

Perché il codice a 8 cifre conta

Confrontare il codice sui due schermi è ciò che impedisce a un attaccante di sostituire di nascosto la chiave del telefono con la propria. Richiede due secondi e non è facoltativo: se i due codici non coincidono, annulla l'abbinamento.

Il codice è un fingerprint derivato dallo SHA-256 della chiave pubblica, lo stesso principio del numeric comparison del Bluetooth.

Cosa viene esportato e cosa no

Esportato: le voci password — titolo, nome utente, indirizzo del sito, note e password.

Non esportato: i file cifrati custoditi nel vault e le connessioni SSH. Restano solo sul computer.

È un export manuale e unidirezionale (computer → telefono). Non è una sincronizzazione, non è automatico e non sostituisce il backup del vault.

Un telefono per vault

Un vault è abbinato a un telefono per volta. Abbinarne un altro sostituisce il precedente — l'app lo chiede e lo fa confermare esplicitamente.

Gli export già trasferiti restano leggibili sul telefono che li ha ricevuti.

Come è protetto il file

  • Il segreto non viaggia mai. In fase di abbinamento il telefono condivide solo una chiave pubblica: un dato che non serve a nulla se qualcuno lo intercetta. La chiave che apre i dati è generata dentro il chip di sicurezza di Android e non è estraibile.
  • Ogni export ha la sua chiave usa-e-getta. Anche se un singolo file esportato venisse compromesso, non aprirebbe né quelli precedenti né i successivi (forward secrecy).
  • Sigillato per un telefono solo. Un export destinato al tuo telefono non è apribile da nessun altro dispositivo, nemmeno da chi lo intercettasse durante la copia.
  • Crittografia standard. HPKE (RFC 9180), uno standard IETF pubblico, con la stessa cifratura AES-256-GCM già impiegata dal vault desktop.

Dettagli tecnici

  • Schema: HPKE (RFC 9180), base mode, sealed-box.
  • Suite: DHKEM(P-256, HKDF-SHA256) + HKDF-SHA256 + AES-256-GCM.
  • Chiave del destinatario: coppia EC P-256 generata nell' Android Keystore con PURPOSE_AGREE_KEY, non esportabile; il calcolo ECDH avviene dentro il Keystore (richiede Android 12 / API 31).
  • Chiave del mittente: effimera, rigenerata a ogni export.
  • Autenticazione del destinatario: il tag AEAD fallisce se il file non è destinato a quel telefono o è stato manomesso.
  • Dati di abbinamento: conservati dentro il vault cifrato, protetti dallo stesso HMAC che ne garantisce l'integrità.

11. Modello di Sicurezza

Principi fondamentali di sicurezza.

Crittografia

  • AES-256-GCM con IV random di 12 byte per ogni operazione
  • Derivazione chiave Argon2id (64 MB RAM, 3 iterazioni, 1 thread)
  • IV e salt per ogni record
  • Crittografia autenticata
  • Controllo integrità HMAC-SHA256 (anti-tampering)
  • Retrocompatibile: i vault V3 (PBKDF2) vengono letti e aggiornati automaticamente a V4 al salvataggio

Solo Locale

  • Nessuna sincronizzazione cloud
  • Nessun account
  • Nessuna telemetria

Protezione Runtime

  • Dati sensibili in buffer char[], mai String — azzerati quando non più necessari
  • Pulizia automatica clipboard dopo 20 secondi
  • File temporanei sovrascritti con dati casuali prima della cancellazione (secure wipe)
  • Permessi file: solo proprietario (chmod 600 su Linux/macOS, ACL su Windows NTFS)

Blocco Automatico della Sessione

Blocco automatico dopo 3 minuti di inattività con un countdown visivo (il colore cambia da bianco → arancione → rosso negli ultimi secondi). Usa Ctrl + L per bloccare manualmente da qualsiasi schermata. Le chiavi master vengono cancellate dalla RAM durante il blocco.