PHPアプリケーションにおける堅牢な二要素認証の実装ガイド
概要
今日のデジタル環境において、アカウントセキュリティの重要性はかつてなく高まっています。パスワードのみに依存した認証は、フィッシング、ブルートフォースアタック、パスワードリスト型攻撃などの脅威に対して脆弱であり、多くの情報漏洩事件の原因となっています。このような背景から、ユーザーアカウントのセキュリティを飛躍的に向上させる手段として、二要素認証（2FA: Two-Factor Authentication）の導入が不可欠となっています。
二要素認証は、「知っているもの」（パスワードなど）に加え、「持っているもの」（スマートフォン、ハードウェアトークンなど）や「生体情報」（指紋、顔認証など）といった、異なる種類の認証要素を組み合わせることで、セキュリティを強化する仕組みです。本記事では、PHPアプリケーションに最も広く普及している時間ベースワンタイムパスワード（TOTP: Time-based One-Time Password）方式の二要素認証を実装するための詳細なガイドを提供します。具体的な実装手順、推奨ライブラリの利用法、そして実運用における考慮事項までを網羅し、堅牢な認証システムを構築するための実践的な知識を共有します。
詳細解説
二要素認証の中核をなすTOTPは、RFC 6238で定義された標準規格であり、Google AuthenticatorやAuthyなどの認証アプリで広く利用されています。その原理は、共有された秘密鍵（Secret Key）と現在の時刻を基に、一定時間（通常30秒）のみ有効な使い捨てのパスワード（OTP: One-Time Password）を生成するというものです。このセクションでは、PHPアプリケーションでTOTPを実装するための具体的なステップと、その背後にある技術的詳細を解説します。
1. TOTPの基本原理
TOTPは、以下の要素に基づいてOTPを生成します。
- **秘密鍵（Secret Key）**: ユーザーごとに一意に生成されるランダムなバイト列です。これはサーバーと認証アプリ間で共有され、OTP生成の基盤となります。通常、Base32エンコード形式で表現されます。
- **時間ステップ（Time Step）**: OTPが有効である期間を定義します。一般的には30秒が使用されます。
- **カウンタ値**: 現在のUnixタイムスタンプを時間ステップで割った整数値です。これにより、時間とともに変化する一意の値が得られます。
これらの要素を基に、HMAC-SHA1などのハッシュ関数を用いてOTPが生成されます。認証時には、ユーザーが入力したOTPと、サーバー側で同じ秘密鍵と現在の時刻から生成したOTPを比較し、一致すれば認証成功となります。
2. 実装ライブラリの選定
PHPでTOTPを実装する際、ゼロから全てを自作することは、セキュリティ上のリスクや複雑性から推奨されません。既存の堅牢なライブラリを利用することが賢明です。ここでは、`spomky-labs/otphp` ライブラリを推奨します。これはTOTPおよびHOTP（HMAC-based One-Time Password）の生成・検証をサポートし、多くのプロジェクトで採用されている実績あるライブラリです。QRコード生成には、`chillerlan/php-qrcode` などのライブラリを組み合わせます。
3. 秘密鍵の生成と保存
二要素認証を有効にする最初のステップは、ユーザーごとにユニークな秘密鍵を生成することです。
- **生成**: `spomky-labs/otphp` ライブラリは、安全な秘密鍵を簡単に生成する機能を提供します。生成された秘密鍵はBase32エンコード形式で、認証アプリに登録するために使用されます。
- **保存**: 生成された秘密鍵は、ユーザーのデータベースレコードに安全に保存する必要があります。データベースへの保存時には、暗号化を施すことが強く推奨されます。AES-256などの堅牢な暗号化アルゴリズムを使用し、暗号化キーはアプリケーションの環境変数などで厳重に管理してください。秘密鍵が漏洩すると、二要素認証のセキュリティが完全に損なわれるため、データベースのアクセス制御や監査ログも徹底する必要があります。
4. QRコードの生成と表示
ユーザーが認証アプリに秘密鍵を登録する最も簡単な方法は、QRコードをスキャンしてもらうことです。QRコードには、`otpauth://` URIスキームで定義されたプロビジョニングURIが埋め込まれます。
プロビジョニングURIの形式は以下の通りです。
`otpauth://totp/{issuer}:{account_name}?secret={secret}&issuer={issuer}&digits={digits}&period={period}`
- `issuer`: アプリケーション名（例: MyApplication）
- `account_name`: ユーザーの識別子（例: ユーザーのメールアドレス）
- `secret`: Base32エンコードされた秘密鍵
- `digits`: OTPの桁数（通常6桁）
- `period`: 時間ステップ（通常30秒）
このURIを基に、`chillerlan/php-qrcode` などのライブラリを使用してQRコード画像を生成し、ユーザーに表示します。ユーザーはこのQRコードを認証アプリでスキャンするだけで、簡単にアカウントを登録できます。
5. OTPの検証
ユーザーがログイン時、または二要素認証の有効化を最終確認する際に、認証アプリで生成されたOTPを入力します。サーバー側では、データベースから取得した秘密鍵と現在の時刻を基にOTPを生成し、ユーザーが入力したOTPと比較します。
- **時間ずれの許容（Drift）**: サーバーと認証アプリの時刻が完全に同期しているとは限りません。このため、OTPの検証時には、現在の時刻から前後1〜2ステップ分のOTPも許容する「時間ずれ（drift）」を考慮することが一般的です。これにより、ユーザー体験を損なわずに堅牢性を維持できます。
- **ブルートフォース対策**: OTPの入力失敗回数に制限を設け、一定回数以上失敗した場合はアカウントを一時的にロックアウトするなどの対策を講じるべきです。
6. リカバリーコードの提供
ユーザーがスマートフォンを紛失したり、認証アプリを誤って削除したりした場合に備え、リカバリーコードを提供することが非常に重要です。
- **生成**: 二要素認証を有効にする際に、一回限りの使い捨てコードを複数（例: 5〜10個）生成します。これらのコードは、秘密鍵と同様にデータベースに安全に保存し、使用済みフラグを管理します。
- **提供**: 生成されたリカバリーコードは、ユーザーにダウンロード、印刷、または安全な場所にメモするよう促します。ユーザーがコードを紛失しないよう、注意喚起を徹底することが重要です。
- **管理**: 各リカバリーコードは一度しか使用できないように管理します。使用されたコードには「使用済み」のマークを付け、再利用できないようにします。
サンプルコード
ここでは、`spomky-labs/otphp` と `chillerlan/php-qrcode` を利用した二要素認証の基本的な実装フローを示します。
まず、Composerで必要なライブラリをインストールします。
