Web e sviluppo

Hashing delle password in PHP: Argon2id, bcrypt e migrazione sicura

PHP Password Hashing: Argon2id, bcrypt and Secure Migration

Scopri come hashare in modo sicuro le password in PHP usando Argon2id e bcrypt, scegli parametri sicuri, verifica le credenziali e migra gli hash esistenti senza forzare il reset delle password.

PHP Password Hashing: Argon2id, bcrypt e Migrazione Sicura

La memorizzazione delle password è una delle decisioni di sicurezza più importanti in un'applicazione web. Una violazione del database non dovrebbe immediatamente rivelare le credenziali degli utenti, ma un hashing debole delle password può rendere i hash rubati economici da attaccare.

PHP include funzioni integrate per l'hashing, la verifica e l'aggiornamento delle password. La sfida è scegliere l'algoritmo corretto, configurarlo per la propria infrastruttura e migrare gli account esistenti senza interrompere l'autenticazione.

Per nuove applicazioni, Argon2id è generalmente la scelta preferita quando la tua build PHP la supporta. bcrypt rimane un'opzione di compatibilità pratica. Entrambi dovrebbero essere usati tramite l'API password di PHP, piuttosto che tramite criptografia fatta in casa.

Questa guida copre l'implementazione, la selezione dei parametri, la migrazione legata al legacy e gli errori comuni.

Perché SHA-256 non è adatto per la memorizzazione delle password

SHA-256 è progettato per essere veloce. Ciò lo rende utile per controlli di integrità ma non è adatto da solo per la memorizzazione delle password: un attaccante con hash rubati può testare molte ipotesi di password rapidamente.

Gli algoritmi dedicati per l'hashing delle password consumano risorse in modo deliberato. Argon2id può richiedere memoria sostanziale oltre al tempo di elaborazione, rendendo più costosa la grande scala di indovinamenti.

Un sistema di memorizzazione sicuro richiede un sale casuale unico, un fattore di lavoro configurabile e un modo per aumentare il fattore di lavoro con l'avanzamento dell'hardware. La password_hash() di PHP genera e memorizza automaticamente le informazioni sul sale necessarie.

Il OWASP Password Storage Cheat Sheet consiglia l'hashing adattativo delle password anziché funzioni hash generali veloci.

Argon2id vs bcrypt: quale scegliere?

Feature Argon2id bcrypt
Principale difesa Costo di memoria e computazione Costo di computazione
Resistente alla memoria Sì No
Parametri configurabili Memoria, iterazioni, parallelismo Fattore di costo
Limite di input della password Nessun limite di 72 byte stile bcrypt 72 byte
Disponibilità in PHP Dipende dalla build Ampliamente disponibile
Miglior utilizzo Preferito per la nuova memorizzazione delle password Compatibilità e sistemi legacy

Argon2id è progettato per resistere agli attacchi che sfruttano hardware massivamente parallelo. bcrypt è ancora un algoritmo di hashing delle password adattivo legittimo, ma il suo limite di input richiede attenzione: considera al massimo i primi 72 byte, non caratteri.

Non assumere che PASSWORD_DEFAULT selezioni Argon2id. La documentazione PHP password_hash documenta attualmente bcrypt come algoritmo predefinito. PHP 8.4 ha aumentato il costo predefinito di bcrypt da 10 a 12, illustrando perché affidarsi a parametri impliciti può cambiare le prestazioni dell'applicazione dopo gli aggiornamenti.

Passo 1: Verifica il supporto di Argon2id

Argon2id non è necessariamente disponibile in ogni ambiente di hosting. Verifica il runtime prima di selezionarlo:

<?php
declare(strict_types=1);

if(in_array('argon2id', password_algos(), true)) {
    echo 'Argon2id is available';
} else {
    echo 'Argon2id is not available';
}

La disponibilità dipende da come PHP è stato compilato. Non assumere che l'aggiornamento della versione PHP abiliti automaticamente Argon2id.

Passo 2: Hash di una password con Argon2id

OWASP documenta diverse configurazioni di base accettabili. Una utilizza 19 MiB di memoria, due iterazioni e parallelismo pari a uno. PHP esprime memory_cost in KiB, quindi 19 MiB corrispondono a 19 * 1024 KiB.

<?php
declare(strict_types=1);

$options = [
    'memory_cost' => 19 * 1024,
    'time_cost' => 2
];

$password = 'example-user-password';

$hash = password_hash(
    $password,
    PASSWORD_ARGON2ID,
    $options
);

L'opzione di parallelismo threads è supportata da alcuni backend Argon2, inclusa libargon2, ma non da tutti i build PHP. Se supportata, un valore di uno corrisponde a questa linea di base; ometterlo è più portabile. Benchmark la tua configurazione reale.

L'hash codificato risultante include l'identificatore dell'algoritmo, i parametri e il sale. Non è necessario salvare questi valori in colonne separate del database. Una colonna VARCHAR(255) è un punto di partenza ragionevole per hashes di password moderne, purché contenga l'intero valore codificato.

Questi sono parametri di base, non una configurazione di produzione universale. Testa latenza e utilizzo della memoria in condizioni di traffico di autenticazione simultaneo realistico.

Passo 3: Verifica le credenziali correttamente

Illustration of the article's main concept

Poiché ogni hash delle password utilizza un sale casuale, generare un nuovo hash e confrontare stringhe non funzionerà. Usa password_verify():

<?php
declare(strict_types=1);

$submittedPassword = (string)($_POST['password'] ?? '');
$storedHash = (string)$user['password_hash'];

if(!password_verify($submittedPassword, $storedHash)) {
    // Reject authentication without disclosing account existence.
    return;
}

// The password is valid. Continue with secure session handling.

La documentazione PHP specifica che password_verify() è sicuro contro gli attacchi temporali. Legge l'algoritmo e i parametri di lavoro dal hash memorizzato.

La verifica della password non sostituisce il throttling degli accessi, sessioni sicure, HTTPS, gestione adeguata degli errori o l'autenticazione multifattoriale.

Passo 4: Aggiorna gli hash delle password esistenti durante il login

password_needs_rehash() rileva quando un hash memorizzato utilizza un algoritmo o parametri obsoleti. Ciò consente una migrazione graduale senza costringere ogni utente attivo a reimpostare la password.

<?php
declare(strict_types=1);

$options = [
    'memory_cost' => 19 * 1024,
    'time_cost' => 2
];

if(password_verify($submittedPassword, $storedHash)) {
    if(password_needs_rehash(
        $storedHash,
        PASSWORD_ARGON2ID,
        $options
    )) {
        $newHash = password_hash(
            $submittedPassword,
            PASSWORD_ARGON2ID,
            $options
        );

        // Persist with a prepared statement.
        // Prefer a conditional UPDATE to avoid overwriting
        // a newer hash from a concurrent request.
    }

    // Finish authentication and rotate the session identifier.
}

Rihash solo dopo aver verificato con successo la password inviata. Un aggiornamento condizionale può garantire che l'hash memorizzato corrisponda ancora al valore appena verificato. Ad esempio, aggiorna l'hash della password solo se sia l'ID utente che l'hash vecchio coincidono.

Vedi PHP password_needs_rehash() per i dettagli dell'API.

Passo 5: Migra gli hash legacy MD5 o SHA-1

Le applicazioni più vecchie possono contenere hash MD5, SHA-1 o formati di password personalizzati. Tali hash non possono sempre essere verificati con password_verify().

Una migrazione dovrebbe seguire una sequenza controllata:

  1. Identifica il formato legacy utilizzando metadati affidabili o un formato chiaro, documentato.
  2. Verifica la password inviata utilizzando lo schema legacy originale solo per gli account che ne ancora richiedono.
  3. Dopo una verifica riuscita, crea immediatamente un hash moderno usando password_hash().
  4. Sostituisci l'hash legacy memorizzato tramite un aggiornamento sicuro del database.
  5. Ritira la verifica legacy quando la migrazione è completa.

Non indovinare l'algoritmo solo sulla base della lunghezza dell'hash quando sono possibili più formati. Non tentare di decifrare gli hash delle password: l'hashing non è cifratura.

Per gli account che non effettuano mai il login, considera una politica di reimpostazione della password anziché mantenere indefinitamente hash deboli. Non introdurre un percorso di fallback insicuro che accetti hash deboli per nuovi utenti registrati.

Passo 6: Benchmark dell'hashing sulla tua infrastruttura

<?php
declare(strict_types=1);

$options = [
    'memory_cost' => 19 * 1024,
    'time_cost' => 2
];

$start = hrtime(true);

$hash = password_hash(
    'benchmark-password',
    PASSWORD_ARGON2ID,
    $options
);

$milliseconds = (hrtime(true) - $start) / 1_000_000;

echo round($milliseconds, 2) . ' ms';
Technical workflow illustration

Esegui questo solo in un ambiente controllato, non come endpoint web pubblico. Misura anche la verifica e ripeti sotto carico rappresentativo. Un'impostazione che sembra veloce in isolamento può esaurire la RAM quando molti richieste arrivano contemporaneamente.

OWASP consiglia di bilanciare sicurezza e capacità operativa, mantenendo generalmente le singole operazioni di hashing al di sotto di un secondo.

Errori comuni nell'hashing delle password

Aggiunta di un sale fisso manualmente. PHP genera già sale sicuri per la sua API password. Un sale fisso rimuove una protezione importante.

Utilizzo di MD5, SHA-1 o SHA-256 raw. Questi algoritmi sono molto troppo veloci per la memorizzazione delle password da soli.

Ignorare il limite di 72 byte di bcrypt. I caratteri UTF-8 a più byte possono raggiungere questo limite prima che gli utenti se lo aspettino.

Scelta di impostazioni di costo estreme. Richieste eccessive di memoria o CPU possono creare un rischio di negazione del servizio agli endpoint di autenticazione.

Registrazione delle password inviate. Evita di esporre credenziali tramite log di debug, sistemi di monitoraggio o report di errore.

Assumere che l'hashing delle password risolva la sicurezza dell'autenticazione. Il throttling, la risposta alle violazioni, la sicurezza delle sessioni e l'autenticazione multifattoriale contano ancora.

Dovresti usare un pepper?

Un pepper è un ulteriore segreto condiviso mantenuto al di fuori del database delle password. A differenza di un sale, non è memorizzato insieme a ciascun hash.

Un pepper correttamente progettato può fornire difesa in profondità se un attaccante ruba solo il database. Tuttavia, il peppering introduce complessità nella gestione e nella rotazione delle chiavi: la perdita o la rotazione di un pepper può richiedere reimpostazioni della password.

Non improvvisare concatenando un segreto hardcoded a ogni password. Segui una strategia documentata, conserva i segreti separatamente e pianifica la rotazione. OWASP discute gli approcci di pre-hashing e post-hashing per il pepper.

Una politica pratica di hashing delle password

Per una nuova applicazione PHP, preferisci Argon2id quando disponibile, inizia con una configurazione allineata a OWASP, benchmarkala e salva l'hash completo codificato. Dove Argon2id non è disponibile, bcrypt tramite l'API password di PHP è un'alternativa pratica se il suo costo e il limite di input sono compresi.

Per un'applicazione esistente, continua a verificare gli hash legacy supportati mentre li aggiorni dopo un'autenticazione riuscita. Evita migrazioni disruptive quando la password originale è non disponibile.

Progettare per gli aggiornamenti fin dall'inizio. L'hardware e le raccomandazioni cambiano; il tuo sistema di autenticazione dovrebbe poter adottare parametri e algoritmi migliori senza dover cambiare la password di ogni utente contemporaneamente.

Domande frequenti

Argon2id è meglio di bcrypt?

Argon2id offre durezza della memoria configurabile ed è la scelta preferita da OWASP per nuove implementazioni di memorizzazione delle password.

PHP utilizza Argon2id di default?

No. La PASSWORD_DEFAULT di PHP seleziona attualmente bcrypt. Usa PASSWORD_ARGON2ID esplicitamente quando supportato.

Posso migrare gli hash bcrypt senza reimpostare le password?

Sì. Verifica l'hash esistente, quindi rehash della password inviata dopo un login riuscito.

Devo memorizzare il sale separatamente?

No. L'API di hashing delle password di PHP genera il sale e memorizza le informazioni necessarie nell'hash codificato.

SHA-256 è sicuro per le password?

Non da solo. Usa un algoritmo di hashing delle password dedicato e adattivo anziché SHA-256 puro.

Riferimenti ufficiali