PS PrestaShop PrestaShop Principiante

2FA Google Authenticator per PrestaShop — Documentazione

Installa e configura l'autenticazione a due fattori TOTP sul back office di PrestaShop 8 e 9: abbinamento, codici di recupero, modalità obbligatoria, anti forza bruta.

Aggiornato Versione del modulo 1.1.0

Questa guida copre l’installazione, la configurazione e l’uso quotidiano del modulo 2FA Google Authenticator per PrestaShop 8 e 9. Il modulo aggiunge una verifica tramite codice a 6 cifre (standard TOTP, RFC 6238) dopo l’inserimento della password sul back office.

Requisiti

  • PrestaShop da 8.0 a 8.2 o PrestaShop 9.x
  • PHP 7.4 minimo (PHP 8.1+ richiesto da PrestaShop 9)
  • Un’app TOTP sul telefono di ogni dipendente: Google Authenticator, Microsoft Authenticator, Authy, 1Password, Bitwarden, FreeOTP o qualsiasi app compatibile con RFC 6238
  • Orologio del server sincronizzato via NTP (il caso su tutti gli hosting moderni)

Installazione

  1. Nel back office, apri Moduli → Gestione moduli.
  2. Clicca su Carica un modulo e seleziona il file df2fa.zip scaricato dal tuo account DataFirefly.
  3. Clicca su Installa. Il modulo crea la sua tabella nel database e registra i suoi controller automaticamente.

L’installazione non attiva il 2FA per nessuno: ogni dipendente deve effettuare il proprio abbinamento (o esservi forzato tramite la modalità obbligatoria, vedi sotto). Non rischi di restare bloccato fuori dal back office solo installando il modulo.

Configurazione del modulo

Apri Moduli → Gestione moduli → 2FA Google Authenticator → Configura. La pagina mostra tre blocchi:

Il mio account 2FA

Un pannello di stato in alto indica se il tuo 2FA è attivo, con un pulsante diretto all’abbinamento o alla gestione.

Configurazione 2FA

  • 2FA obbligatorio — in modalità forzata, qualsiasi dipendente senza 2FA configurato viene reindirizzato automaticamente alla pagina di abbinamento all’accesso. In modalità opt-in (predefinita), un banner promemoria viene mostrato nel back office e ogni dipendente attiva il proprio 2FA quando vuole.
  • Nome dell’emittente (Issuer) — il nome mostrato nell’app TOTP dei tuoi dipendenti (predefinito: il nome del negozio).

Stato 2FA dei dipendenti

Una tabella elenca tutti i dipendenti con il loro stato 2FA (attivo/inattivo), la data di configurazione e un pulsante Reimposta per ogni dipendente con 2FA attivo.

Distribuzione progressiva consigliata: inizia in modalità opt-in, lascia che il banner promemoria faccia il suo lavoro per qualche giorno, verifica l’adozione nella tabella, poi passa alla modalità obbligatoria.

Abbinamento lato dipendente

  1. Il dipendente apre la pagina di abbinamento: tramite il link Configura il mio 2FA del menu utente (in alto a destra del back office), tramite il banner promemoria, o automaticamente all’accesso se la modalità obbligatoria è attiva.
  2. Scansiona il codice QR mostrato con la sua app TOTP. Il codice QR è generato localmente nel browser — nessun dato viene inviato a servizi esterni. Se la scansione non è possibile, il segreto può essere inserito manualmente nell’app (pulsante Copia).
  3. Inserisce il codice a 6 cifre mostrato dall’app per confermare l’abbinamento.
  4. Vengono quindi mostrati gli 8 codici di recupero monouso — è l’unica volta in cui sono visibili. Il dipendente li copia o li stampa e li conserva in un luogo sicuro.

I codici di recupero sono memorizzati come hash (SHA-256): non possono essere visualizzati di nuovo in seguito. Se vengono persi, bisognerà disattivare e riattivare il 2FA, o passare per una reimpostazione del Super Admin.

Accesso con 2FA

Dopo l’inserimento della password, il dipendente viene reindirizzato alla schermata di verifica 2FA e inserisce il codice a 6 cifre corrente della sua app. La verifica resta valida per 12 ore per la sessione: non è necessario reinserire un codice a ogni pagina.

Viene applicata una tolleranza di deriva di ±30 secondi per assorbire piccole differenze di orologio tra il server e il telefono.

Codici di recupero

Se il dipendente non ha più accesso alla sua app TOTP (telefono perso, rubato, ripristinato):

  1. Nella schermata di verifica, clicca su Usa un codice di recupero.
  2. Inserisci uno degli 8 codici di recupero (10 caratteri).
  3. Ogni codice funziona una sola volta. Una volta connesso, disattiva e riattiva il 2FA per generare un nuovo abbinamento e una nuova serie di codici.

Protezione anti forza bruta

Dopo 5 codici non validi consecutivi, la verifica 2FA dell’account viene bloccata per 15 minuti. La schermata di verifica mostra il tempo rimanente. Il contatore si azzera a ogni verifica riuscita.

Reimpostazione da parte di un Super Admin

Se un dipendente ha perso sia il telefono che i codici di recupero:

  1. Un Super Admin apre la pagina di configurazione del modulo.
  2. Nella tabella Stato 2FA dei dipendenti, clicca su Reimposta sulla riga del dipendente interessato.
  3. Il 2FA del dipendente viene rimosso: può accedere solo con la sua password e dovrà rifare l’abbinamento (immediatamente se la modalità obbligatoria è attiva).

Disattivare il proprio 2FA

Da Gestisci il mio 2FA (menu utente o pannello del modulo), clicca su Disattiva il 2FA e conferma con un codice TOTP valido. Il codice è richiesto per impedire una disattivazione da una sessione lasciata aperta.

Aggiornamento dalla versione 1.0.x

L’aggiornamento alla 1.1.0 è automatico e trasparente:

  • La struttura della tabella viene migrata (colonne di blocco, campo segreto ampliato).
  • I segreti TOTP esistenti restano validi e vengono cifrati con AES-256 automaticamente al loro prossimo salvataggio. Nessun riabbinamento necessario.
  • I codici di recupero esistenti restano utilizzabili: vengono convertiti in hash SHA-256 al primo utilizzo.

Migrazione PS8 → PS9: il modulo è identico su entrambe le versioni. Puoi migrare il tuo negozio senza aggiornare il modulo né riabbinare i dipendenti.

Risoluzione dei problemi

«Codice non valido» anche se il codice sembra corretto

Nel 95% dei casi si tratta di uno scostamento di orologio. Verifica che l’orologio del server sia sincronizzato via NTP (timedatectl su Linux) e che l’ora del telefono sia in modalità automatica. La tolleranza del modulo è di ±30 secondi.

Account bloccato dopo tentativi falliti

Attendi la fine del blocco di 15 minuti, o chiedi a un Super Admin di reimpostare il 2FA dell’account dalla pagina di configurazione.

Tutti gli accessi Super Admin sono bloccati

Come ultima risorsa, disattiva il modulo nel database: nella tabella ps_module, imposta la colonna active a 0 per la riga df2fa, o rinomina temporaneamente la cartella modules/df2fa. Riconnettiti, riattiva il modulo e rifai gli abbinamenti necessari.

Il banner promemoria non viene mostrato

Il banner appare solo per i dipendenti senza 2FA attivo. In modalità opt-in può essere nascosto per la sessione corrente tramite il pulsante di chiusura; riappare alla sessione successiva.

Note di versione

1.1.0 — 2 luglio 2026

  • Compatibilità con PrestaShop 9 (controller, nuova pagina di accesso Symfony, Symfony 6.4)
  • Cifratura AES-256 del segreto TOTP nel database, con migrazione automatica
  • Codici di recupero con hash SHA-256 (10 caratteri)
  • Blocco di 15 minuti dopo 5 codici non validi
  • Codice QR generato 100% localmente (dipendenza da CDN rimossa)

1.0.0 — 12 marzo 2025

  • Prima versione stabile: TOTP RFC 6238, modalità obbligatoria o opt-in, 8 codici di recupero, reimpostazione Super Admin, multinegozio
Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza