PHP Password Hashing: Argon2id, bcrypt și migrare sigură
Învață cum să criptezi în siguranță parolele în PHP folosind Argon2id și bcrypt, alege parametri siguri, verifică credențialele și migrează hash-urile existente fără a forța resetarea parolelor.
PHP Password Hashing: Argon2id, bcrypt și Migrare Secură
Stocarea parolelor este una dintre cele mai importante decizii de securitate într-o aplicație web. O încălcare a bazei de date nu ar trebui să dezvăluie imediat credențialele utilizatorilor, dar hasharea slabă a parolelor poate face ca furmentele furate să fie ușor de atacat.
PHP include funcțiuni built-in pentru hashare, verificare și upgrade parole. Provocarea este selectarea algoritmului potrivit, configurarea acestuia pentru infrastructura dumneavoastră și migrarea conturilor existente fără a întrerupe autentificarea.
Pentru aplicații noi, Argon2id este în general opțiunea preferată atunci când build-ul PHP o suportă. bcrypt rămâne o opțiune practică de compatibilitate. Ambele ar trebui folosite prin API-ul de parole PHP, și nu prin criptografie făcută manual.
Această ghidă acoperă implementarea, selectarea parametrilor, migrarea legacy și greșelile comune.
De ce SHA-256 nu este potrivit pentru stocarea parolelor
SHA-256 este progettat pentru a fi rapid. Acest lucru îl face util pentru verificarea integrității, dar insuficient pentru stocarea parolelor: un atacator cu hashuri furate poate testa rapid multe încercări de parolă.
Algoritmi dedicați de hashare a parolelor consumă deliberat resurse în plus. Argon2id poate necesita memorie substanțială și timp de procesare, ceea ce face ca ghicitura la scară largă să fie mai costisitoare.
Un sistem de stocare secură necesită un salt unic generat aleator, un factor de muncă configurabil și o modalitate de a mări factorul de muncă pe măsura îmbunătățirii hardware-ului. PHP's password_hash() generează și stochează automat informațiile necesare despre salt.
The OWASP Password Storage Cheat Sheet recomandă hashare adaptivă a parolelor, în loc de funcții hash rapide de utilizare generală.
Argon2id vs bcrypt: care ar trebui să alegi?
| Caracteristică | Argon2id | bcrypt |
|---|---|---|
| Principala apărare | Memorie și cost de calcul | Cost de calcul |
| Memorie aspră | Da | Nu |
| Parametri configurabile | Memorie, iterații, paralelism | Factor de cost |
| Limită de intrare a parolei | Fără limită de 72 de bytes ca bcrypt | 72 de bytes |
| Disponibilitate în PHP | Depinde de build | Disponibilă în general |
| Cel mai potrivit | Preferat pentru stocarea noi de parole | Compatibilitate și sisteme vechi |
Argon2id este progettat să reziste atacărilor care beneficiă de hardware extrem de paralel. bcrypt este încă un algoritm legitim de hashare adaptivă a parolelor, dar limitarea de intrare necesită grijă: acoperă maximums peste 72 bytes, nu caractere.
Nu presupune PASSWORD_DEFAULT selectează Argon2id. Documentația PHP password_hash documentează în prezent bcrypt ca algoritmul implicit. PHP 8.4 a mărit costul implicit al bcrypt de la 10 la 12, exemplificând de ce baza pe parametri impliciti poate schimba performanța aplicației după upgrade.
Pasul 1: Verifică suportul pentru Argon2id
Argon2id nu este necesar disponibil în fiecare mediu de hosting. Verifică runtime-ul înainte de a-l alege:
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
Disponibilitatea depinde de cum a fost construit PHP. Nu presupune că upgrade-ul versiunii PHP activează automat Argon2id.
Pasul 2: Hashiază o parolă cu Argon2id
OWASP documentează mai multe configurații baseline acceptabile. Una folosește 19 MiB de memorie, două iterații și paralelism de un. PHP exprimă memory_cost în KiB, deci 19 MiB este 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
);
Opțiunea de paralelism threads este suportată cu unele backend-uri Argon2, inclusiv libargon2, dar nu cu fiecare build PHP. Dacă este suportată, o valoare de un corespunde acestei baseline; omiterea ei este mai portabilă. Benchmarka-ți configurația reală.
Hashul encodat rezultat include identificatorul algoritmului, parametri și saltul. Nu este nevoie să salvezi aceste valori în coloane de bază de date separate. O coloană VARCHAR(255) este un punct de plecare rezonabil pentru hashările moderne de parole, cu condiția că stochează valoarea encodată întreagă.
Acestea sunt parametri baseline, nu o configurație de producție universală. Testează latența și utilizarea memoriei în condiții de trafic autentificare concurent realist.
Pasul 3: Verifică corect credențialele

Deoarece fiecare hash de parolă folosește un salt aleator, generarea unui hash nou și compararea stringurilor nu va funcționa. Folosește 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.
Documentația PHP specifică că password_verify() este sigur împotriva atacurilor de timp. Citește algoritmul și parametrii de muncă din hashul stocat.
Verificarea parolei nu înlocuiește throttling-ul de autentificare, sesiunile secure, HTTPS, gestionarea corectă a erorilor sau autentificarea multifactor.
Pasul 4: Upgradează hashurile de parole existente în timpul autentificării
password_needs_rehash() detectează când un hash stocat folosește un algoritm sau parametri învechit. Acest lucru permite migrarea graduală fără a obliga fiecare utilizator activ să-și reseteze parola.
<?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.
}
Rehashați doar după o verificare reușită a parolei trimise. O actualizare condiționată poate asigura că hashul stocat încă corespunde valorii pe care a fost verificată recent. De exemplu, actualizează hashul parolei doar acolo unde atât ID-ul utilizatorului, întâi și vechi hash, se potrivesc.
Vezi PHP password_needs_rehash() pentru detalii API.
Pasul 5: Migrează hashurile legacy MD5 sau SHA-1
Aplicații mai vechi pot conține hashuri MD5, SHA-1 sau formate de parole personalizate. Astfel de hashuri nu pot fi verificate întotdeauna cu password_verify().
O migrare ar trebui să urmeze o secvență controlată:
- Identifică formatul legacy folosind metadate de încredere sau un format nemăslător, documentat.
- Verifică parola trimisă folosind schema legacy originală doar pentru conturile care încă o necesită.
- După o verificare reușită, creează imediat un hash modern folosind
password_hash(). - Înlocuiește hashul legacy stocat folosind o actualizare sigură a bazei de date.
- Retire verificarea legacy când migrarea este completă.
Nu ghicește algoritmul doar pe baza lungimii hashului când mai multe forme sunt posibile. Nu începe să decrie parola: hasharea nu este criptarea.
Pentru conturile care nu se autentifică niciodată, ia în considerare o politică de resetare a parolelor, în loc să păstrezi vechi hashuri slabă indefinit. Nu introduce un cale de fallback nesigură care acceptă hashuri slabe pentru utilizatori noi înregistrați.
Pasul 6: Benchmarkază hasharea pe infrastructura dumneavoastră
Parametrii de cost corecți depind de hardware-ul dumneavoastră, volumul de autentificări concurente și cerințele de latență.
<?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';

Rulează asta doar într-un mediu controlat, nu ca un endpoint web public. Măsoară și verificarea, și repetă sub încărcare reprezentativă. O setare care pare rapid în izolare poate epuiza RAM-ul când multe cereri ajung într-o grup.
OWASP recomandă echilibrarea securității cu capacitatea operațională și, în general, păstrarea operațiilor de hashare individuale sub un secundă.
Greșelile comune în hasharea parolelor
Adăugarea unui salt fix manual. PHP generează deja săli sigure pentru API-ul său de parole. Un salt fix elimină o protecție importantă.
Folosirea MD5, SHA-1 sau SHA-256 crude. Aceste algoritmi sunt mult prea rapidi pentru stocarea parolelor.
Ignorarea limitei de 72 de bytes a bcrypt. Caracterele UTF-8 multi-byte pot atinge această limită mai devreme decât utilizatorii se așteaptă.
Alegerea setărilor de cost extrem. Cerințele excesive de memorie sau procesor pot crea un riscul de denegare a serviciului pe endpoint-urile de autentificare.
Logarea parolelor trimise. Evită expunerea credențialelor prin jurnale de debug, sisteme de monitorizare sau rapoarte de eroare.
Presupunerea că hasharea parolelor rezolvă securitatea autentificării. Limitarea ratei, răspunsul la încălcare, securitatea sesiunilor și autentificarea multifactor sunt încă importante.
Ar trebui să folosești o piper?
Un piper este un secret comun suplimentar păstrat în afara bazei de parole. Spre deosebire de salt, acesta nu este stocat alături de fiecare hash.
Un piper bine proiectat poate oferi o apărare în adâncime dacă un atacator fură doar baza de date. Dar utilizarea piperului introduce complexitatea gestionării cheilor și a rotației: pierderea sau rotația unui piper poate necesita resetări de parole.
Nu improviza prin concatenarea unui secret hardcodat la fiecare parolă. Urmează o strategie documentată, stochează secretele separat și planifică rotația. OWASP discută abordările de piper pre-hash și post-hash.
O politică practică de hashare a parolelor
Pentru o aplicație PHP nouă, preferă Argon2id atunci când este disponibil, începe cu o configurație aliniată la OWASP, benchmarkează și stochează hashul encodat complet. Unde Argon2id nu este disponibil, bcrypt prin intermediul API-ului de parole PHP este o alternativă practică dacă costul și limita de intrare sunt înțelept.
Pentru o aplicație existentă, continuă să verifici hashurile legacy suportate în timp ce le upgradezi după autentificarea reușită. Evită migrările disruptive atunci când parola originală nu este disponibilă.
Proiectează-te pentru upgradeuri de la început. Hardware-ul și recomandările se schimbă; sistemul tău de autentificare ar trebui să poată adopta parametri și algoritmi mai buni fără să-ți schimbă fiecare parolă de utilizator într-o singură dată.
Întrebări frecvente
Este Argon2id mai bun decât bcrypt?
Argon2id oferă hardeza de memorie configurabilă și este alegerea preferată a OWASP pentru implementările noi de stocare a parolelor.
Folosește PHP Argon2id în mod implicit?
Nu. PHP's PASSWORD_DEFAULT selectează în prezent bcrypt. Folosește PASSWORD_ARGON2ID explicit atunci când este suportat.
Pot migra hashurile bcrypt fără resetări de parole?
Da. Verifică hashul existent, apoi rehashiază parola trimisă după o autentificare reușită.
Ar trebui să stochez saltul separat?
Nu. API-ul de hashare a parolelor PHP generează saltul și stochează informațiile necesare în hashul encodat.
Este SHA-256 sigur pentru parole?
Nu singur. Folosește un algoritm dedicat de hashare adaptivă a parolelor, în loc de SHA-256 brut.