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:

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.

Le credenziali restano cifrate e vengono usate solo per le operazioni richieste da te: emettere, annullare o rendere uno scontrino, verificare il collegamento e consultare i tuoi documenti sul portale, dall'app oppure dal gestionale a cui hai dato una tua chiave API. Non vengono condivise con terzi e nessun processo automatico le usa per altro.

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 delle operazioni con l'Agenzia richieste da te, dall'app o tramite una tua chiave API.
  • 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 password o PIN Fisconline

Se cambi la password sul portale dell'Agenzia delle Entrate (lo chiede ogni 90 giorni) o ottieni un nuovo PIN, 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. Tocca l'icona a forma di matita accanto al titolo della card (Modifica credenziali AdE).
  3. Reinserisci codice fiscale, password e PIN, con la password o il PIN nuovi (il modulo si apre vuoto e li chiede tutti e tre), salva e poi verifica di nuovo la connessione.

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 tocca l'icona a forma di matita (Modifica credenziali AdE): i nuovi valori sostituiscono quelli precedenti, che vengono cifrati di nuovo e sovrascritti nel database.

Per revocare completamente l'accesso e cancellare i dati cifrati, puoi eliminare l'account ScontrinoZero da Impostazioni → Altre 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.

Oggi non esiste un pulsante dedicato per rimuovere solo le credenziali AdE lasciando attivo l'account: le due strade disponibili sono sovrascriverle toccando l'icona a forma di matita (Modifica credenziali AdE) oppure eliminare l'account.

Domande frequenti

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

No. Il codice accede solo alle funzioni del Documento Commerciale Online (emissione, annullo, reso e ricerca dei tuoi documenti commerciali), ai dati anagrafici della tua partita IVA e, se la password Fisconline è scaduta, al cambio password che avvii tu dall'app. 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 la password 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

Quando citiamo una norma indichiamo estremo e data, così puoi verificarla alla fonte. Informazione divulgativa: non sostituisce la consulenza del commercialista, e per situazioni specifiche vanno sempre verificati la normativa aggiornata e il tuo codice ATECO. Hai trovato un'imprecisione? Segnalacela a [email protected].

Hai trovato un errore in questa guida? Segnalacelo.