PHP Hashování hesel: Argon2id, bcrypt a bezpečná migrace
Naučte se, jak bezpečně hashovat hesla v PHP pomocí Argon2id a bcrypt, vyberte bezpečné parametry, ověřte přihlašovací údaje a migrujte stávající hashe bez nutnosti resetovat hesla.
Hashování hesel v PHP: Argon2id, bcrypt a bezpečná migrace
Ukládání hesel je jedním z nejdůležitějších bezpečnostních rozhodnutí v webové aplikaci. Porušení databáze by nemělo okamžitě odhalit přihlašovací údaje uživatelů, ale slabé hashování hesel může učinit ukradené haše levné na útoky.
PHP obsahuje vestavěné funkce pro hashování, ověřování a aktualizaci hesel. Výzva spočívá ve výběru správného algoritmu, jeho konfiguraci pro vaši infrastrukturu a migraci stávajících účtů bez narušení autentizace.
Pro nové aplikace je obecně preferovanou volbou Argon2id, pokud vaše sestavení PHP tuto funkci podporuje. Bcrypt zůstává praktickou možností pro zajištění kompatibility. Oba by měly být používány prostřednictvím API pro práci s hesly PHP, nikoli prostřednictvím vlastní kryptografie.
Tento návod pokrývá implementaci, výběr parametrů, migraci do starších systémů a běžné chyby.
Proč není SHA-256 vhodný pro ukládání hesel
SHA-256 je navržen tak, aby byl rychlý. To ho činí užitečným pro kontrolu integrity, ale sám o sobě není vhodný pro ukládání hesel: útočník s ukradenými haši může rychle vyzkoušet mnoho tipů na heslo.
Speciální algoritmy pro hashování hesel záměrně spotřebovávají více zdrojů. Argon2id může vyžadovat značnou paměť a čas na zpracování, což činí rozsáhlé hádání hesel dražší.
Bezpečný úložný systém potřebuje jedinečné náhodné solení, konfigurovatelný koeficient práce a způsob, jak zvýšit koeficient práce, jak se hardware zlepšuje. PHP funkce password_hash() automaticky generuje a ukládá potřebné informace o soli.
OWASP Password Storage Cheat Sheet doporučuje adaptivní hashování hesel místo rychlých obecných hashovacích funkcí.
Argon2id vs. bcrypt: kterou možnost byste měli zvolit?
| Funkce | Argon2id | bcrypt |
|---|---|---|
| Hlavní obrana | Nákladnost paměti a výpočtů | Nákladnost výpočtů |
| Odolný vůči útokům na paměť | Ano | Ne |
| Konfigurovatelné parametry | Paměť, iterace, paralizovatelnost | Faktor nákladů |
| Limit vstupu hesla | Ne, žádný bcryptový limit 72 bajtů | 72 bajtů |
| Dostupnost v PHP | Záleží na sestavení | Obecně dostupné |
| Nejlepší volba | Preferováno pro nové ukládání hesel | Kompatibilita a starší systémy |
Argon2id je navržen tak, aby odolával útokům, které těží z masivně paralelního hardwaru. Bcrypt je stále legitimním algoritmem pro adaptivní hashování hesel, ale jeho limit vstupu vyžaduje opatrnost: bere v úvahu maximálně prvních 72 bajtů, ne znaků.
Nepředpokládejte, že PASSWORD_DEFAULT vybere Argon2id. Dokumentace PHP funkce password_hash v současné době uvádí bcrypt jako výchozí algoritmus. PHP 8.4 zvýšilo výchozí nákladnost bcryptu z 10 na 12, což ilustruje, proč spoléhání se na implicitní parametry může změnit výkon aplikace po upgradech.
Krok 1: Zkontrolujte podporu Argon2id
Argon2id nemusí být dostupný ve všech hostingových prostředích. Zkontrolujte runtime, než ho vyberete:
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
Dostupnost závisí na tom, jak byl PHP sestaven. Nepředpokládejte, že upgrade verze PHP automaticky aktivuje Argon2id.
Krok 2: Hashujte heslo pomocí Argon2id
OWASP dokumentuje několik přijatelných baseline konfigurací. Jedna z nich používá 19 MiB paměti, dvě iterace a paralizovatelnost jednu. PHP vyjadřuje memory_cost v KiB, takže 19 MiB je 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
);
Možnost paralizovatelnosti threads je podporována některými backendy Argon2, včetně libargon2, ale ne každým sestavením PHP. Pokud je podporována, hodnota jedna odpovídá této baseline; vynechání je více přenositelné. Otestujte latenci své skutečné konfigurace.
Výsledný zakódovaný hash obsahuje identifikátor algoritmu, parametry a sůl. Není nutné ukládat tyto hodnoty v oddělených sloupcích databáze. Sloupec VARCHAR(255) je rozumným výchozím bodem pro moderní haše hesel, pokud ukládá celou zakódovanou hodnotu.
Toto jsou základní parametry, nikoli univerzální produkční konfigurace. Otestujte latenci a paměťovou náročnost pod realistickou zátěží souběžné autentizace.
Krok 3: Správně ověřte přihlašovací údaje

Protože každý hash hesla používá náhodnou sůl, generování nového hashe a porovnávání řetězců nebude fungovat. Použijte 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.
PHP dokumentace specifikuje, že password_verify() je bezpečný proti útokům založeným na načasování. Čte algoritmus a parametry práce ze uloženého hashe.
Ověření hesla nenahrazuje throttling přihlášení, bezpečné relace, HTTPS, vhodné zpracování chyb nebo multifaktorové ověřování.
Krok 4: Aktualizujte stávající haše hesel během přihlášení
password_needs_rehash() detekuje, kdy uložený hash používá zastaralý algoritmus nebo parametry. To umožňuje postupnou migraci bez nutnosti nutit každého aktivního uživatele k resetování hesla.
<?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.
}
Hashujte znovu až po úspěšném ověření zadaného hesla. Podmíněná aktualizace může zajistit, že uložený hash stále odpovídá hodnotě, která byla právě ověřena. Například aktualizujte hash hesla pouze tam, kde se shodují uživatelské ID a starý hash.
Podívejte se na PHP funkci password_needs_rehash() pro podrobnosti o API.
Krok 5: Migrujte starší haše MD5 nebo SHA-1
Starší aplikace mohou obsahovat haše MD5, SHA-1 nebo vlastní formáty hesel. Tyto haše nelze vždy ověřit pomocí password_verify().
Migrace by měla následovat kontrolovaný postup:
- Identifikujte zastaralý formát pomocí důvěryhodných metadat nebo jednoznačného, zdokumentovaného formátu.
- Ověřte zadané heslo pomocí původního zastaralého schématu pouze pro účty, které to stále vyžadují.
- Po úspěšném ověření okamžitě vytvořte moderní hash pomocí
password_hash(). - Nahraďte uložený zastaralý hash pomocí bezpečné aktualizace databáze.
- Po dokončení migrace vyřaďte zastaralé ověřování.
Nepředpokládejte algoritmus pouze na základě délky hashe, pokud je možné více formátů. Nepokoušejte se dešifrovat haše hesel: hashování není šifrování.
Pro účty, které se nikdy nepřihlásí, zvažte politiku resetování hesel místo uchovávání slabých hašů donekonečna. Nezavádějte insecure fallback cestu, která přijímá slabé haše pro nově registrované uživatele.
Krok 6: Otestujte hashování na vaší infrastruktuře
Správné parametry nákladů závisí na vašem hardwaru, objemu souběžných přihlášení a požadavcích na latenci.
<?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';

Proveďte to pouze v kontrolovaném prostředí, ne jako veřejný webový endpoint. Měřte také ověřování a opakujte test pod reprezentativní zátěží. Nastavení, které vypadá rychle v izolaci, může vyčerpat RAM, když mnoho požadavků dorazí současně.
OWASP doporučuje vyvažovat bezpečnost s operační kapacitou a obecně udržovat jednotlivé operace hashování pod jednou sekundou.
Běžné chyby při hashování hesel
Ruční přidání pevné soli. PHP již generuje bezpečné soli pro své API pro práci s hesly. Pevná sůl odstraňuje důležitou ochranu.
Používání syrových MD5, SHA-1 nebo SHA-256. Tyto algoritmy jsou příliš rychlé pro ukládání hesel samotné.
Ignorování 72bajtového limitu bcryptu. Vícebytové UTF-8 znaky mohou dosáhnout tohoto limitu dříve, než uživatelé očekávají.
Výběr extrémních nákladových nastavení. Nadměrné požadavky na paměť nebo CPU mohou vytvořit riziko odmítnutí služby na autentizačních koncových bodech.
Zaznamenávání zadaných hesel. Vyhněte se odhalování přihlašovacích údajů prostřednictvím debugovacích logů, monitorovacích systémů nebo chybových hlášení.
Předpokládat, že hashování hesel řeší bezpečnost autentizace. Rate limiting, reakce na úniky, bezpečnost relací a multifaktorové ověřování stále záleží.
Měli byste používat pepř?
Pepř je dodatečné sdílené tajemství udržované mimo databázi hesel. Na rozdíl od soli není uložen vedle každého hashe.
Správně navržený pepř může poskytnout obranu v hloubce, pokud útočník ukradne pouze databázi. Ale používání pepře zavádí komplexitu správy klíčů a rotace: ztráta nebo rotace pepře může vyžadovat resetování hesel.
Neprovozujte improvizované řešení připojením hardcodeovaného tajemství ke každému heslu. Následujte zdokumentovanou strategii, ukládejte tajemství odděleně a plánujte rotaci. OWASP diskutuje o pre-hashovacích a post-hashovacích přístupech k pepři.
Praktická politika hashování hesel
Pro novou PHP aplikaci preferujte Argon2id, pokud je dostupný, začněte s konfigurací podle OWASP, otestujte ji a uložte celý zakódovaný hash. Kde není Argon2id dostupný, je bcrypt přes API pro práci s hesly PHP praktickou alternativou, pokud jsou pochopeny jeho náklady a limit vstupu.
Pro existující aplikaci pokračujte ve ověřování podporovaných zastaralých hašů, zatímco je aktualizujete po úspěšném přihlášení. Vyhněte se narušujícím migracím, když původní heslo není dostupné.
Navrhujte systém od začátku s ohledem na aktualizace. Hardware a doporučení se mění; váš autentizační systém by měl být schopen přijmout lepší parametry a algoritmy bez nutnosti měnit heslo každého uživatele najednou.
Často kladené otázky
Je Argon2id lepší než bcrypt?
Argon2id nabízí konfigurovatelnou paměťovou náročnost a je OWASP preferovanou volbou pro nové implementace ukládání hesel.
Používá PHP Argon2id jako výchozí algoritmus?
Ne. PHP funkce PASSWORD_DEFAULT v současné době vybírá bcrypt. Použijte PASSWORD_ARGON2ID explicitně, když je to podporováno.
Mohu migrovat haše bcrypt bez resetování hesel?
Ano. Ověřte existující hash, pak přehašujte zadané heslo po úspěšném přihlášení.
Měli bychom ukládat sůl samostatně?
Ne. API pro hashování hesel PHP generuje sůl a ukládá potřebné informace v zakódovaném hashi.
Je SHA-256 bezpečný pro hesla?
Ne sám o sobě. Použijte speciální adaptivní algoritmus pro hashování hesel, ne syrový SHA-256.