PHP Parola Hashleme: Argon2id, bcrypt ve Güvenli Göç
PHP'de Argon2id ve bcrypt kullanarak parolaları güvenli bir şekilde hash'lemeyi, güvenli parametreleri seçmeyi, kimlik bilgilerini doğrulamayı ve mevcut hash'leri zorunlu parola sıfırlamaları olmadan göç ettirmeyi öğrenin.
PHP Şifre Hashing: Argon2id, bcrypt ve Güvenli Geçiş
Şifre depolama, bir web uygulamasında en önemli güvenlik kararlarından biridir. Veritabanı ihlali, kullanıcı kimlik bilgilerini hemen açığa çıkarmamalıdır, ancak zayıf şifre hashleme, çalınan hashlerin ucuz bir şekilde saldırıya açık hale gelmesine neden olabilir.
PHP, şifrelerin hashlenmesi, doğrulanması ve yükseltilmesi için yerleşik işlevler sunar. Zorluk, doğru algoritmayı seçmek, altyapınıza göre yapılandırmak ve kimlik doğrulamasını kesintiye uğratmadan mevcut hesapları geçirmektir.
Yeni uygulamalar için Argon2id, PHP derlemeniz desteklediği sürece genellikle tercih edilen seçimdir. bcrypt, pratik bir uyumluluk seçeneği olarak kalır. İkisi de kendi geliştirdiğiniz kriptografi yerine PHP'nin şifre API'si üzerinden kullanılmalıdır.
Bu kılavuz, uygulama, parametre seçimi, eski sistem geçişi ve yaygın hataları kapsar.
Neden SHA-256 şifre depolaması için uygun değildir
SHA-256 hızlı çalışacak şekilde tasarlanmıştır. Bütünlük denetimleri için kullanışlıdır ancak tek başına şifre depolaması için uygun değildir: çalınan hashlere sahip bir saldırgan, birçok şifre tahminini hızlı bir şekilde test edebilir.
Özel şifre hashleme algoritları bilinçli olarak daha fazla kaynağı tüketir. Argon2id, işlem süresinin yanı sıra önemli miktarda bellek gerektirebilir, böylece büyük ölçekli tahmin maliyetli hale gelir.
Güvenli bir depolama sistemi, benzersiz rastgele bir tuz, yapılandırılabilir bir çalışma faktörüne ve donanım geliştiği kadar çalışma faktörünü artırma yöntemine ihtiyaç duyar. PHP'nin password_hash() gerekli tuz bilgilerini otomatik olarak üretir ve saklar.
The OWASP Password Storage Cheat Sheet recommends adaptive password hashing rather than fast general-purpose hash functions.
OWASP Şifre Depolama Karşılama Sayfası, hızlı genel amaçlı hash işlevleri yerine uyarlamalı şifre hashlemeyi önerir.
Argon2id karşıt bcrypt: hangisini seçmelisiniz?
| Özellik | Argon2id | bcrypt |
|---|---|---|
| Ana savunma | Bellek ve işlem maliyeti | İşlem maliyeti |
| Bellek ağırlıklı | Evet | Hayır |
| Yapılandırılabilir parametreler | Bellek, iterasyon, paralelizm | Maliyet faktörü |
| Şifre girişi sınırı | bcrypt tarzı 72 bayt sınırı yok | 72 bayt |
| PHP'de kullanılabilirlik | Derlemeye bağlı | Geniş çapta mevcut |
| En iyi uyum | Yeni şifre depolaması için tercih edilir | Uyumluluk ve eski sistemler |
Argon2id, büyük ölçekli paralel donanımdan faydalanan saldırılara karşı dayanıklı olacak şekilde tasarlanmıştır. bcrypt, hala geçerli bir uyarlamalı şifre hashleme algoritmasıdır, ancak giriş sınırı dikkat gerektirir: en fazla ilk 72 baytı dikkate alır, karakterleri değil.
PASSWORD_DEFAULT'ın Argon2id seçtiğini varsaymayın. The PHP password_hash documentation currently documents bcrypt as its default algorithm. PHP 8.4 raised bcrypt's default cost from 10 to 12, illustrating why relying on implicit parameters can change application performance after upgrades.
PHP password_hash belgeleri şu anda bcrypt'i varsayılan algoritma olarak belgelemektedir. PHP 8.4, bcrypt'in varsayılan maliyetini 10'dan 12'ye yükseltmiştir; bu da örtük parametrelere güvenmenin güncellemelerden sonra uygulama performansını değiştirebileceğini göstermektedir.
1. Adım: Argon2id desteğini kontrol edin
Argon2id her barındırma ortamında gerekli olmayabilir. Seçmeden önce çalışma zamanını kontrol edin:
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
Kullanılabilirlik, PHP'nin nasıl derlendiğine bağlıdır. PHP sürümünün yükseltilmesinin otomatik olarak Argon2id'i etkinleştireceğini varsaymayın.
2. Adım: Argon2id ile bir şifreyi hashleyin
OWASP documents several acceptable baseline configurations. One uses 19 MiB of memory, two iterations and parallelism of one. PHP expresses memory_cost in KiB, so 19 MiB is 19 * 1024 KiB.
OWASP, birkaç kabul edilebilir temelle yapılandırma belgelemektedir. Birinde 19 MiB bellek, iki iterasyon ve bir paralelizm kullanılır. PHP memory_cost'i KiB olarak ifade eder, bu yüzden 19 MiB, 19 * 1024 KiB'dir.
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
$password = 'example-user-password';
$hash = password_hash(
$password,
PASSWORD_ARGON2ID,
$options
);
The parallelism option threads is supported with some Argon2 backends, including libargon2, but not every PHP build. If supported, a value of one matches this baseline; omitting it is more portable. Benchmark your actual configuration.
Paralellik seçeneği threads, libargon2 dahil bazı Argon2 arka uçları tarafından desteklenir, ancak her PHP derlemesi tarafından desteklenmez. Destekleniyorsa, bir değeri bu temele uygun; atlamak daha taşınabilir olduğu içindir. Gerçek yapılandırmanızı ölçün.
The resulting encoded hash includes the algorithm identifier, parameters and salt. There is no need to save those values in separate database columns. A VARCHAR(255) column is a reasonable starting point for modern password hashes, provided it stores the entire encoded value.
Oluşan kodlanmış hash, algoritma tanımlayıcısını, parametreleri ve tuzu içerir. Bu değerleri ayrı veritabanı sütunlarında kaydetmenize gerek yoktur. Tüm kodlanmış değeri sakladığı sürece, modern şifre hashleri için VARCHAR(255) sütunu makul bir başlangıç noktasıdır.
Bu, temel parametrelerdir, evrensel bir üretim yapılandırması değildir. Test latency and memory usage under realistic concurrent authentication traffic.
Gerçekçi eşzamanlı kimlik doğrulama trafiği altında gecikme ve bellek kullanımını test edin.
3. Adım: Kimlik bilgilerini doğru şekilde doğrulayın

Her şifre hash'i rastgele bir tuz kullandığından, yeni bir hash üretip dizeleri karşılaştırmak işe yaramaz. password_verify()'ı kullanın:
<?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.
The PHP documentation specifies that password_verify() is safe against timing attacks. It reads the algorithm and work parameters from the stored hash.
PHP belgeleri, password_verify()'ın zamanlama saldırılarına karşı güvenli olduğunu belirtir. Saklanan hash'ten algoritma ve çalışma parametrelerini okur.
Password verification does not replace login throttling, secure sessions, HTTPS, appropriate error handling or multifactor authentication.
Şifre doğrulaması, giriş hız sınırlaması, güvenli oturumlar, HTTPS, uygun hata işleme veya çok faktörlü kimlik doğrulamasının yerini geçmez.
4. Adım: Mevcut şifre hash'lerini giriş sırasında yükseltin
password_needs_rehash() detects when a stored hash uses an outdated algorithm or parameters. This enables gradual migration without forcing every active user to reset their password.
password_needs_rehash(), saklanan hash'in eski bir algoritma veya parametre kullandığını tespit eder. Bu, her etkin kullanıcıyı şifre sıfırlamaya zorlamadan aşamalı bir geçişi mümkün kılar.
<?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.
}
Only rehash after successfully verifying the submitted password. A conditional update can ensure the stored hash still matches the value that was just verified. For example, update the password hash only where both the user ID and old hash match.
Gönderilen şifrenin başarıyla doğrulanmasının sonra yeniden hashleyin. Koşullu bir güncelleme, saklanan hash'in henüz doğrulanılan değeriyle eşleştiğinden emin olabilir. Örneğin, kullanıcı kimliği ve eski hash'in her ikisi de eşleştiği durumlarda şifre hash'ini güncelleyin.
See PHP password_needs_rehash() for API details.
API ayrıntıları için PHP password_needs_rehash()'ne bakın.
5. Adım: Eski MD5 veya SHA-1 hash'lerini geçirin
Eski uygulamalar MD5, SHA-1 veya özel şifre formatları içerebilir. Bu tür hash'ler her zaman password_verify() ile doğrulanamayabilir.
Bir geçiş, kontrol edilen bir sırayı izlemelidir:
- Güvenilir meta verileri veya belirsiz olmayan, belgelenmiş bir formatı kullanarak eski formatı belirleyin.
- Gönderilen şifreyi, hala gerekli olan hesaplar için yalnızca orijinal eski şema ile doğrulayın.
- Başarılı doğrulamanın ardından,
password_hash()kullanarak hemen modern bir hash oluşturun. - Güvenli bir veritabanı güncellemesi kullanarak saklanan eski hash'i değiştirin.
- Geçiş tamamlandığında eski doğrulama işlemi sonlandırın.
Birden fazla format mümkün olduğunda algoritmayı yalnızca hash uzunluğundan tahmin etmeyin. Şifre hash'lerini şifre çözmeye çalışmayın: hashleme şifrelemedir.
Hiç giriş yapmayan hesaplar için, zayıf hash'leri sonsuraya kadar tutmak yerine bir şifre sıfırlama politikası düşünün. Yeni kayıt olan kullanıcılar için zayıf hash'leri kabul eden güvensiz bir geri dönüş yolu eklemeyin.
6. Adım: Altyapınızda hashleme performansını ölçün
Doğru maliyet parametreleri, donanımınıza, eşzamanlı giriş hacmine ve gecikme gereksinimlerinize bağlıdır.
<?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';

Bu, yalnızca kontrol edilen bir ortamda çalıştırın, herkese açık bir web uç noktası olarak değil. Doğrulamayı da ölçün ve temsil eden yük altında tekrarlayın. İzolasyonda hızlı görünen bir ayar, birçok istek birlikte geldiğinde RAM'i tüketebilir.
OWASP, güvenliği operasyonel kapasite ile dengelemeler ve genellikle tek tek hashleme işlemlerinin bir saniyenin altında kalmasını önerir.
Yaygın şifre hashleme hataları
Sabit bir tuzu elle eklemek. PHP, şifre API'si için zaten güvenli tuzlar üretir. Sabit bir tuz, önemli bir korumayı kaldırır.
Ham MD5, SHA-1 veya SHA-256 kullanmak. Bu algoritmalar, tek başına şifre depolama için çok hızlıdır.
bcrypt'ın 72 bayt sınırını görmezden gelmek. Çok baytlı UTF-8 karakterleri, kullanıcıların beklediğinden daha erken bu sınırı aşıyor olabilir.
Aşırı maliyet ayarları seçmek. Fazla bellek veya CPU talebi, kimlik doğrulama uç noktalarında hizmet reddi riski oluşturabilir.
Gönderilen şifreleri günlüğe kaydetmek. Kimlik bilgilerini hata ayıklama günlükleri, izleme sistemleri veya hata raporları üzerinden açığa çıkarmaktan kaçının.
Şifre hashleme sorunu çözer varsaymak. Hız sınırlaması, ihlal yanıtı, oturum güvenliği ve çok faktörlü kimlik doğrulama hala önemlidir.
Pepper kullanmalı mısınız?
Bir pepper, şifre veritabanının dışında tutulan ek bir paylaşılan gizli bilgidir. Bir tuz gibi, her hash ile beraber saklanmaz.
Düzgün tasarlanmış bir pepper, saldırgan yalnızca veritabanını çalar ise derinlemiş savunma sağlayabilir. Ancak pepper, anahtar yönetimi ve döndürme karmaşıklığı getirir: bir pepper'ı kaybetmek veya döndürmek şifre sıfırlamayı gerektirebilir.
Her şifreye sabit kodlanmış bir gizli bilgi ekleyerek ad hoc çözüm üretmeyin. Belgelenmiş bir strateji izleyin, gizli bilgileri ayrı bir yerde saklayın ve döndürme planı yapın. OWASP, hash öncesi ve hash sonrası pepper yaklaşımlarını tartışır.
Pratik bir şifre hashleme politikası
Yeni bir PHP uygulaması için, Argon2id mevcut olduğunda tercih edin, OWASP ile uyumlu bir yapılandırmayla başlayın, performansını ölçün ve tam kodlanmış hash'i saklayın. Argon2id kullanılamıyorsa, maliyeti ve giriş sınırını anlamışsanız, PHP'nin şifre API'si üzerinden bcrypt pratik bir alternatiftir.
Mevcut bir uygulama için, desteklenen eski hash'leri doğrulamaya devam edin ve başarılı kimlik doğrulamasının ardından yükseltin. Orijinal şifre mevcut olmadığında kesintiye uğratan geçişlerden kaçının.
Başlangıçtan itibaren yükseltmelere yönelik tasarım yapın. Donanım ve öneriler değişir; kimlik doğrulama sisteminiz, her kullanıcının şifresini bir anda değiştirmeden daha iyi parametreleri ve algoritmaları benimseyebilmelidir.
Sık sorulan sorular
Argon2id, bcrypt'ten daha iyi midir?
Argon2id, yapılandırılabilir bellek zorluğu sunar ve OWASP'nin yeni şifre depolama uygulamaları için tercih ettiği seçimdir.
PHP varsayılan olarak Argon2id mi kullanır?
Hayır. PHP'nin PASSWORD_DEFAULT şu anda bcrypt'i seçer. Desteklendiğinde PASSWORD_ARGON2ID'ı açıkça kullanın.
bcrypt hash'lerini şifre sıfırlamadan geçirebilir miyim?
Evet. Mevcut hash'i doğrulayın, ardından başarılı bir girişin ardından gönderilen şifreyi yeniden hashleyin.
Tuzu ayrı bir yerde saklamalı mıyım?
Hayır. PHP'nin şifre hashleme API'si tuzu üretir ve gerekli bilgiyi kodlanmış hash'de saklar.
SHA-256 şifreler için güvenli midir?
Tek başına değil. Ham SHA-256 yerine özel bir uyarlamalı şifre hashleme algoritması kullanın.