password_hash() dan password_verify() di PHP

Simpan password dengan password_hash($password, PASSWORD_DEFAULT) dan periksa login dengan password_verify($password, $hash), yang mengembalikan true atau false. Jangan pernah menyimpan password-nya sendiri, dan jangan pernah memakai md5() atau sha1() untuknya.

<?php
$hash = password_hash('correct horse battery staple', PASSWORD_DEFAULT);
echo $hash, "\n";

var_dump(password_verify('correct horse battery staple', $hash));
var_dump(password_verify('Correct horse battery staple', $hash));

Jalankan dua kali: hash-nya berbeda setiap kali, dan keduanya tetap lolos verifikasi. Hal yang sama berlaku untuk setiap hash di halaman ini, jadi output-mu tidak akan sama dengan milik orang lain.

Login dengan password_verify

Proses login memeriksa password yang dikirim terhadap hash yang disimpan saat akun dibuat. Blok ini "mendaftarkan" satu user lalu menampilkan form login; coba password yang benar (hunter2), lalu yang salah.

<?php
// The users table: one row, hashed when the account was created
$users = ['ada@example.com' => password_hash('hunter2', PASSWORD_DEFAULT)];

$email = trim((string) ($_POST['email'] ?? 'ada@example.com'));
$message = '';

if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST') {
    $hash = $users[$email] ?? null;
    if ($hash !== null && password_verify((string) ($_POST['password'] ?? ''), $hash)) {
        $message = 'Welcome back, ' . htmlspecialchars($email) . '.';
    } else {
        $message = 'Wrong email or password.';
    }
}
?>
<form method="post">
  <input name="email" value="<?= htmlspecialchars($email) ?>">
  <input name="password" type="password" placeholder="Password">
  <button>Log in</button>
</form>
<p><?= $message ?></p>

Pesan error-nya sama untuk email yang tidak dikenal dan password yang salah. Memberi tahu mana yang salah akan memberi tahu penyerang email mana yang punya akun. Setelah login berhasil, situs sungguhan menyimpan id user di session, seperti yang ditunjukkan di halaman session.

Apa yang ada di dalam hash

Hash bcrypt adalah satu string yang memuat semua yang dibutuhkan password_verify(): algoritma, cost, dan salt, diikuti hash-nya sendiri. password_get_info() membaca kembali bagian-bagian awalnya.

<?php
$hash = password_hash('secret', PASSWORD_DEFAULT);
echo $hash, "\n";
echo strlen($hash), " characters\n\n";

[, $algo, $cost, $rest] = explode('$', $hash);
echo "algorithm: $algo (bcrypt)\n";
echo "cost:      $cost\n";
echo 'salt:      ', substr($rest, 0, 22), "\n";
echo 'hash:      ', substr($rest, 22), "\n\n";

print_r(password_get_info($hash));

Karena salt disimpan di dalam hash, kamu hanya butuh satu kolom database, dan dua user dengan password yang sama tetap mendapat hash yang berbeda. Jadikan kolom itu VARCHAR(255): bcrypt berukuran 60 karakter, tetapi PASSWORD_DEFAULT boleh berubah menjadi algoritma dengan output yang lebih panjang.

Memilih cost

Cost adalah seberapa lambat setiap hash dibuat dengan sengaja, dan setiap kenaikan satu tingkat menggandakan pekerjaannya. PHP 8.3 memakai cost 10 untuk bcrypt (PHP 8.4 menaikkan default-nya menjadi 12). Proses login sebaiknya butuh kira-kira 100 sampai 300 ms untuk hashing; ukur waktunya di server-mu sendiri:

<?php
foreach ([10, 11, 12] as $cost) {
    $start = hrtime(true);
    password_hash('secret', PASSWORD_BCRYPT, ['cost' => $cost]);
    printf("cost %d: %.0f ms\n", $cost, (hrtime(true) - $start) / 1e6);
}

Angkanya bergantung pada mesinnya, tetapi setiap baris seharusnya kira-kira dua kali baris sebelumnya. Makin tinggi makin aman terhadap cracking dan makin lambat untuk setiap login, jadi pilih cost tertinggi yang masih sanggup ditanggung halaman login-mu.

Memperbarui hash lama dengan password_needs_rehash

Saat kamu menaikkan cost atau PHP mengubah PASSWORD_DEFAULT, hash yang sudah ada tetap berfungsi, dan password_needs_rehash() memberi tahu hash mana yang sudah usang. Satu-satunya saat kamu memegang password aslinya adalah ketika login, jadi di situlah kamu memperbaruinya:

<?php
$options = ['cost' => 12];

// A hash created years ago with cost 10
$stored = password_hash('hunter2', PASSWORD_DEFAULT, ['cost' => 10]);
echo 'stored: ', substr($stored, 0, 7), "...\n";

$input = 'hunter2';
if (password_verify($input, $stored)) {
    if (password_needs_rehash($stored, PASSWORD_DEFAULT, $options)) {
        $stored = password_hash($input, PASSWORD_DEFAULT, $options);
        echo "Rehashed and saved: ", substr($stored, 0, 7), "...\n";
    }
    echo "Logged in.\n";
}

var_dump(password_needs_rehash($stored, PASSWORD_DEFAULT, $options));

Prefix $2y$10$ berubah menjadi $2y$12$, dan pada login berikutnya password_needs_rehash() mengembalikan false.

Jangan pernah memakai md5 atau sha1 untuk password

md5() dan sha1() adalah hash umum yang cepat dan tanpa salt. Cepat justru salah untuk password: penyerang yang memegang tabel yang bocor bisa mencoba miliaran tebakan per detik dengan GPU, dan hash tanpa salt dari password yang umum sudah ada di tabel lookup publik. Bandingkan kecepatannya:

<?php
echo md5('password'), "\n";       // the same on every server, forever

$start = hrtime(true);
for ($i = 0; $i < 100000; $i++) {
    md5("password$i");
}
printf("100,000 md5 hashes: %.0f ms\n", (hrtime(true) - $start) / 1e6);

$start = hrtime(true);
password_hash('password', PASSWORD_DEFAULT);
printf("1 password_hash:    %.0f ms\n", (hrtime(true) - $start) / 1e6);

Dalam waktu yang dibutuhkan password_hash() untuk membuat satu hash, md5 membuat ratusan ribu, jadi setiap tebakan cracker jadi jauh lebih murah sebanyak itu. Cari 5f4dcc3b5aa765d61d8327deb882cf99 dan kamu akan langsung menemukan kata "password". Hash generator mengubah "password" menjadi md5 yang sama itu setiap kali.

Jika kamu mewarisi tabel berisi hash md5, kamu tidak bisa mengonversinya secara langsung. Bungkus saja: simpan password_hash($oldMd5) dan verifikasi dengan password_verify(md5($input), $stored), lalu ganti masing-masing dengan hash yang normal saat user itu login berikutnya.

Argon2id dan batas 72 byte

PASSWORD_ARGON2ID memakai lebih banyak memori per hash, yang membuat cracking dengan GPU jauh lebih mahal. Algoritma ini tersedia saat PHP di-build dengan libargon2 (sebagian besar paket Linux begitu); periksa dengan defined('PASSWORD_ARGON2ID').

<?php
if (defined('PASSWORD_ARGON2ID')) {
    $hash = password_hash('secret', PASSWORD_ARGON2ID);
    echo $hash, "\n";
    var_dump(password_verify('secret', $hash));
}

// bcrypt only looks at the first 72 bytes of the password
$a = str_repeat('a', 72) . 'X';
$b = str_repeat('a', 72) . 'Y';
var_dump(password_verify($b, password_hash($a, PASSWORD_BCRYPT)));

Baris terakhir mencetak bool(true): dua password yang berbeda dianggap cocok karena bcrypt mengabaikan semua yang ada setelah byte ke-72. Password sungguhan jarang sepanjang itu, tetapi passphrase dalam bahasa Jepang atau aksara multibyte lain mencapai 72 byte pada sekitar 24 karakter. Jika kamu mengizinkan password yang sangat panjang, pakai Argon2id, yang tidak punya batas seperti itu. password_verify() bekerja dengan kedua algoritma, jadi kamu bisa beralih dengan password_needs_rehash() seperti di atas.