
News Observation Lab for Future
SMS OTP を利用したシンプルな二段階認証ログインの実装とコンプライアンス考慮点

概要
シンプルな 2FA ログインでは、まず専用の SMS OTP フローを使用し、例外的な通知は直接 SMS 送信で対応します。OTP エンドポイントはコードの生成と照合を担い、同意レコードや有効期限ポリシー、再送信タイマー、ロックアウト、監査証跡はアプリケーション側で保持します。
コンプライアンスと監査
審査では、ログイン試行・受信者・検証結果・保持決定を紐付けることが重要です。最小のトレースを構築し、配信とサポートの結果を測定することで、証拠が判断軸となります。
リクエストフロー
ログインサービスはパスワードを認証し、相関 ID を作成して OTP サービスへコード送信を依頼します。必要な相関メタデータのみを保存し、テナントがコードを送信したら同じ宛先とコードを検証エンドポイントへ送ります。成功すればセッションが継続し、失敗すれば試行カウンタが増加します。
実装上の留意点
– リクエスト ID、電話ハッシュ、タイムスタンプ、検証結果を永続化
– コードは記録せず、有効期限と再送信ウィンドウを独自ポリシーで設定
– 閾値を超えると試行を拒否し、ロックアウト情報をツールに表示
– 冪等性キーでネットワーク再試行が二重の論理アクションにならないようにする
検証パスとテストマトリックス
3 つの検証済みパスを用いた Python スケッチが提示されています。テスト項目は新しいデバイス、誤コード、期限切れコード、再送信、繰り返し失敗、電話番号変更、プロバイダータイムアウトなどです。各ケースで相関 ID を取得し、電話番号とコードはログに残しません。
直接送信のエッジケース
「電話番号が変更されました」等の回復通知はログインチャレンジではないため、カスタム本文やテンプレート変数、別の承認レコードが必要です。/v1/sms/send エンドポイントを使用し、個別の冪等キーと送信理由を示す監査イベントを添付します。
プロバイダー比較と選定指針
Twilio Verify、Vonage Verify、Bird(旧 MessageBird)などのマネージド検証製品は、ダッシュボードや保持管理、契約条件が異なります。コンプライアンス要件に合わせて比較検討してください。Infrai の統合オプションは、単一キーと単一請求書で複数バックエンドを配線でき、小規模 Python ワーカー向けに SDK 不要の REST API を提供します。
メールチャネルとその他制限
メールは現在ドロップインのフォールバックではなく、独自のコード生成と照合が必要です。SMTP リレーや音声・WhatsApp・RCS チャネルは提供されておらず、国内メールベンダーはコンプライアンス上の制限があります。これらはバグではなく設計上の制限として記録します。
まとめと推奨
通常のログインは OTP エンドポイントを使用し、明確にラベル付けされたカスタム通知は直接送信します。リスクや地域の義務がバックエンドの監視範囲を超える場合は、より強力な組み込み制御を備えたプロバイダーを選択してください。検証アダプターを単一インターフェイスの背後に分離し、ベンダー中立の証拠フィールドを保持することで、決定を可逆的に保ちます。