content: write HardenedPass reference and landing pages

Every setting, the security model, troubleshooting and the landing page,
in both languages. Also adds the Firefox save prompt tip and full menu
paths on the sync and autofill pages. Still drafts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 80 insertions, 4 deletions

diff --git a/content/it/hardenedpass/reference/troubleshooting/index.md b/content/it/hardenedpass/reference/troubleshooting/index.md
index c87671c..43253b9 100644
--- a/content/it/hardenedpass/reference/troubleshooting/index.md
+++ b/content/it/hardenedpass/reference/troubleshooting/index.md
@@ -1,13 +1,89 @@
 +++
 title = "Risoluzione dei problemi"
 date = 2026-11-05T00:00:00Z
-description = ""
+description = "Gli errori più comuni di HardenedPass, cosa significano e come risolverli: passphrase, chiavi, SSH, push rifiutato, detached HEAD, autofill."
 weight = 110
 draft = true
 +++
 
-Placeholder.
+I messaggi qui sotto sono riportati in inglese, come nel codice dell'app. Con l'app in
+italiano ne vedi la traduzione.
 
-## First heading
+## Chiavi e passphrase
 
-Text.
+**L'app chiede di nuovo la passphrase e dice che è sbagliata.** La passphrase non
+corrisponde alla chiave privata. Se hai cambiato la passphrase della chiave su un computer,
+l'app vuole quella nuova. Con la memorizzazione attiva, la richiede e sostituisce il vecchio
+valore.
+
+**`Failed to import PGP key`.** Il file non è una chiave che l'app può usare. Le chiavi senza
+una sottochiave di cifratura vengono rifiutate, perché non potrebbero decifrare nulla.
+Controlla di aver esportato la chiave **privata**, con `gpg --armor --export-secret-keys`.
+
+**Una voce non si apre e nessuna chiave corrisponde.** L'archivio è cifrato per una chiave
+non importata. Confronta **Destinatari dell'archivio** nella schermata di importazione, o il
+file `.gpg-id`, con le chiavi in **Gestione chiavi**. Una chiave pubblica da sola non può
+decifrare: importa quella privata.
+
+**La chiave sta su una smartcard.** Per una chiave così GnuPG esporta uno stub, senza alcun
+materiale segreto. Con quello l'app non può decifrare: serve la vera chiave privata.
+
+**`Found .gpg-id, but it contains an invalid key ID, fingerprint or user ID`.** Il file
+`.gpg-id` contiene qualcosa che l'app non capisce. Controllalo su un computer: un ID chiave,
+fingerprint o indirizzo per riga.
+
+## Connessione
+
+**`The provided repository URL is not valid`.** Guarda le forme di indirizzo in
+[Collega l'app]({{< relref "/hardenedpass/getting-started/connect" >}}).
+
+**`Wrong password` o `Wrong passphrase`.** Riguarda la password del repository o la passphrase
+di una chiave SSH. Molti servizi di hosting vogliono un token di accesso invece della password
+dell'account.
+
+**`Selected file does not appear to be an SSH private key`.** Hai scelto la chiave pubblica,
+o un file in un altro formato. Scegli il file senza `.pub`.
+
+**La sincronizzazione fallisce dopo che il server è stato reinstallato o spostato.** La sua
+chiave host è cambiata. Se sei sicuro del motivo, usa **Cancella la chiave host salvata**
+nella schermata del repository, in **Modifica impostazioni del server di Git**. Se non lo sei,
+consideralo un attacco finché non ne sai di più.
+
+**L'accesso SSH viene rifiutato.** Controlla che la chiave pubblica sia sul server, per
+l'account giusto. **Visualizza la chiave SSH pubblica generata** la mostra per una chiave
+creata sul telefono.
+
+## Sincronizzazione
+
+**`Push was rejected by remote, run pull before pushing again`.** Il server ha commit che tu
+non hai. Usa **Sincronizza repository**, che fa pull e poi push.
+
+**`Pull has failed, you're in a detached head`.** Un conflitto ha fermato il rebase. I passi
+sono in [Sincronizzazione]({{< relref "/hardenedpass/using/sync" >}}).
+
+**`Merge has failed, you're in a conflicting state`.** Lo stesso conflitto, con **Rebase al
+pull** spento. La via d'uscita è l'hard reset descritto in
+[Sincronizzazione]({{< relref "/hardenedpass/using/sync" >}}), dopo aver salvato ciò che ti
+serve.
+
+**`The repository must be cloned before syncing changes`.** L'archivio sul telefono non ha un
+remote. Impostane uno in **Modifica impostazioni del server di Git** e clonalo.
+
+## Autofill
+
+**Non appare nessun suggerimento.** Controlla che HardenedPass sia il servizio di compilazione
+automatica scelto nelle impostazioni di Android, e che il browser sia nell'elenco in
+[Autofill]({{< relref "/hardenedpass/using/autofill" >}}).
+
+**Viene compilata solo la password.** È il livello di supporto del browser, come per Vanadium.
+
+**`This app is currently not supported`.** Da lì l'app non può salvare. Puoi comunque
+aggiungere la voce a mano.
+
+**Non succede nulla dopo aver toccato Salva.** Android 14 e successivi trattengono le finestre
+in background, e l'app ha un rimedio: aggiorna all'ultima versione.
+
+## Ancora bloccato?
+
+Apri una segnalazione sul [tracker](https://github.com/danixland/HardenedPass/issues). Indica
+quale versione usi e cosa hai fatto. Non incollare mai password, chiavi o nomi di voci reali.