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>

6 files changed, 79 insertions, 4 deletions

diff --git a/content/it/hardenedpass/getting-started/connect/index.md b/content/it/hardenedpass/getting-started/connect/index.md
index d6006ca..d7c6e35 100644
--- a/content/it/hardenedpass/getting-started/connect/index.md
+++ b/content/it/hardenedpass/getting-started/connect/index.md
@@ -1,13 +1,88 @@
 +++
 title = "Collega l'app"
 date = 2026-11-05T00:00:00Z
-description = ""
+description = "Come collegare HardenedPass al tuo archivio: clona il repository, configura una chiave SSH o una password, importa la tua chiave privata OpenPGP."
 weight = 40
 draft = true
 +++
 
-Placeholder.
+Ti servono l'indirizzo del repository e il file con la tua chiave privata. Se non hai né
+l'uno né l'altro, parti da [Crea un archivio]({{< relref "/hardenedpass/getting-started/create-store" >}}).
 
-## First heading
+## Clona l'archivio
 
-Text.
+Apri l'app e tocca **Clona repo remoto**.
+
+{{< image src="welcome.png" alt="Schermata di benvenuto con i pulsanti Clona repo remoto, Crea repo locale e Impostazioni." class="max-w-sm mx-auto rounded-lg border border-border" />}}
+
+Scrivi l'indirizzo del repository in **URL del repository** e scegli come accedere in
+**Modalità di Autenticazione**.
+
+{{< image src="repository.png" alt="Schermata Informazioni del repository con l'URL compilato e Chiave SSH selezionata come modalità di autenticazione." class="max-w-sm mx-auto rounded-lg border border-border" />}}
+
+Funzionano tutte queste forme di indirizzo:
+
+| Forma | Esempio |
+|---|---|
+| SSH, breve | `git@git.example.org:store.git` |
+| SSH, con porta | `ssh://git@git.example.org:2222/srv/git/store.git` |
+| HTTPS | `https://git.example.org/you/store.git` |
+
+L'app ti avvisa degli indirizzi che non funzionerebbero bene: una porta personalizzata
+senza `ssh://`, una porta su un indirizzo HTTPS, che non è supportata, e `git://`, che
+non ha cifratura.
+
+### Con una chiave SSH
+
+Tocca **Gestisci** accanto alla riga Chiave SSH.
+
+{{< image src="ssh-key.png" alt="Schermata Chiave SSH con i pulsanti Importa chiave SSH e Genera coppia di chiavi SSH." class="max-w-sm mx-auto rounded-lg border border-border" />}}
+
+- **Importa chiave SSH** legge da un file una chiave privata che hai già.
+- **Genera coppia di chiavi SSH** crea una nuova chiave sul telefono. Ed25519 è la
+  scelta migliore, a meno che il server non sia vecchio. **Proteggi con credenziali di
+  blocco schermo** fa chiedere all'app il blocco schermo ogni volta che usa la chiave.
+
+Dopo la generazione l'app mostra la chiave pubblica. Aggiungila al tuo server git, nello
+stesso punto in cui aggiungeresti la chiave di un computer. Poi torna indietro e tocca
+**Clona**.
+
+### Con una password
+
+Scegli **Password** e tocca **Clona**. L'app chiede la password quando si connette, e
+**Ricorda password** la salva cifrata sul telefono. Molti servizi di hosting vogliono qui
+un token di accesso invece della password dell'account.
+
+### L'identità del server
+
+Alla prima connessione SSH l'app salva la chiave host del server senza chiedere nulla, e
+la controlla a ogni connessione successiva. Se la chiave cambia, la sincronizzazione si
+ferma con un errore. Se sai perché è cambiata, tocca **Cancella la chiave host salvata**
+nella schermata del repository. Se non lo sai, fermati e scoprilo prima: qualcuno
+potrebbe spacciarsi per il tuo server.
+
+## Importa la chiave privata
+
+Finita la clonazione, l'app mostra per quale chiave è cifrato l'archivio, sotto
+**Destinatari dell'archivio**.
+
+{{< image src="pgp-import.png" alt="Schermata Importa chiave PGP con l'ID della chiave destinataria dell'archivio e il pulsante Importa chiave PGP." class="max-w-sm mx-auto rounded-lg border border-border" />}}
+
+Tocca **Importa chiave PGP** e scegli il file della chiave. L'app mostra l'ID della
+chiave importata: controlla che corrisponda. Puoi toccare **Più tardi** per saltare il
+passo, ma nessuna voce si potrà aprire finché non importi la chiave giusta.
+
+Si apre l'elenco delle voci, e hai finito.
+
+{{< image src="store-list.png" alt="L'elenco dell'archivio, con le cartelle otp e work e la voce example.org." class="max-w-sm mx-auto rounded-lg border border-border" />}}
+
+Ora cancella il file della chiave dalla memoria del telefono, come spiegato in
+[Crea un archivio]({{< relref "/hardenedpass/getting-started/create-store" >}}).
+La prima volta che apri una voce, l'app chiede la passphrase della chiave.
+
+## Un archivio senza server
+
+**Crea repo locale** crea un archivio che vive solo sul telefono. Importa la chiave
+privata, poi toccala nell'elenco per creare l'archivio per quella chiave. Ti serve
+comunque una chiave generata su un computer, e senza un remote nulla ti protegge se perdi
+il telefono.
diff --git a/content/it/hardenedpass/getting-started/connect/pgp-import.png b/content/it/hardenedpass/getting-started/connect/pgp-import.png
new file mode 100644
index 0000000..976bfda
--- /dev/null
+++ b/content/it/hardenedpass/getting-started/connect/pgp-import.png
diff --git a/content/it/hardenedpass/getting-started/connect/repository.png b/content/it/hardenedpass/getting-started/connect/repository.png
new file mode 100644
index 0000000..d60e51f
--- /dev/null
+++ b/content/it/hardenedpass/getting-started/connect/repository.png
diff --git a/content/it/hardenedpass/getting-started/connect/ssh-key.png b/content/it/hardenedpass/getting-started/connect/ssh-key.png
new file mode 100644
index 0000000..0baf468
--- /dev/null
+++ b/content/it/hardenedpass/getting-started/connect/ssh-key.png
diff --git a/content/it/hardenedpass/getting-started/connect/store-list.png b/content/it/hardenedpass/getting-started/connect/store-list.png
new file mode 100644
index 0000000..006c288
--- /dev/null
+++ b/content/it/hardenedpass/getting-started/connect/store-list.png
diff --git a/content/it/hardenedpass/getting-started/connect/welcome.png b/content/it/hardenedpass/getting-started/connect/welcome.png
new file mode 100644
index 0000000..c30fb12
--- /dev/null
+++ b/content/it/hardenedpass/getting-started/connect/welcome.png