PHP パスワードハッシュ化: Argon2id、bcrypt、および安全な移行
PHPでArgon2idとbcryptを使用してパスワードを安全にハッシュ化する方法を学び、安全なパラメータを選択し、認証情報を検証し、パスワードリセットを強制せずに既存のハッシュを移行します。
PHP パスワードハッシュ化: Argon2id, bcrypt と安全な移行
パスワードの保存は、ウェブアプリケーションにおける最も重要なセキュリティ上の決定の一つです。データベースの侵害によってユーザーの認証情報が直ちに露呈してはなりませんが、脆弱なパスワードハッシュ化は、盗まれたハッシュを低コストで攻撃可能にする可能性があります。
PHP には、パスワードのハッシュ化、検証、アップグレードのための組み込み関数が用意されています。課題は、適切なアルゴリズムを選択し、インフラストラクチャに合わせて設定し、認証を妨げることなく既存アカウントを移行することです。
新しいアプリケーションでは、PHP ビルドがサポートしている場合、一般に Argon2id が推奨される選択肢です。bcrypt は引き続き実用的な互換性オプションです。 両方とも、独自の暗号実装ではなく、PHP のパスワード API を介して使用する必要があります。
このガイドでは、実装、パラメータ選択、レガシー移行、一般的な誤りについて説明します。
SHA-256 がパスワード保存に適さない理由
SHA-256 は高速に動作するように設計されています。これは整合性チェックには有用ですが、パスワード保存に単独で使用するには適していません。盗まれたハッシュを持つ攻撃者は、多くのパスワード推測を迅速にテストできます。
専用のパスワードハッシュ化アルゴリズムは、意図的に多くのリソースを消費します。Argon2id は処理時間に加えて大量のメモリを必要とする場合があり、大規模な推測をより高価にします。
安全な保存システムには、ユニークなランダムソルト、設定可能なワークファクタ、およびハードウェアの改善に伴ってワークファクタを増やす方法が必要です。PHP の password_hash() は、必要なソルト情報を自動的に生成および保存します。
OWASP Password Storage Cheat Sheet は、高速な汎用ハッシュ関数ではなく、適応型パスワードハッシュ化を推奨しています。
Argon2id と bcrypt: どちらを選択すべきか?
| 機能 | Argon2id | bcrypt |
|---|---|---|
| 主な防御 | メモリと計算コスト | 計算コスト |
| メモリハード | はい | いいえ |
| 設定可能なパラメータ | メモリ、反復回数、並列性 | コストファクタ |
| パスワード入力制限 | bcrypt スタイルの 72 バイト制限なし | 72 バイト |
| PHP における可用性 | ビルドに依存 | 広く利用可能 |
| 最適な用途 | 新しいパスワード保存に推奨 | 互換性およびレガシーシステム |
Argon2id は、大規模並列ハードウェアから恩恵を受ける攻撃に対抗するように設計されています。bcrypt は依然として正当な適応型パスワードハッシュ化アルゴリズムですが、その入力制限には注意が必要です。最初の 72 バイトまでを考慮し、文字ではありません。
PASSWORD_DEFAULT が Argon2id を選択すると想定しないでください。 PHP password_hash ドキュメント では、現在、bcrypt がデフォルトのアルゴリズムとして文書化されています。PHP 8.4 は bcrypt のデフォルトコストを 10 から 12 に引き上げ、暗黙のパラメータに依存するとアップグレード後にアプリケーションのパフォーマンスが変わる可能性があることを示しています。
ステップ 1: Argon2id のサポートを確認する
Argon2id はすべてのホスティング環境で利用可能とは限りません。選択する前にランタイムを確認してください。
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
可用性は PHP のビルド方法に依存します。PHP バージョンのアップグレードが自動的に Argon2id を有効にすると想定しないでください。
ステップ 2: Argon2id でパスワードをハッシュ化する
OWASP は複数の受け入れ可能なベースライン設定を文書化しています。その一つは、メモリ 19 MiB、反復回数 2、並列性 1 を使用します。PHP は memory_cost を KiB で表現するため、19 MiB は 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
);
並列性オプション threads は、libargon2 を含む一部の Argon2 バックエンドでサポートされていますが、すべての PHP ビルドでサポートされているわけではありません。サポートされている場合、値 1 はこのベースラインに一致します。省略すると移植性が高くなります。実際の設定をベンチマークしてください。
生成されたエンコード済みハッシュには、アルゴリズム識別子、パラメータ、ソルトが含まれます。これらの値を別々のデータベース列に保存する必要はありません。VARCHAR(255) 列は、現代的なパスワードハッシュの妥当な出発点です。ただし、エンコードされた値全体を格納する必要があります。
これらはベースラインパラメータであり、汎用的な本番環境設定ではありません。 現実的な同時認証トラフィック下で、レイテンシとメモリ使用量をテストしてください。
ステップ 3: 認証情報を正しく検証する

各パスワードハッシュにはランダムなソルトが使用されるため、新しいハッシュを生成して文字列を比較しても機能しません。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 ドキュメント は、password_verify() がタイミング攻撃に対して安全であると規定しています。保存済みハッシュからアルゴリズムとワークパラメータを読み取ります。
パスワード検証は、ログイン制限、安全なセッション、HTTPS、適切なエラー処理、多要素認証の代わりにはなりません。
ステップ 4: ログイン時に既存のパスワードハッシュをアップグレードする
password_needs_rehash() は、保存済みハッシュが古いアルゴリズムまたはパラメータを使用していることを検出します。これにより、すべてのアクティブユーザーにパスワードのリセットを強制することなく、段階的な移行が可能になります。
<?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.
}
送信されたパスワードが正常に検証された 後 のみ、再ハッシュ化してください。条件付き更新により、保存済みハッシュが検証された値とまだ一致していることを保証できます。たとえば、ユーザー ID と古いハッシュの両方が一致する場合にのみパスワードハッシュを更新します。
API の詳細は、PHP password_needs_rehash() を参照してください。
ステップ 5: レガシー MD5 または SHA-1 ハッシュを移行する
旧型アプリケーションには MD5、SHA-1、またはカスタムのパスワード形式が含まれている場合があります。このようなハッシュは、password_verify() で常に検証できるとは限りません。
移行は制御された手順に従う必要があります:
- 信頼できるメタデータまたは明確に文書化された形式を使用して、レガシー形式を特定する。
- 依然としてレガシー形式が必要なアカウントに対してのみ、元のレガシー方式を使用して送信されたパスワードを検証する。
- 正常に検証された後、直ちに
password_hash()を使用して現代的なハッシュを作成する。 - 安全なデータベース更新を使用して、保存済みのレガシーハッシュを置き換える。
- 移行が完了したら、レガシー検証を廃止する。
複数の形式が考えられる場合、ハッシュの長さだけからアルゴリズムを推測しないでください。パスワードハッシュを復号化しようとしないでください。ハッシュ化は暗号化ではありません。
ログインしないアカウントについては、脆弱なハッシュを無期限に保持する代わりに、パスワードリセットポリシーを検討してください。新規登録ユーザーが脆弱なハッシュを受け入れる安全でないフォールバックパスを導入しないでください。
ステップ 6: インフラストラクチャ上でハッシュ化をベンチマークする
適切なコストパラメータは、ハードウェア、同時ログインボリューム、レイテンシ要件に依存します。
<?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';

これを公開ウェブエンドポイントではなく、制御された環境でのみ実行してください。検証も測定し、代表的な負荷下で繰り返してください。単独では高速に見える設定でも、多くのリクエストが同時に到着すると RAM を使い果たす可能性があります。
OWASP は、セキュリティと運用能力のバランスを取り、個々のハッシュ化操作を一般に 1 秒未満に保つことを推奨しています。
一般的なパスワードハッシュ化の誤り
固定ソルトを手動で追加する。 PHP はすでにパスワード API のために安全なソルトを生成しています。固定ソルトは重要な保護を無効にします。
生の MD5、SHA-1、または SHA-256 を使用する。 これらのアルゴリズムは、パスワード保存に単独で使用するには高速すぎます。
bcrypt の 72 バイト制限を無視する。 マルチバイト UTF-8 文字は、ユーザーが想定するよりも早くこの制限に達する可能性があります。
極端なコスト設定を選択する。 過剰なメモリまたは CPU 要件は、認証エンドポイントでサービス拒否のリスクを生み出す可能性があります。
送信されたパスワードをログに記録する。 デバッグログ、監視システム、エラーレポートを通じて認証情報が公開されないようにしてください。
パスワードハッシュ化が認証セキュリティを解決すると想定する。 レート制限、侵害対応、セッションセキュリティ、多要素認証は依然として重要です。
ペッパーを使用すべきか?
ペッパーは、パスワードデータベースの外部に保持される追加の共有秘密です。ソルトとは異なり、各ハッシュとともに保存されません。
適切に設計されたペッパーは、攻撃者がデータベースのみを盗んだ場合に防御の深化を提供できます。しかし、ペッパーはキー管理とローテーションの複雑さをもたらします。ペッパーを紛失またはローテーションすると、パスワードのリセットが必要になる場合があります。
ハードコードされた秘密をすべてのパスワードに連結するような即興の対応はしないでください。文書化された戦略に従い、秘密を別々に保存し、ローテーションを計画してください。OWASP は、ハッシュ前およびハッシュ後のペッパーアプローチについて説明しています。
実用的なパスワードハッシュ化ポリシー
新しい PHP アプリケーションでは、利用可能な場合に Argon2id を優先し、OWASP に準拠した設定から始め、ベンチマークを実施し、エンコードされたハッシュ全体を保存してください。Argon2id が利用できない場合、bcrypt を PHP のパスワード API を介して使用することは、そのコストと入力制限を理解していれば実用的な代替手段となります。
既存のアプリケーションでは、サポートされているレガシーハッシュの検証を継続し、正常な認証後にそれらをアップグレードしてください。元のパスワードが入手できない場合は、破壊的な移行を避けてください。
最初からアップグレードを想定して設計してください。 ハードウェアと推奨事項は変化します。認証システムは、すべてのユーザーのパスワードを一度に変更することなく、より優れたパラメータとアルゴリズムを採用できるようにする必要があります。
よくある質問
Argon2id は bcrypt より優れていますか?
Argon2id は設定可能なメモリハード性を提供し、新しいパスワード保存実装に対する OWASP の推奨選択肢です。
PHP はデフォルトで Argon2id を使用しますか?
いいえ。PHP の PASSWORD_DEFAULT は現在、bcrypt を選択します。サポートされている場合は、PASSWORD_ARGON2ID を明示的に使用してください。
bcrypt ハッシュをパスワードリセットなしで移行できますか?
はい。既存のハッシュを検証し、その後、正常なログイン後に送信されたパスワードを再ハッシュ化してください。
ソルトを別々に保存すべきですか?
いいえ。PHP のパスワードハッシュ化 API はソルトを生成し、必要な情報をエンコード済みハッシュに保存します。
SHA-256 はパスワードに安全ですか?
単独では安全ではありません。生の SHA-256 ではなく、専用の適応型パスワードハッシュ化アルゴリズムを使用してください。