diff options
| author | Danilo M. <danix@danix.xyz> | 2026-11-05 10:22:12 +0100 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-11-05 10:22:12 +0100 |
| commit | 395eed25a9d879391558026bb90cd3acb9afdacf (patch) | |
| tree | 70e33dcdcca31fc47d595cd339778ebfa09ce6df /content/it/hardenedpass/getting-started/concepts | |
| parent | a5761e8d7875357d0dcc52a5cc31f06f866d791c (diff) | |
| download | danixxyz-395eed25a9d879391558026bb90cd3acb9afdacf.tar.gz danixxyz-395eed25a9d879391558026bb90cd3acb9afdacf.zip | |
content: write HardenedPass getting-started pages
Concepts, install, creating a store from zero and connecting the app, in
both languages, with screenshots from the test store. Still drafts.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'content/it/hardenedpass/getting-started/concepts')
| -rw-r--r-- | content/it/hardenedpass/getting-started/concepts/index.md | 70 |
1 files changed, 66 insertions, 4 deletions
diff --git a/content/it/hardenedpass/getting-started/concepts/index.md b/content/it/hardenedpass/getting-started/concepts/index.md index dbd6fe3..34334ab 100644 --- a/content/it/hardenedpass/getting-started/concepts/index.md +++ b/content/it/hardenedpass/getting-started/concepts/index.md @@ -1,13 +1,75 @@ +++ title = "Concetti" date = 2026-11-05T00:00:00Z -description = "" +description = "Le tre cose su cui si basa HardenedPass, in parole semplici: pass salva le password come file, OpenPGP le cifra, git le sincronizza." weight = 10 draft = true +++ -Placeholder. +HardenedPass si basa su tre strumenti. Non serve padroneggiarli, ma sapere cosa fa +ciascuno rende facili da seguire tutte le altre pagine. -## First heading +## pass: un file per ogni password -Text. +[pass](https://www.passwordstore.org/) è un gestore di password per sistemi Unix. Non +ha un database: ogni password è un piccolo file cifrato, e le cartelle le raggruppano. +Questo albero di cartelle si chiama **archivio**. + +``` +store/ +├── .gpg-id +├── example.org.gpg +├── otp/ +│ └── example.com.gpg +└── work/ + └── mail.example.org.gpg +``` + +Una volta decifrata, una voce è testo semplice. La prima riga è la password, tutto +quello che sta sotto sono informazioni aggiuntive: + +``` +hunter2 +username: alice +url: https://example.org +``` + +HardenedPass legge queste righe e le mostra come campi separati. Qualsiasi programma +che capisce `pass` può aprire lo stesso archivio, quindi le tue password non restano +mai bloccate dentro questa app. + +## OpenPGP: il lucchetto su ogni file + +Ogni voce è cifrata con [OpenPGP](https://www.gnupg.org/), usando una **coppia di +chiavi**: + +- La **chiave pubblica** chiude i file. Non è segreta. +- La **chiave privata** li apre. Non lascia mai i tuoi dispositivi. +- La **passphrase** protegge la chiave privata: una copia del file della chiave, da + sola, non serve a nulla a chi la trova. + +Il file `.gpg-id`, in cima all'archivio, dice per quali chiavi sono cifrate le voci. + +{{< callout type="danger" title="Fai un backup della chiave privata" >}} +Se perdi la chiave privata o dimentichi la sua passphrase, nessuno potrà più decifrare +il tuo archivio. Non esiste un reset. Tienine una copia in un posto sicuro e offline. +{{< /callout >}} + +## git: sincronizzazione e cronologia + +[Git](https://git-scm.com/) registra ogni modifica all'archivio e la copia tra i +dispositivi attraverso un **remote**, cioè un repository su un server. Modifichi una +voce sul telefono, l'app registra la modifica e la invia al remote, e gli altri +dispositivi la scaricano da lì. Le vecchie versioni restano nella cronologia, quindi un +errore si può annullare. + +Il server contiene solo file cifrati, ma ne può leggere i **nomi**. Chi lo gestisce può +vedere che hai una voce chiamata `example.org`. Usa un repository privato, su un server +di cui ti fidi. + +## Come si incastra il tutto + +1. Su un computer crei una coppia di chiavi, un archivio e un remote. +2. Sul telefono, HardenedPass clona l'archivio dal remote. +3. Importi la chiave privata nell'app. +4. L'app decifra le voci quando le apri e sincronizza le modifiche con git. |
