Sicurezza e privacy: come proteggiamo le tue credenziali

Fiscalizzazione

Sappiamo che chiederti le credenziali AdE — Fisconline o CIE — è una richiesta importante. Questa pagina spiega nel dettaglio come vengono archiviate, chi può accedervi e come puoi revocare il consenso in qualsiasi momento.

Ultimo aggiornamento: aprile 2026

Schermata Impostazioni con la sezione delle credenziali AdE
Le credenziali AdE si gestiscono dalle Impostazioni.

Perché ScontrinoZero ha bisogno delle tue credenziali AdE

L'Agenzia delle Entrate non offre un'API pubblica per la trasmissione dei corrispettivi. Il portale Fatture e Corrispettivi è un'interfaccia web accessibile esclusivamente con le credenziali del titolare dell'attività.

Per trasmettere i tuoi scontrini in modo automatico, ScontrinoZero replica le chiamate HTTP che il browser effettua quando usi il portale AdE manualmente. Questo richiede di conservare le credenziali in modo sicuro per poterle usare al momento dell'invio.

Questa pratica è esplicitamente contemplata dall'Interpello AdE n. 956-1523/2020, che ammette i "velocizzatori" di processo nel rispetto della normativa.

Cifratura AES-256-GCM: cosa significa in pratica

Le tue credenziali AdE — Fisconline (codice fiscale, password e PIN) oppure l'email e la password dell'app CIE ID se ti colleghi con la CIE — vengono cifrate con AES-256-GCM prima di essere salvate nel database. Questo è lo stesso standard usato dalle banche e dai servizi di pagamento più sicuri al mondo.

  • AES-256: chiave di cifratura a 256 bit (32 byte). Con la potenza di calcolo attuale, un attacco a forza bruta richiederebbe miliardi di anni.
  • GCM (Galois/Counter Mode): modalità autenticata che garantisce sia la riservatezza dei dati sia la loro integrità. Qualsiasi modifica non autorizzata al dato cifrato viene rilevata e rifiutata.
  • IV casuale per ogni cifratura: ogni volta che le credenziali vengono cifrate, viene generato un vettore di inizializzazione (IV) unico. Lo stesso PIN cifrato due volte produce due testi cifrati completamente diversi.

Cifratura at-rest: il team non può leggere le tue credenziali

Le credenziali non sono mai visibili in chiaro nel database, nemmeno agli amministratori di ScontrinoZero. Ecco perché:

  • Nel database è salvato solo il testo cifrato: una stringa binaria incomprensibile senza la chiave di decifratura.
  • La chiave di decifraturaè un'env var del server, non salvata nel database. Anche accedendo al database, senza la chiave i dati sono inutilizzabili.
  • Le credenziali vengono decifrate solo in memoria RAM al momento esatto in cui serve fare la chiamata al portale AdE, e immediatamente scartate.
  • I log applicativi sono configurati per non registrare mai il valore delle credenziali. Anche in caso di bug o eccezione, il PIN non finisce nei log.

Dove sono fisicamente archiviate

I dati cifrati sono salvati nel database PostgreSQL su Supabase Cloud (datacenter in Europa, certificazioni ISO 27001, SOC 2 Type II). Il server applicativo gira su una VPS in un datacenter europeo.

ScontrinoZero è un progetto open source (licenza O'Saasy). Puoi verificare personalmente il codice che gestisce le credenziali nel repository GitHub.

Chi può accedere alle tue credenziali

  • Tu — puoi aggiornare le credenziali in qualsiasi momento da Impostazioni → Credenziali AdE.
  • Il server applicativo— usa le credenziali decifrate solo al momento dell'invio degli scontrini, operazione che avviene solo su tua esplicita richiesta.
  • Nessun altro — il team ScontrinoZero, i database administrator, e qualsiasi altro sistema non hanno accesso al testo in chiaro delle credenziali.

Cosa succede se cambi il PIN Fisconline

Se cambi il PIN sul portale dell'Agenzia delle Entrate, le credenziali salvate su ScontrinoZero diventano non valide: il sistema ti mostrerà un errore di connessione AdE la prossima volta che emetti uno scontrino.

Per aggiornare le credenziali:

  1. Vai su Impostazioni → Credenziali AdE.
  2. Clicca su Modifica credenziali.
  3. Inserisci il nuovo PIN e salva.

Gli scontrini emessi prima dell'aggiornamento e rifiutati dall'AdE per credenziali scadute vanno riemessi manualmente dopo aver salvato le nuove credenziali: al momento non è prevista una ritrasmissione automatica.

Come revocare l'accesso e cancellare le credenziali

Per modificare le credenziali AdE salvate vai su Impostazioni → Credenziali AdE e clicca Modifica credenziali: i nuovi valori sostituiscono quelli precedenti, che vengono cifrati di nuovo e sovrascritti nel database.

Per revocare completamentel'accesso e cancellare i dati cifrati, puoi eliminare l'account ScontrinoZero da Impostazioni → Zona pericolosa → Elimina account: la cancellazione è immediata e include credenziali AdE, anagrafica, scontrini e catalogo (cascade delete sul profilo). Il diritto alla cancellazione è garantito dal GDPR art. 17.

Un pulsante dedicato per rimuovere solo le credenziali AdE senza eliminare l'account è in roadmap.

Domande frequenti

ScontrinoZero può usare le mie credenziali per accedere ad altre sezioni del portale AdE?

No. Il codice accede esclusivamente alle sezioni necessarie per emettere e annullare documenti commerciali. Non vengono effettuate operazioni su fatture, dichiarazioni, o altri servizi AdE.

Cosa succede se ScontrinoZero subisce un data breach?

In caso di accesso non autorizzato al database, un attaccante otterrebbe solo il testo cifrato, inutilizzabile senza la chiave di decifratura (che non è nel database). Come misura aggiuntiva, ti consigliamo di cambiare il PIN Fisconline se ricevi notifiche di sicurezza da parte nostra.

Posso usare ScontrinoZero in modalità self-hosted per tenere le credenziali sul mio server?

Sì. ScontrinoZero è open source e self-hostable: installa l'applicazione sul tuo server e le credenziali non usciranno mai dalla tua infrastruttura.

Articoli correlati

Pronto a iniziare?

30 giorni di prova gratuita, senza carta di credito.

Crea l'account

Hai trovato un errore in questa guida? Segnalacelo.