Project 2FA - Sistema di Autenticazione a Due Fattori

🚀 Panoramica del Progetto

Project 2FA è un sistema di autenticazione sicuro, scalabile sviluppato in PHP. L'obiettivo principale di questo progetto è fornire un'infrastruttura solida per la gestione degli accessi utente, elevando gli standard di sicurezza tramite l'implementazione nativa dell'Autenticazione a Due Fattori (2FA).

✨ Caratteristiche Principali

• Registrazione Utenti (Signup): Flusso di registrazione completo con script di verifica.
• Login Sicuro: Validazione delle credenziali e gestione sicura delle sessioni.
• Autenticazione a Due Fattori (2FA): Livello di sicurezza aggiuntivo che richiede un'ulteriore validazione o codice per confermare l'identità dell'utente.
• Area Riservata (Home): Dashboard privata accessibile solo dopo aver completato l'intero ciclo di autenticazione.
• Gestione delle Sessioni (Logout): Chiusura pulita e sicura delle sessioni utente.
• UI e Design: Stili centralizzati per garantire un'esperienza utente moderna e professionale.

📁 Struttura della Repository

La struttura del progetto è organizzata in moduli funzionali per garantire una facile manutenibilità e una netta separazione delle logiche:

Project_2FA/
├── authentication.css    # Fogli di stile per le interfacce di auth
├── connection.php        # Script per la configurazione e la connessione al database
├── index.php             # Entry point (Gestione del reindirizzamento al login)
├── home/                 # Directory dell'area riservata post-login
│   └── index.php         # Pagina principale della dashboard
├── login/                # Modulo di accesso standard
│   ├── index.php         # Form di login
│   └── validate.php      # Validazione delle credenziali
├── logout/               # Modulo di disconnessione
│   └── index.php         # Script di terminazione sessione
├── request_2FA/          # Modulo core per la gestione del 2FA
│   ├── access.php        # Gestione dell'accesso 2FA
│   ├── config.php        # Configurazioni specifiche del 2FA
│   ├── register.php      # Registrazione del dispositivo 2FA
│   ├── validate.php      # Validazione token 2FA
│   └── verify.php        # Script di verifica del 2FA
└── signup/               # Modulo di registrazione utente
    ├── index.php         # Form di registrazione
    ├── register.php      # Elaborazione dei dati utente
    └── verify.php        # Verifica dell'account creato

🛠️ Tecnologie Utilizzate

• Backend: PHP (Core Logic & Session Management)
• Frontend: HTML5, CSS3
• Database: Integrazione SQL (gestita tramite connection.php)

⚙️ Installazione e Configurazione

1. Clona la repository:

   git clone https://github.com/tuo-username/project_2FA.git

2. Configurazione Database:
   • Assicurati di avere a disposizione le tabelle SQL per gli utenti e i token 2FA (se disponibili nel rilascio).
   • Modifica il file connection.php inserendo le credenziali corrette del tuo database (host, utente, password, nome database).
3. Configurazione Server:
   • Il progetto richiede un server web (es. Apache o Nginx) con supporto PHP attivo.
   • Posiziona la cartella all'interno della Document Root del tuo ambiente locale (es. htdocs, /var/www/html o tramite Laravel Valet / Docker).
4. Accesso iniziale:
   • Visita http://localhost/project_2FA per avviare il sistema (l'index.php principale reindirizzerà automaticamente al modulo di login).

🔒 Best Practices sulla Sicurezza

In ambienti di produzione si raccomanda fortemente di:

• Erogare l'applicazione esclusivamente su connessioni protette HTTPS.
• Tenere riservati eventuali secret o chiavi archiviate in request_2FA/config.php.
• Sfruttare algoritmi di hashing robusti (es. password_hash() in PHP) per memorizzare le credenziali.

🤝 Contribuire

Le Pull Request sono sempre le benvenute. Per modifiche importanti, cambiamenti di logica core o estensioni al sistema 2FA, si prega di aprire prima una issue per discutere l'implementazione proposta.