Sicurezza

Sicurezza in Flutter: token, storage e protezione dati

Guida pratica alla sicurezza delle app Flutter: gestione di token e sessioni, secure storage, network security e protezione dei dati sensibili.

Fabrizio Billeci
Fabrizio Billeci
15 febbraio 2026 · 5 min di lettura
Sicurezza in Flutter: token, storage e protezione dati

Introduzione

Le app mobile gestiscono dati sensibili: token di autenticazione, credenziali, informazioni personali. Esporli significa rischio di furto, man-in-the-middle, reverse engineering. In Flutter la sicurezza richiede attenzione a storage, rete e gestione delle sessioni.

Questo articolo copre la gestione di token e sessioni, secure storage, network security e la protezione dei dati sensibili in modo professionale.

Gestione token e sessioni

Access token e refresh token

L'approccio standard usa access token (corta vita, es. 15 minuti) e refresh token (lunga vita, es. 7 giorni). L'access token viene inviato in ogni richiesta API; quando scade, si usa il refresh token per ottenere una nuova coppia senza far rifare login all'utente.

Interceptor con Dio

Con Dio puoi usare un Interceptor che aggiunge automaticamente l'header Authorization: Bearer <token> a ogni richiesta. In caso di 401, l'interceptor può chiamare l'endpoint di refresh, ottenere un nuovo access token, salvarlo in secure storage e ritentare la richiesta originale.

Pattern "One Future" per refresh concorrenti

Se più richieste ricevono 401 contemporaneamente, evitare di lanciare più refresh in parallelo. Usare un singolo Future condiviso: la prima richiesta avvia il refresh, le altre attendono lo stesso Future. Così si fa una sola chiamata di refresh e tutte le richieste vengono ritentate con il nuovo token.

Logout

Al logout eliminare sia access che refresh token dallo storage, invalidare la sessione lato server (se supportato) e reindirizzare al login.

Secure storage

Perché non SharedPreferences

SharedPreferences salva in chiaro: chi ha accesso al dispositivo (o a un backup) può leggere i dati. Per token, password e dati sensibili va usato flutter_secure_storage.

flutter_secure_storage

Package che usa le API di sicurezza native: Keychain su iOS, EncryptedSharedPreferences (AES + MasterKey) su Android. I dati sono crittografati; la lettura/scrittura è trasparente. Supporta anche macOS, Windows e Linux; su web funziona solo su HTTPS o localhost.

final storage = FlutterSecureStorage();
await storage.write(key: 'accessToken', value: token);
String? token = await storage.read(key: 'accessToken');
await storage.delete(key: 'accessToken');

Opzioni Android (aOptions)

Su Android puoi configurare AndroidOptions: encryptedSharedPreferences per usare EncryptedSharedPreferences, resetOnError per cancellare i dati in caso di errore di decrittazione (utile dopo aggiornamento OS che invalida le chiavi).

Opzioni iOS (iOptions)

Su iOS puoi impostare accessibility (es. KeychainAccessibility.first_unlock) per controllare quando la chiave è accessibile. Evitare opzioni che rendono i dati accessibili quando il dispositivo è bloccato se non strettamente necessario.

Network security

HTTPS obbligatorio

Flutter su iOS e Android blocca le connessioni HTTP (cleartext) di default. Per dev locale puoi permettere eccezioni tramite network_security_config.xml (Android) o Info.plist (iOS), ma solo per domini di debug. In produzione usare sempre HTTPS.

SSL Pinning

Il pinning associa l'app a un certificato o una chiave pubblica specifici. Anche se un attaccante interpone un proxy (MITM), la connessione fallisce perché il certificato presentato non corrisponde al pin. Due varianti:

  • Certificate pinning: si fissa il certificato SSL. Meno flessibile: a ogni rinnovo del certificato serve un aggiornamento dell'app.
  • Public key pinning: si fissa l'hash della chiave pubblica (es. SHA-256). Più resiliente ai rinnovi del certificato.

Package come http_certificate_pinning o dio_http2_adapter con SecurityContext permettono di impostare i pin. Best practice: preferire public key, considerare Remote Config o update da server per aggiornare i pin senza nuova release.

Android: network_security_config

Per controllare cleartext e certificate trust, in AndroidManifest.xml si referenzia un file XML:

<meta-data
  android:name="io.flutter.network-policy"
  android:resource="@xml/network_security_config" />

In res/xml/network_security_config.xml si definiscono i domini per cui permettere cleartext (solo debug) e le policy di trust.

Protezione dati sensibili

Non hardcodare segreti

API key, secret e password non vanno nel codice. Usare --dart-define o --dart-define-from-file in build, con file esclusi da git. In CI i valori arrivano da secret store. Per massima sicurezza, le chiavi critiche andrebbero gestite solo lato server.

Crittografia end-to-end (E2EE)

Per dati molto sensibili (messaggi, cartelle cliniche, dati finanziari) la crittografia E2EE garantisce che solo mittente e destinatario legittimi possano leggere. Si usano scambio chiavi (es. X25519), crittografia simmetrica (AES-GCM, ChaCha20-Poly1305) e chiavi private in secure storage. Il backend memorizza solo dati cifrati.

Logging e debug

In release disabilitare log verbosi e mai loggare token, password o PII. Usare flag di build o environment per attivare il debug solo in dev/staging.

Protezione da reverse engineering

L'app compilata può essere decompilata. Non basare la sicurezza su "segreti nascosti" nel client. Per operazioni sensibili (es. pagamenti, auth critica) delegare al backend e usare attestation/root detection solo come layer aggiuntivo, non come unica difesa.

Checklist sicurezza

  • Token in flutter_secure_storage, mai in SharedPreferences.
  • Refresh token flow con interceptor e pattern "One Future" per richieste concorrenti.
  • Logout: cancellare token e invalidare sessione.
  • HTTPS ovunque in produzione; cleartext solo per domini di debug se necessario.
  • SSL pinning (preferibilmente public key) per app che richiedono protezione MITM.
  • Segreti via dart-define o secret store, mai nel codice.
  • E2EE per dati altamente sensibili quando il caso d'uso lo richiede.
  • Nessun log di dati sensibili in release.

Conclusione

La sicurezza in Flutter richiede scelte deliberate su storage (flutter_secure_storage), gestione token (interceptor + refresh), rete (HTTPS, pinning) e protezione dati (niente hardcoding, E2EE quando serve). Applicare queste pratiche riduce i rischi e allinea l'app agli standard di settore e ai requisiti di compliance.

Queste pratiche si integrano con un setup di ambienti e rilasci solido. Per una review di sicurezza sul tuo progetto, scrivimi.

Fabrizio Billeci
Fabrizio Billeci
Sviluppatore app Flutter e full-stack · Catania

Torna al blog

Articoli correlati

Hai un progetto in mente?

Raccontami obiettivi e tempi: ti rispondo con una proposta concreta, una roadmap e una stima economica.

Parliamo del tuo progetto