Skip to content

二要素認証API

セキュリティの層を、もう一つ追加します。

第二の要素でアカウントを保護

パスワード認証の後に認証コードを求めることで、ユーザーアカウントを保護します。

二要素認証とは

二要素認証は、パスワードに加えて、独立した第二の証明(知っているものと、持っているもの)を求める仕組みです。重要なのは、その独立性です。漏えいしたパスワードのデータベースも、それだけではどのアカウントも開けないのであれば、価値は大きく下がります。

第二の要素が役に立つのは、本当に別のものである場合に限られます。同じパスワードで守られたアドレス宛てにメールで送ったコードは、第二の要素ではありません。物理的な端末に結びついた証明が、第二の要素です。

SMS 2FAとその限界

SMSは、最も広く導入されている第二の要素であり、今も一般に使われているものの中で最も弱い要素です。コードはSIMスワップで転送され、ユーザーに読み上げさせるだけの巧妙なページでフィッシングされ、通信事業者の経路制御で遅延したり失われたりします。送信のたびに費用もかかるため、ログイン経路が、攻撃者に予算を使い込まれる場所にもなります。

だからといって、SMS 2FAに価値がないわけではありません。第二の要素がまったくない状態よりは、はるかに優れています。ただ、今から選ぶのであれば、標準としてSMSを選ぶ理由はほとんどない、ということです。

WhatsApp 2FA

チャレンジをWhatsAppで送れば、経路から通信事業者がなくなります。配信はインターネット経由で、メッセージはエンドツーエンドで暗号化され、SMSごとの課金もありません。多くの市場で、ユーザーがすでに開いているアプリに届くという利点もあります。

ただし、これだけでは、配信とコストの問題が解決するにとどまり、根本的な弱点は残ります。コードはあくまでコードであり、それを読める人は、攻撃者に伝えるよう言いくるめられる可能性があります。

第二の要素としてのReverse OTP

Reverse OTPは、第二の要素の中身を変えます。秘密を端末に送り、ユーザーにそれを中継してもらう代わりに、端末にメッセージを送らせます。ユーザーはリンクをタップして送信を押し、サーバーは受信したメッセージを、保留中のログインセッションと照合します。

これにより、フィッシングされうるものがそもそもなくなります。ユーザーが読み上げるコードは画面になく、経路上で傍受されるものもなく、SIMスワップで転送されるものもありません。証明は、通信事業者が再割り当てできる番号ではなく、端末に紐づいたWhatsAppアカウントから得られます。

APIによる2FAの実装

使用するAPI呼び出しは、登録時と同じ2つです。ログインに第二の要素が必要になったら、そのログイン試行に紐づいた識別子を指定して POST /start-verification でセッションを開き、返されたディープリンクを提示します。セッションはサーバー側で保持し、GET /check-verification-status が verified を返したときにだけ、ログインを完了させます。

これを堅牢に保つルールは2つあります。1つ目は、認証セッションをユーザーではなくログイン試行に紐づけることです。そうすれば、完了したセッションが別のログインを承認することはありません。2つ目は、APIが返した番号を、アカウントに保存されている番号と照合することです。このユーザーのものではない認証済みの番号は、第二の要素に合格したのではなく、失敗したということです。

フォールバックと復旧

WhatsAppが使えない場合に備えて、同じセッション上でSMSをフォールバックとして提供し、普及率の低い市場のユーザーが締め出されないようにしましょう。さらに、端末そのものを失った場合も想定しておく必要があります。復旧手段のない第二の要素は、いずれ起きる障害の火種であり、アクセスを失ったユーザーは、そのままアカウントを失う傾向があります。

登録時に発行するリカバリーコードが、一般的な答えです。何を選ぶにせよ、公開前に決めておきましょう。インシデントの最中に設計した復旧手段は、いつも見劣りします。

電話番号ベースの2FAが適している場面

コンシューマー向けプロダクトでは、電話番号ベースの第二の要素には決定的な強みがあります。ユーザーはすでに端末を持っており、新たに登録するものが何もないことです。認証アプリやハードウェアキーより、はるかに導入が進むのはそのためです。

管理者権限、金融面の管理権限、インフラなど、重大な価値を守るアカウントでは、ハードウェアセキュリティキーが依然としてより強力な選択肢であり、両者はうまく組み合わせられます。幅広さが重要なところでは電話番号認証を、深さが重要なところではキーを使い分けてください。

よくある質問

2FA APIとは何ですか?
2FA APIは、ログインフローに第二の認証要素を追加するためのインターフェースです。ログインの確認が必要になったときに呼び出し、返された内容をユーザーに提示し、要素が満たされたと報告されて初めてユーザーを通します。
WhatsApp 2FAは、SMS 2FAより安全ですか?
配信経路から通信事業者がなくなるため、SIMスワップやSS7による傍受の影響を受けず、エンドツーエンドで暗号化されます。Reverse OTPのフローは、そもそもコードを送らないことでさらに一歩進み、フィッシングのリスクもなくします。
Reverse OTPはフィッシングされることがありますか?
ユーザーが明かすコードがないため、ワンタイムパスワードを言いくるめて読み上げさせるという、よくある攻撃が成り立ちません。フィッシングされない第二の要素は存在しませんが、典型的なソーシャルエンジニアリングの台本には、聞き出す対象がありません。
ユーザーが電話を紛失した場合はどうなりますか?
SMSや認証アプリの場合と同様に、この要素へのアクセスを失います。登録時にリカバリーコードを発行するか、認証済みの第二の要素を別に持たせ、その経路はインシデントの最中ではなく公開前に設計してください。
2FAと登録認証で、別々の連携が必要ですか?
いいえ。どちらも同じ2つのエンドポイントを使います。異なるのは、呼び出すタイミングと、結果の使い方です。登録時には認証済みの番号を保存し、ログイン時にはアカウントにすでにある番号と照合します。

Related

こんな用途に最適

銀行

重要な金融取引とアカウントへのアクセスを守ります。

SaaSプラットフォーム

顧客のアカウントとビジネスデータを保護します。

管理ポータル

特権を持つユーザーに、第二の要素を追加します。

エンタープライズアプリケーション

複雑なハードウェアトークンを使わずに、セキュリティポリシーを満たします。

Build your 二要素認証(2fa) flow today

Start integrating in minutes with clear documentation, SDKs, and global message delivery.