電話番号認証API
ユーザーが入力した電話番号を、本人が所有していることを検証します。
番号の所有を数秒で確認
電話番号認証は、信頼できるユーザー体験すべての土台です。SMS、WhatsApp、音声通話でワンタイムパスワード(OTP)を送り、所有を数秒で確認します。
電話番号認証とは
電話番号認証とは、目の前の人が、入力した電話番号を実際に管理していることを証明する行為です。フォームに入力された番号は、あくまで申告です。認証によって、それが証拠になります。認証がなければ、登録欄は、入力ミス、使い捨ての番号、他人の番号、スクリプトが貼り付けた任意の値を受け入れてしまいます。
この証拠には、3つの別々の価値があります。1つ目は、確実に機能する連絡手段が得られ、パスワードの再設定や配送通知が実在の端末に届くことです。2つ目は、アカウントの安定した識別子が得られ、複数アカウントの作成や特典の悪用にコストがかかるようになることです。3つ目は、後からフォールバックできる第二の要素が得られ、ユーザーに新たな登録をお願いする必要がないことです。
電話番号認証の仕組み
電話番号認証のフローはすべて、同じ考え方に基づいています。端末上で、その持ち主にしか起こせないことが起きる必要がある、というものです。従来の方式では、SMSでワンタイムコードを送り、ユーザーに入力し返してもらいます。Phone-Verifはこれを逆にして、ユーザーがメッセージを受け取る代わりに送りますが、流れは同じです。セッションを作成し、チャレンジを提示し、証明を待ち、結果を読み取ります。
実際には、貴社側に3つの要素が必要になります。認証セッションを開き、ユーザーに見せるものを返す呼び出し。ユーザーが操作する画面またはウィジェット。そして、コールバックまたはセッションのステータス取得によって結果を知る手段です。
WhatsApp認証
ここでは、WhatsAppが主要なチャネルです。APIは、短いセッショントークンを含むWhatsAppのディープリンクを返し、デスクトップではQRコード、モバイルではボタンとして表示します。ユーザーがタップするとWhatsAppが開いてメッセージが入力済みの状態になり、それを送信します。WhatsAppが送信元の番号をサーバーに通知します。その番号はアカウント作成時にWhatsAppが認証済みなので、自分で構築する必要のない証明をそのまま引き継げます。
トラフィックのどれだけをこれでカバーできるかは、市場次第です。WhatsAppの利用は、ブラジル、インド、欧州やアフリカの大半でほぼ全員に及ぶ一方、米国、日本、韓国ではごくわずかです。どの程度のフォールバックが必要かを決める前に、ユーザーが実際にどこにいるかを確認する価値があります。
SMS認証とフォールバック
WhatsAppを使っていないユーザー向けには、同じセッションが同じトークンをSMSでも受け付けます。ユーザーは、代わりにトークンをプレーンテキストのメッセージとして認証用の番号に送ります。セッション、トークン、その後に読み取るステータスはまったく同じなので、連携が分岐することはなく、ユーザーに表示する案内だけが変わります。
これは、思う以上に重要です。WhatsAppだけのフローでは、普及率の低い市場の人々を知らないうちに失います。SMSだけのフローでは、ボットが発生させた試行も含め、すべての試行で通信事業者に料金を支払うことになります。両方を1つのセッションに収めれば、低コストで安全なチャネルを標準にしつつ、それ以外のユーザーにも届けられます。
Reverse OTP:方向が重要な理由
従来のOTPのフローでは、サーバーが秘密を送り、それが正しい端末にだけ届くことを期待します。SIMスワップ攻撃もOTPフィッシングも、この前提を悪用しています。人為的トラフィック水増しが利益を生むのも同じ理由で、背後に実在のユーザーがいてもいなくても、試行のたびにメッセージの費用がかかります。
Reverse OTPは、この前提をなくします。ユーザーには秘密が一切送られないため、傍受されるものも、フィッシングで聞き出されるものも、不正者があなたに請求できるアウトバウンドのメッセージもありません。ユーザー自身が送るという行為が、そのまま証明になります。
認証フローの全体像
セッションは pending の状態で始まります。ユーザーが入力済みのメッセージを目にすると whatsapp_previewed、リンクを開くと opened、メッセージが届いてセッションに照合されると verified へと進みます。期限内に誰も操作しなければ、代わりに expired で終了します。
電話番号を保持するのは verified の状態だけで、それまではこのフィールドは null です。ステータスをシグナル、番号をその中身として扱い、逆にはしないでください。この一つのルールで、初めて連携するときにつまずきがちな競合状態のほとんどを避けられます。
APIの連携
連携は、2つのREST呼び出しで済みます。POST /start-verification はセッションを開き、WhatsAppの番号、ディープリンク、そして自前の画面を作らずリダイレクトで済ませたい場合に使えるホスト型のウェブURLを返します。GET /check-verification-status はセッションの状態を返し、認証が完了すると番号そのものも返します。
UIを完全に省略して、ホスト型の認証ページをiframeに埋め込むこともでき、動くものを最も早く用意できる方法です。いずれの場合も、本番環境ではポーリングのループよりコールバックを優先し、ポーリングは開発中か、ユーザーが明示的にページに戻ってきたときだけにしてください。
セキュリティとプライバシー
セッションは短命で、各トークンはちょうど1つのセッションにだけ結びついているため、再送されたメッセージはどれにも一致しません。受け取る番号は、ユーザーの入力ではなくWhatsApp自身のインフラから得られるため、他人の番号を入力して、傍受したコードを待つだけで通れてしまう隙をふさげます。
プライバシーの面でも、置き換える前の方式より扱う個人データは少なくなります。ユーザーに届くまでの間、通信網をコードが通ることはなく、保存するのは配信試行の履歴ではなく、認証済みの番号です。
料金
認証は、プリペイドのクレジットで課金されます。サブスクリプションはなく、クレジットに有効期限もないため、季節的な登録の急増にはかかった分だけ、閑散月には何も費用がかかりません。新規アカウントには無料クレジットが付与されます。何かを決める前に、ステージング環境でフローを最初から最後まで試すには十分な量です。
よくある質問
- 電話番号認証APIとは何ですか?
- 電話番号認証APIは、ユーザーが電話番号を管理していることを証明するHTTPインターフェースです。呼び出して認証セッションを開き、返された内容をユーザーに見せ、ユーザーが操作した後に、認証済みの番号を読み取ります。
- WhatsAppなしでも電話番号認証は使えますか?
- はい。同じセッションがSMSでも認証トークンを受け付けるため、WhatsAppを使っていないユーザーは、代わりにトークンをプレーンテキストのメッセージとして送ります。どちらの場合も、連携側は同じエンドポイントから結果を読み取ります。
- 認証にはどのくらい時間がかかりますか?
- API呼び出し自体は即時で、残りはユーザーがコードをスキャンして送信をタップする時間です。通信事業者の配信を待つ工程がないため、実際にはほとんどのセッションが数分ではなく数秒で完了します。
- 番号が認証されると、APIは何を返しますか?
- セッションのステータスが verified に変わり、レスポンスには、検証済みの電話番号と、各ステップを通過した時刻が含まれます。それまでは、番号のフィールドは null です。
- 電話番号認証は、二要素認証と同じですか?
- いいえ。電話番号認証は、番号がユーザーのものであることを、通常は登録時に一度だけ証明します。二要素認証は、ログイン時や重要な操作の前に、その証明を再確認します。同じAPIで両方に対応できますが、答える問いは異なります。
Related
主なシナリオ
連絡先の認証
ユーザーが、実在し連絡のつく電話番号を入力していることを確認します。
顧客のオンボーディング
最初の日から、認証済みの連絡先で信頼を築きます。
番号の検証
無効な番号、使い捨ての番号、到達できない番号を排除します。
ユーザーの本人確認
電話番号をユーザープロフィールに紐づけ、安全な本人確認を行います。
Build your 電話番号認証 flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.