PHP Passwort-Hashing: Argon2id, bcrypt und sichere Migration
Lernen Sie, wie Sie Passwörter in PHP sicher hashen, indem Sie Argon2id und bcrypt verwenden, sichere Parameter wählen, Anmeldedaten verifizieren und vorhandene Hashes migrieren, ohne Passwörter zurückzusetzen.
PHP-Passwort-Hashing: Argon2id, bcrypt und sichere Migration
Die Speicherung von Passwörtern ist eine der wichtigsten Sicherheitsentscheidungen in einer Webanwendung. Eine Datenbankpanne sollte die Zugangsdaten der Benutzer nicht sofort offenlegen, doch ein schwaches Passwort-Hashing kann Angriffe auf gestohlene Hashes kostengünstig machen.
PHP enthält integrierte Funktionen zum Hashen, Verifizieren und Aktualisieren von Passwörtern. Die Herausforderung besteht darin, den richtigen Algorithmus auszuwählen, ihn für Ihre Infrastruktur zu konfigurieren und bestehende Konten zu migrieren, ohne die Authentifizierung zu unterbrechen.
Für neue Anwendungen ist Argon2id generell die bevorzugte Wahl, sofern Ihr PHP-Build dies unterstützt. bcrypt bleibt eine praktische Option für die Kompatibilität. Beide sollten über die Passwort-API von PHP verwendet werden und nicht über selbst erstellte Kryptographie.
Dieser Leitfaden behandelt die Implementierung, die Parameterauswahl, die Legacy-Migration und häufige Fehler.
Warum SHA-256 für die Speicherung von Passwörtern nicht geeignet ist
SHA-256 ist darauf ausgelegt, schnell zu sein. Das macht es nützlich für Integritätsprüfungen, aber für sich allein ungeeignet für die Speicherung von Passwörtern: Ein Angreifer mit gestohlenen Hashes kann sehr schnell viele Passwort-Vermutungen durchtesten.
Spezielle Passwort-Hashing-Algorithmen verbrauchen bewusst mehr Ressourcen. Argon2id kann sowohl erheblich viel Speicher als auch Rechenzeit beanspruchen, wodurch groß angelegtes Raten teurer wird.
Ein sicheres Speichersystem benötigt einen eindeutigen Zufalls-Salt, einen konfigurierbaren Arbeitsfaktor (Work Factor) und eine Möglichkeit, diesen Arbeitsfaktor bei fortschreitender Hardware-Leistung zu erhöhen. PHPs password_hash() generiert und speichert die erforderlichen Salt-Informationen automatisch.
Das OWASP Password Storage Cheat Sheet empfiehlt adaptives Passwort-Hashing anstelle von schnellen universellen Hash-Funktionen.
Argon2id vs. bcrypt: Was sollten Sie wählen?
| Funktion | Argon2id | bcrypt |
|---|---|---|
| Hauptabwehr | Speicher- und Rechenaufwand | Rechenaufwand |
| Speicherintensiv (Memory-hard) | Ja | Nein |
| Konfigurierbare Parameter | Speicher, Iterationen, Parallelität | Kostenfaktor (Cost factor) |
| Passwort-Eingabelimit | Kein 72-Byte-Limit wie bei bcrypt | 72 Bytes |
| Verfügbarkeit in PHP | Abhängig vom Build | Weit verbreitet |
| Beste Eignung | Bevorzugt für neue Passwortspeicherung | Kompatibilität und Legacy-Systeme |
Argon2id wurde entwickelt, um Angriffen zu widerstehen, die von massiv paralleler Hardware profitieren. bcrypt ist nach wie vor ein legitimer adaptiver Passwort-Hashing-Algorithmus, aber sein Eingabelimit erfordert Vorsicht: Er berücksichtigt maximal die ersten 72 Bytes, nicht Zeichen.
Gehen Sie nicht davon aus, dass PASSWORD_DEFAULT Argon2id auswählt. Die PHP password_hash-Dokumentation weist bcrypt derzeit als Standardalgorithmus aus. PHP 8.4 hat die Standardkosten von bcrypt von 10 auf 12 angehoben, was verdeutlicht, warum das Verlassen auf implizite Parameter die Anwendungsleistung nach Upgrades verändern kann.
Schritt 1: Argon2id-Unterstützung prüfen
Argon2id ist nicht zwangsläufig in jeder Hosting-Umgebung verfügbar. Überprüfen Sie die Laufzeitumgebung, bevor Sie es auswählen:
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
Die Verfügbarkeit hängt davon ab, wie PHP kompiliert wurde. Gehen Sie nicht davon aus, dass ein Upgrade der PHP-Version Argon2id automatisch aktiviert.
Schritt 2: Ein Passwort mit Argon2id hashen
OWASP dokumentiert mehrere akzeptable Basiskonfigurationen. Eine davon verwendet 19 MiB Speicher, zwei Iterationen und einen Parallelitätswert von eins. PHP gibt memory_cost in KiB an, 19 MiB entsprechen also 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
);
Die Parallelitätsoption threads wird von einigen Argon2-Backends unterstützt, darunter libargon2, jedoch nicht von jedem PHP-Build. Sofern unterstützt, entspricht ein Wert von eins dieser Baseline; das Weglassen ist portabler. Führen Sie Benchmarks für Ihre tatsächliche Konfiguration durch.
Der resultierende encodierte Hash enthält die Algorithmus-Kennung, Parameter und den Salt. Es ist nicht erforderlich, diese Werte in separaten Datenbankspalten zu speichern. Eine VARCHAR(255)-Spalte ist ein vernünftiger Ausgangspunkt für moderne Passwort-Hashes, vorausgesetzt, sie speichert den gesamten encodierten Wert.
Dies sind Basisparameter, keine universelle Produktionskonfiguration. Testen Sie Latenz und Speichernutzung unter realistischem, gleichzeitigem Authentifizierungsaufkommen.
Schritt 3: Anmeldedaten korrekt verifizieren

Da jeder Passwort-Hash einen zufälligen Salt verwendet, funktioniert das Generieren eines neuen Hashes und der anschließende String-Vergleich nicht. Verwenden Sie 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.
Die PHP-Dokumentation gibt an, dass password_verify() sicher gegen Timing-Angriffe ist. Die Funktion liest den Algorithmus und die Arbeitsparameter aus dem gespeicherten Hash aus.
Die Passwortverifizierung ersetzt keine Anmelde-Drosselung (Login Throttling), sichere Sessions, HTTPS, angemessene Fehlerbehandlung oder Multi-Faktor-Authentifizierung.
Schritt 4: Bestehende Passwort-Hashes beim Login aktualisieren
password_needs_rehash() erkennt, wenn ein gespeicherter Hash einen veralteten Algorithmus oder veraltete Parameter verwendet. Dies ermöglicht eine schrittweise Migration, ohne dass jeder aktive Benutzer sein Passwort zurücksetzen muss.
<?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.
}
Führen Sie ein Rehash nur durch, nachdem das übermittelte Passwort erfolgreich verifiziert wurde. Ein bedingtes Update kann sicherstellen, dass der gespeicherte Hash immer noch dem gerade verifizierten Wert entspricht. Aktualisieren Sie den Passwort-Hash beispielsweise nur dort, wo sowohl die Benutzer-ID als auch der alte Hash übereinstimmen.
Weitere API-Details finden Sie unter PHP password_needs_rehash().
Schritt 5: Veraltete MD5- oder SHA-1-Hashes migrieren
Ältere Anwendungen können MD5, SHA-1 oder benutzerdefinierte Passwortformate enthalten. Solche Hashes können nicht immer mit password_verify() verifiziert werden.
Eine Migration sollte einer kontrollierten Reihenfolge folgen:
- Identifizieren Sie das Legacy-Format anhand vertrauenswürdiger Metadaten oder eines eindeutigen, dokumentierten Formats.
- Verifizieren Sie das übermittelte Passwort mit dem ursprünglichen Legacy-Schema nur für Konten, die dies noch erfordern.
- Erstellen Sie nach erfolgreicher Verifizierung sofort einen modernen Hash mit
password_hash(). - Ersetzen Sie den gespeicherten Legacy-Hash durch ein sicheres Datenbank-Update.
- Entfernen Sie die Legacy-Verifizierung, sobald die Migration abgeschlossen ist.
Erraten Sie den Algorithmus nicht allein anhand der Hash-Länge, wenn mehrere Formate möglich sind. Versuchen Sie nicht, Passwort-Hashes zu entschlüsseln: Hashing ist keine Verschlüsselung.
Für Konten, die sich nie anmelden, sollten Sie eine Richtlinie zum Zurücksetzen von Passwörtern in Betracht ziehen, anstatt schwache Hashes auf unbestimmte Zeit beizubehalten. Führen Sie keinen unsicheren Fallback-Pfad ein, der schwache Hashes für neu registrierte Benutzer akzeptiert.
Schritt 6: Hashing auf Ihrer Infrastruktur benchmarken
Die richtigen Kostenparameter hängen von Ihrer Hardware, dem gleichzeitigen Anmeldeaufkommen und den Latenzanforderungen ab.
<?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';

Führen Sie dies nur in einer kontrollierten Umgebung aus, nicht als öffentlichen Web-Endpunkt. Messen Sie auch die Verifizierung und wiederholen Sie den Test unter repräsentativer Last. Eine Einstellung, die isoliert betrachtet schnell wirkt, kann den Arbeitsspeicher erschöpfen, wenn viele Anfragen gleichzeitig eingehen.
OWASP empfiehlt, Sicherheit und Betriebskapazität gegeneinander abzuwägen und einzelne Hashing-Vorgänge im Allgemeinen unter einer Sekunde zu halten.
Häufige Fehler beim Passwort-Hashing
Manuelles Hinzufügen eines festen Salts. PHP generiert bereits sichere Salts für seine Passwort-API. Ein fester Salt entfernt einen wichtigen Schutz.
Verwendung von reinem MD5, SHA-1 oder SHA-256. Diese Algorithmen sind für sich allein viel zu schnell für die Passwortspeicherung.
Ignorieren des 72-Byte-Limits von bcrypt. Multi-Byte-UTF-8-Zeichen können dieses Limit schneller erreichen, als Benutzer erwarten.
Wahl extremer Kosteneinstellungen. Übermäßige Speicher- oder CPU-Anforderungen können ein Denial-of-Service-Risiko an Authentifizierungs-Endpunkten darstellen.
Protokollieren übermittelter Passwörter. Vermeiden Sie es, Anmeldedaten über Debug-Logs, Monitoring-Systeme oder Fehlerberichte offenzulegen.
Die Annahme, Passwort-Hashing löse die Authentifizierungssicherheit vollständig. Ratenbegrenzung (Rate Limiting), Reaktionspläne bei Sicherheitsvorfällen, Session-Sicherheit und Multi-Faktor-Authentifizierung sind weiterhin wichtig.
Sollten Sie einen Pepper verwenden?
Ein Pepper ist ein zusätzliches gemeinsames Geheimnis, das außerhalb der Passwort-Datenbank aufbewahrt wird. Im Gegensatz zu einem Salt wird er nicht zusammen mit dem jeweiligen Hash gespeichert.
Ein richtig konzipierter Pepper kann Defense-in-Depth bieten, falls ein Angreifer ausschließlich die Datenbank stiehlt. Das Peppern bringt jedoch Komplexität beim Schlüsselmanagement und bei der Schlüsselrotation mit sich: Der Verlust oder die Rotation eines Peppers kann das Zurücksetzen von Passwörtern erforderlich machen.
Improvisieren Sie nicht, indem Sie an jedes Passwort ein fest codiertes Geheimnis anhängen. Befolgen Sie eine dokumentierte Strategie, speichern Sie Geheimnisse separat und planen Sie die Rotation ein. OWASP erörtert Ansätze für Pre-Hashing- und Post-Hashing-Pepper.
Eine praktische Passwort-Hashing-Richtlinie
Bevorzugen Sie bei einer neuen PHP-Anwendung Argon2id, sofern verfügbar, beginnen Sie mit einer an OWASP ausgerichteten Konfiguration, führen Sie Benchmarks durch und speichern Sie den vollständigen encodierten Hash. Wo Argon2id nicht verfügbar ist, ist bcrypt über die Passwort-API von PHP eine praktische Alternative, sofern dessen Kosten und Eingabelimit verstanden werden.
Verifizieren Sie bei einer bestehenden Anwendung weiterhin unterstützte Legacy-Hashes und aktualisieren Sie diese nach erfolgreicher Authentifizierung. Vermeiden Sie störende Migrationen, wenn das Originalpasswort nicht verfügbar ist.
Planen Sie Upgrades von Anfang an ein. Hardware und Empfehlungen ändern sich; Ihr Authentifizierungssystem sollte in der Lage sein, bessere Parameter und Algorithmen zu übernehmen, ohne dass das Passwort jedes Benutzers auf einmal geändert werden muss.
Häufig gestellte Fragen (FAQ)
Ist Argon2id besser als bcrypt?
Argon2id bietet eine konfigurierbare Speicherhärte (Memory Hardness) und ist die von OWASP bevorzugte Wahl für neue Implementierungen der Passwortspeicherung.
Verwendet PHP standardmäßig Argon2id?
Nein. PHPs PASSWORD_DEFAULT wählt derzeit bcrypt aus. Verwenden Sie PASSWORD_ARGON2ID explizit, sofern es unterstützt wird.
Kann ich bcrypt-Hashes ohne Passwort-Resets migrieren?
Ja. Verifizieren Sie den vorhandenen Hash und führen Sie nach erfolgreicher Anmeldung ein Rehash des übermittelten Passworts durch.
Sollte ich den Salt separat speichern?
Nein. Die Passwort-Hashing-API von PHP generiert den Salt und speichert die erforderlichen Informationen im encodierten Hash.
Ist SHA-256 sicher für Passwörter?
Nicht für sich allein. Verwenden Sie einen speziellen adaptiven Passwort-Hashing-Algorithmus anstelle von reinem SHA-256.