+++
title = "Risoluzione dei problemi"
date = 2026-11-05T00:00:00Z
description = "Gli errori più comuni di HardenedPass, cosa significano e come risolverli: passphrase, chiavi, SSH, push rifiutato, detached HEAD, autofill."
weight = 110
draft = false
+++

## Chiavi e passphrase

**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.

**`Importazione della chiave PGP non riuscita`.** 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.

**`Trovato .gpg-id, ma contiene un ID chiave, un'impronta o un ID utente non valido`.** Il file
`.gpg-id` contiene qualcosa che l'app non capisce. Controllalo su un computer: un ID chiave,
fingerprint o indirizzo per riga.

## Connessione

**`L'URL del repository non è valido`.** Guarda le forme di indirizzo in
[Collega l'app]({{< relref "/hardenedpass/getting-started/connect" >}}).

**`Password errata` o `Frase segreta errata`.** 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.

**`Il file selezionato non sembra essere una chiave privata SSH`.** 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 rifiutato dal remote: esegui un pull prima di riprovare`.** Il server ha commit che tu
non hai. Usa **Sincronizza repository**, che fa pull e poi push.

**`Pull non riuscito, sei in detached HEAD`.** Un conflitto ha fermato il rebase. I passi
sono in [Sincronizzazione]({{< relref "/hardenedpass/using/sync" >}}).

**`Merge non riuscito, il repository è in conflitto`.** 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.

**`Il repository deve essere clonato prima di sincronizzare le modifiche`.** 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" >}}).

**Un'app dice che non ha trovato nessun gestore di password.** Usa il gestore di password di
Android, non la compilazione automatica. Attiva HardenedPass in **Password, passkey e
account**, come in [Autofill]({{< relref "/hardenedpass/using/autofill" >}}). Serve
Android 14 o successivo e HardenedPass 0.3.4 o successivo.

**Viene compilata solo la password.** È il livello di supporto del browser, come per Vanadium.

**`Quest'app non è attualmente supportata`.** 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 (la trovi in **Informazioni**) e cosa hai fatto. Non incollare mai
password, chiavi o nomi di voci reali.

Un log aiuta molto:

1. In **Impostazioni**, poi **Varie**, attiva **Registrazione di debug** e riavvia l'app.
2. Ripeti l'operazione che non funziona.
3. Tocca **Esporta log** nello stesso punto e scegli dove salvare il file. Fallo subito, e
   prima di riavviare il telefono: Android conserva solo le righe recenti.
4. Spegni di nuovo **Registrazione di debug**.
5. Leggi il file e togli ciò che non vuoi rendere pubblico, poi allegalo alla segnalazione.

Il file può mostrare nomi di voci, siti, app e il tuo server git. I crash sono inclusi
anche con **Registrazione di debug** spenta.