+++
title = "Collega l'app"
date = 2026-11-05T00:00:00Z
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 = false
+++

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" >}}).

## Clona l'archivio

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 altrove, su un computer o in Termux, e senza un remote nulla ti
protegge se perdi il telefono.

Se vuoi sincronizzare, clona: un archivio creato così può fare il push su un server aggiunto
in seguito, ma per ora il pull fallisce.