# La cronologia dei tuoi avvisi merita più di una password.

> Proteggi il tuo account Pocket Alert con l'autenticazione a due fattori TOTP e i codici di recupero monouso. Attiva su web e mobile, mentre chiavi API e script continuano a funzionare.

<!-- source: https://pocketalert.app/it/features/two-factor-auth -->

Ultimo aggiornamento: 2026-08-11

Autenticazione a due fattori TOTP con codici di recupero monouso, applicata sulla dashboard e nell'app. Le tue chiavi API e i tuoi script continuano a funzionare senza modifiche.

Documentazione: https://info.pocketalert.app/features/two-factor-auth.html

## Configurazione in due minuti

1. **Scansiona il codice** — Apri Account → Sicurezza e scansiona il codice QR con la tua app di autenticazione.
2. **Conferma una volta** — Inserisci un codice a sei cifre per confermare. La 2FA si attiva solo dopo un codice corretto.
3. **Conserva i backup** — Salva i codici di recupero in un posto diverso dal telefono su cui gira l'app di autenticazione.

## Una 2FA vera, senza rompere i tuoi script

La cronologia delle tue notifiche è un registro di ciò che fanno i tuoi sistemi e di quando si guastano. Vale più di una password.

- **Funziona con qualsiasi app di autenticazione** — TOTP standard. Scansiona il codice QR con l'app di autenticazione che già usi e conferma un codice per attivarla.
- **Copre web e mobile** — Applicata sia sulla dashboard web sia sull'app mobile dopo il login principale, quindi non c'è nessuna scorciatoia.
- **Codici di recupero affidabili** — I codici di recupero monouso vengono emessi in fase di configurazione e consumati in modo atomico, così due login paralleli non possono usare lo stesso codice.
- **L'automazione resta invariata** — Le chiavi API non vengono mai sottoposte a verifica. La tua automazione continua a funzionare esattamente come il giorno prima che attivassi la 2FA.
- **Sicuro da riconfigurare** — Una nuova registrazione rimane in uno slot in attesa finché non la confermi, quindi una configurazione interrotta non può bloccarti fuori dal tuo account.
- **Protezione dagli attacchi brute-force** — Cinque codici errati bloccano l'account per quindici minuti e ricevi un'email ogni volta che la 2FA viene attivata o disattivata.

## Come attivarla

    
Apri Account → Sicurezza e avvia la configurazione. Ricevi un codice QR e un segreto da scansionare con qualsiasi app di autenticazione TOTP, poi confermi un codice a sei cifre. Solo dopo un codice corretto la 2FA si attiva davvero, e solo allora vengono mostrati i codici di recupero. Salvali in un posto diverso dal telefono su cui gira l'app di autenticazione.

    
## Cosa cambia al login

    
Sulla dashboard e nell'app, una password corretta ora porta a una richiesta del codice invece di farti entrare direttamente nel tuo account. Sotto il cofano, l'endpoint di login restituisce una sfida di breve durata invece di un token, e una seconda chiamata scambia quella sfida insieme al tuo codice per la sessione vera. Le sfide scadono dopo cinque minuti.

    
Il campo del codice accetta sia un codice TOTP a sei cifre sia uno dei tuoi codici di recupero, quindi perdere il telefono è un fastidio e non un blocco.

    
## Cosa non cambia

    
Le chiavi API non rientrano in questo. Si autenticano con l'header `Token` e non vengono mai sottoposte a verifica, il che significa che ogni script, cron job e pipeline CI che hai continua a inviare avvisi esattamente come prima. È anche il motivo per emettere una chiave separata per ogni servizio: revocarne una non tocca le altre.

## FAQ

### Quali app di autenticazione funzionano?

Qualsiasi app TOTP standard: Google Authenticator, 1Password, Authy, Bitwarden e qualsiasi altra che scansioni un codice QR e generi codici a sei cifre.

### La 2FA interromperà i miei script e le mie chiavi API?

No. La 2FA si applica ai login interattivi sulla dashboard e nell'app mobile. Le chiavi API si autenticano con l'header Token e non vengono mai sottoposte a verifica, quindi i tuoi cron job, le pipeline CI e gli hook di monitoraggio continuano a inviare avvisi senza modifiche.

### Cosa succede se perdo il telefono?

Usa uno dei tuoi codici di recupero al posto del codice a sei cifre. Ognuno funziona una sola volta. Puoi generarne un nuovo set in qualsiasi momento da Account → Sicurezza, il che invalida quelli vecchi.

### Cosa succede se avvio la configurazione e poi la abbandono?

Non tocca la 2FA che hai già. Il nuovo segreto rimane in uno slot in attesa e sostituisce quello attivo solo dopo che confermi un codice, quindi chiudere la scheda a metà non ti bloccherà fuori.

### In che modo la 2FA cambia il login via API?

Il login restituisce una sfida di breve durata invece di un token, e scambi quella sfida insieme a un codice con il JWT vero. Le sfide durano cinque minuti. Il campo del codice accetta un codice TOTP o un codice di recupero.

### Cosa impedisce a qualcuno di indovinare il mio codice?

Cinque codici errati bloccano l'account per quindici minuti e i tentativi successivi restituiscono 429. Ricevi anche un'email ogni volta che la 2FA viene attivata o disattivata: se ne arriva una e non sei stato tu, cambia immediatamente la password.
