Phone-VerifがWhatsApp電話番号認証を守る仕組み
Phone-VerifがWhatsApp電話番号認証をどのように保護しているかを、多層防御の観点から解説します。認証付きwebhookや高エントロピーのトークンから、プライバシーを守るエンドポイントや厳格なアクセス制御まで取り上げます。

ログイン、サインアップ、パスワード再設定、二要素認証のどのフローも、最終的には1つの前提に依存しています。認証を完了する人が、名乗っている電話番号を実際に管理している、という前提です。
Phone-Verifは、この前提を守ることを中心に構築されています。セキュリティを後回しにするのではなく、認証フローのあらゆる部分を、攻撃対象領域を最小限に抑え、一般的な不正利用に対抗できるように設計しました。
従来のSMS OTPのフローでは、ユーザーが秘密のコードを受け取り、アプリケーション間で手作業で転記します。Phone-Verifはこれと異なり、ユーザー自身が送信するWhatsAppメッセージを管理権の証明として使います。これにより、多くのOTPフローをフィッシング、ソーシャルエンジニアリング、コード傍受攻撃に対して脆弱にしている、コピー&ペーストの手順がなくなります。
Phone-Verifは、WhatsAppを使って番号を逆方向に認証します。ワンタイムコードを送ってユーザーに入力し返してもらうのではなく、ユーザーが入力済みのWhatsAppメッセージを送信します。当社は、その受信メッセージから直接、所有を検証します。
セキュリティは、単一の機能から生まれるものではありません。多数の独立した保護を、認証フロー全体にわたって一貫して適用することで実現します。
当社のセキュリティ原則
Phone-Verifは多層防御のアプローチを採用しています。すべての認証リクエストは、それぞれ異なる種類の攻撃を緩和するよう設計された、複数の独立したセキュリティ制御を通過します。1つの制御が万一機能しなくなっても、他の制御が認証フローを守り続けます。
サービス全体を通じて、いくつかの一貫した原則に従っています。
まず認証する
すべてのリクエストは、信頼する前に認証されます。
本物のランダム性
秘密情報には、暗号学的に安全な乱数を使用します。
何も明かさない
未認証のユーザーに分かる情報は、可能な限り最小限にします。
安全側に倒す
インフラの状態が不確かなときは、安全な方を選びます。
短い有効期間
認証の有効期間は、意図的に短く設定しています。
厳格な分離
顧客のデータと環境は、互いに分離して管理します。
防御の対象
Phone-Verifは、電話番号認証システムに対して一般的に見られる攻撃を緩和するよう設計されています。各脅威には、専用の対策が対応しています。
偽造されたWhatsApp webhook
すべての受信リクエストでHMAC-SHA256署名を検証します。
ブルートフォースによるトークンの推測
47.6ビットのトークンに加え、指数関数的バックオフと一時的なロックアウトを適用します。
トークンの列挙
有効なトークンと無効なトークンで、まったく同じレスポンスを返します。
リプレイ攻撃
1回限り有効なセッションと、短時間での自動失効を採用しています。
オープンリダイレクトを使ったフィッシング
コールバックURLはセッション作成時に固定され、後から受け付けることはありません。
他の顧客のデータへのアクセス
APIキーは所有者にスコープが限定され、セッションごとに所有権をチェックします。
エンドポイントの自動化された悪用
送信者ごとのレート制限と、継続的な不正利用の監視を行います。
どのようなセキュリティシステムも、あらゆるリスクを完全になくすことはできません。しかし当社は、攻撃者に公開される情報を最小限に抑えつつ、攻撃を計算上実行不可能にすることを目指しています。
Phone-Verifのお客様にとっての意味
セキュリティ対策は、Phone-Verifを利用する企業にとって実際の保証につながって初めて意味を持ちます。当社のセキュリティの取り組みにより、次のことが保証されます。
- ユーザーは、管理していない電話番号を認証できません。
- 認証結果にアクセスできるのは、セッションを作成した顧客だけです。
- 認証リンクが、オープンリダイレクトやフィッシングの手段として悪用されることはありません。
- 期限切れの認証試行を再利用することはできません。
- インフラの障害によって、無効な認証試行が誤って承認されることはありません。
これらの保護により、企業はPhone-Verifを、認証、アカウント復旧、電話番号ベースのIDフローのための信頼できる構成要素として利用できます。
認証付きwebhook
WhatsApp Business Platformから受信するすべてのwebhookは、処理される前に認証されます。各リクエストには、Metaが当社のアプリケーションシークレットを使って計算したHMAC-SHA256署名を含むX-Hub-Signature-256ヘッダーが付いています。ペイロードを処理する前に、当社はリクエストの生のボディに対して署名を独自に再計算します。
実装上、いくつかの詳細が重要です。
- 署名は、パースが行われる前の生のリクエストバイト列に対して検証します。
- 署名の比較は定数時間で行われ、タイミング攻撃を防ぎます。
- 署名がない、または無効なリクエストは、ビジネスロジックが実行される前に拒否されます。
これにより、攻撃者が当社のwebhookエンドポイントを直接呼び出して、認証イベントを偽造することはできません。
高エントロピーの認証トークン
各認証セッションには、大文字小文字を区別する英数字62文字のアルファベットから生成した8文字のトークンが割り当てられ、約2.2 × 10¹⁴通りの値(47.6ビットのエントロピー)を持ちます。
トークンは、汎用の疑似乱数関数ではなく、暗号学的に安全な乱数生成器を使って生成します。さらに棄却サンプリングを用いて、すべての文字が等しい確率で選ばれるようにし、実質的な探索空間を狭めかねない統計的な偏りを避けています。
トークンの有効期間の短さやレート制限と組み合わせることで、総当たりによる推測は計算上実行不可能になります。
1回限りの認証
認証セッションは1回限り有効です。セッションが正常に完了すると、同じWhatsAppメッセージやトークンを使って再度認証することはできません。これによりリプレイ攻撃を防ぎ、使用済みの認証メッセージで別の操作を承認できないようにします。
トークンの列挙を防ぐ
強力なトークンが有効に機能するのは、攻撃者が有効なトークンを言い当てたかどうかを判別できない場合だけです。当社の公開トラッキングエンドポイントは、トークンが存在するかどうかにかかわらず、意図的に同じ動作をします。
未知のトークンと、有効だが未認証のトークンとでは、レスポンス、リダイレクト、HTTPステータスコード、WhatsAppのクローラー向けのプレビューページがすべて同一です。攻撃者から見て、有効なトークンと無効なトークンとのあいだに観測できる違いはありません。
コールバックの宛先は非公開のまま
トラッキングリンクがブラウザを最終的にどこへ送るかは、セッションの認証状態だけで決まります。認証が正常に完了するまでは、有効なトークンと無効なトークンの動作は同一で、どちらも中立的な宛先に誘導されます。
顧客のコールバックURLが明かされるのは、認証が正常に完了した後だけです。これにより、攻撃者が認証トークンを試して顧客のインフラを探り出すことを防ぎます。
オープンリダイレクトなし
認証済みのユーザーを転送する際、Phone-Verifは常に、認証セッションの作成時に記録されたコールバックURLを使用します。後続のリクエストで指定されたコールバックの宛先は、一切受け付けません。これにより、攻撃者が、正規のユーザーを自らの管理する宛先にリダイレクトする悪意あるリンクを作成することを防ぎます。
認証結果は非公開のまま
WhatsAppからトラッキングリンクを開くユーザーは認証されていないため、トラッキングリンクは意図的に匿名にしています。電話番号や認証ステータスを含む認証結果は、公開エンドポイントを通じて公開されることはありません。
アクセスには有効なAPIキーが必要で、すべてのリクエストについて、認証された顧客が要求されたセッションを所有しているかを確認します。他の顧客のセッションは、識別子が知られていてもアクセスできません。
最小権限のアクセス制御
Phone-Verifは、アーキテクチャ全体を通じて最小権限の原則に従っています。各コンポーネントがアクセスできるのは、その役割に必要なデータと操作だけです。
APIキーは所有する顧客にスコープが限定され、内部サービスは責務ごとに分離され、認証データへのアクセスは設計上制限されています。不要なアクセスを制限することで、ミスやセキュリティインシデントが起きた場合の影響を抑えます。
ブルートフォース対策
認証トークンは計算上推測が実行不可能ですが、Phone-Verifは自動化された不正利用に対する追加の保護も適用しています。無効または不正な形式のトークンを繰り返し送信する送信者には、指数関数的バックオフによって段階的に遅延が課され、不正な動作が続く場合は一時的にロックアウトされます。
カウンターは送信者ごとに保持され、時間の経過とともに自動的に失効するため、たまたま起きた入力ミスが正規のユーザーに悪影響を及ぼすことはありません。
転送中の暗号化
Phone-Verifとのすべての通信は、最新のTLSを使ったHTTPSで行われます。APIリクエスト、トラッキングリンク、webhookの配信、顧客へのコールバックは、転送中に暗号化され、ネットワーク上での傍受や改ざんから保護されます。
継続的な監視
認証のアクティビティを継続的に監視し、異常に高い失敗率、無効なトークンの繰り返し送信、特定の送信者からの過剰なトラフィックといった異常なパターンを検出します。監視によって不正利用を早期に発見しつつ、正規の認証トラフィックは中断することなく処理を続けられます。
分離された環境
本番環境とプレプロダクション環境は完全に分離されており、インフラ、データベース、セッションストア、認証情報、WhatsApp Businessのアイデンティティもそれぞれ別です。テスト用のトラフィックが本番のセッションに干渉することはなく、運用上のミスが本番環境のお客様に影響するリスクを減らしています。
セキュリティアーキテクチャの概要
ユーザー
認証リンクを開き、認証トークンを含む入力済みのWhatsAppメッセージを送信します。
WhatsApp Business Platform
HMAC-SHA256(X-Hub-Signature-256)で署名されたwebhookとして、メッセージをPhone-Verifに配信します。
Phone-Verifの認証エンジン
受信したすべてのイベントは、各制御を順番に通過する必要があります。1つでも失敗すると、フローはそこで停止します。
webhook署名を検証
リクエストの生のボディに対して、定数時間でHMAC-SHA256を検証
認証トークンを検証
送信者ごとのレート制限付きで、高エントロピーのトークンを照会
セッションの状態を確認
セッションは、期限内で、未使用で、該当する顧客が所有している必要があります
認証完了としてマーク
セッションを1回限りのものとして確定し、あらゆるリプレイを防止
顧客のAPI/コールバック
認証結果は、セッションを作成した顧客に対して、作成時に記録されたコールバックURLで配信されます。
すべての認証は、同じ管理された経路をたどります。メッセージは処理前に認証され、セッションは完了前に検証され、顧客へのコールバックは認証が正常に完了した後にのみ実行されます。
デフォルトでフェイルセーフ
分散システムでは、答えではなくエラーが返ってくることがあります。「認証に失敗した」のか「インフラが一時的に失敗した」のかをシステムが区別できない場合、当社は常により安全な解釈を選びます。
インフラのエラーによって、認証の試行回数が消費されたり、セッションが無効になったり、正規のユーザーが黙って拒否されたりすることはありません。代わりに、ユーザーには再試行をお願いするだけです。不確かな状態を失敗とは別に扱うことで、一時的なインフラの問題による意図しないサービス拒否を防ぎます。
設計上、有効期間が短い
認証セッションは、意図的に有効期間を短くしています。トークンは数時間しか有効でなく、その後は自動的に失効し、期限切れのセッションはその後まもなくストレージから削除されます。認証情報が使える期間を限定することで、傍受されたり漏えいしたりしたトークンの価値を大幅に下げられます。
運用面のセキュリティ
セキュリティは、システムをどう運用するかにも左右されます。Phone-Verifは、サービスの稼働状況、認証のパターン、異常なアクティビティを継続的に監視しています。異常な認証失敗、無効な試行の繰り返し、予期しないトラフィックパターンなどのシグナルを追跡し、不正利用を検出してサービスの信頼性を維持しています。運用面のセキュリティは、一度の実装で終わるものではなく、継続的なプロセスです。
セキュリティの改善は継続的に行います
セキュリティに完成はありません。新しい攻撃手法が登場し、プラットフォームが進化するにつれて、実装を継続的に見直し、制御を改善し、防御を洗練させています。
透明性は、信頼を築くうえで重要な要素だと考えています。このページでは現在のセキュリティの取り組みを説明しており、Phone-Verifの成長とともに更新されていきます。
責任ある開示
セキュリティは継続的なプロセスであり、セキュリティコミュニティからの責任ある報告を歓迎します。Phone-Verifに脆弱性を発見したと思われる場合は、問題の説明と再現手順を添えて、security@phone-verif.comまでご連絡ください。
当社は、報告に速やかに応答し、誠意を持って調査し、修正の過程を通じて報告者に状況をお知らせすることをお約束します。セキュリティテストでは、サービスを妨害したり、ご自身のものではないデータにアクセスしたりしないようお願いします。また、公開前に、問題への対処のための妥当な時間をいただくようお願いします。プラットフォームの改善に貢献してくださった研究者の方には、喜んでクレジットを掲載します。
詳細、セーフハーバー条件、対象範囲については、脆弱性開示ポリシーをご覧ください。
設計段階からのセキュリティ
電話番号認証は、アプリケーションが最初に下すセキュリティ上の判断であることが多いものです。その最初のステップが破られれば、その上に構築されるあらゆる認証フローが弱くなります。Phone-Verifは、その最初のステップを可能な限り堅牢にするよう設計されています。
認証付きのWhatsApp webhookや暗号学的に安全なトークンから、プライバシーを守るエンドポイントや厳格なアクセス制御まで、すべての構成要素は攻撃対象領域を減らすために存在しています。
最も強力なセキュリティシステムは、1つの目立つ機能を軸に作られているわけではありません。互いに連携する、数十もの慎重な判断の積み重ねによって作られています。ほとんどのユーザーは、これらの保護に気づくことはないでしょう。気づく必要もありません。認証は、簡単に感じられながら、攻撃されにくいものであるべきです。
当社のセキュリティモデルについてご質問はありますか?
喜んでお手伝いします。連携ガイドで実際の仕組みをご覧いただくか、インタラクティブデモで動作をご確認ください。