SMSによる二要素認証(2FA)

安全性が高く、利用者の負担も少ないSMSによる認証は様々なサービスで利用されています。このチュートリアルではNTT CPaaSのAPIを用いたSMSでの二要素認証導入方法を説明します。

一般的によく使われているIDとパスワードによる本人認証は、不正にID・パスワードを入手することで、他人になりすましログインできるため安全性は決して高くないと言えます。そこで、電話端末に1つしか割り振られない携帯番号を使った認証により本人確認を行うことで、運営サイトのセキュリティを高めることができるようになりました。安全性が高く、かつ、利用者が認証を行う際の負担も少ないため、金融機関をはじめ、様々なWebサービスやスマートフォンアプリで利用されています。

SMSによる二要素認証を実現するために、NTT CPaaSのAPIを活用できます。このチュートリアルではSMSを用いた二要素認証を説明します。

二要素認証の利用シーン

SMSによるワンタイムパスワードの利用シーンは多岐に渡ります。

  • スマホアプリインストール時の本人認証
  • 「金融機関サイトでのログイン時
  • ワンタイムパスワード発行
  • 各種Webサービス登録時・ログイン時
  • パスワード忘れ時の再認証

二要素認証の導入メリット

SMSによるワンタイムパスワードの利用シーンは多岐に渡ります。

  • 電話番号を用いたセキュリティの高い認証の実現
  • 不正アクセス(ログイン)防止
  • なりすましや複数アカウント登録を防止

プロセスワークフロー

サービス
NTT CPaaS NTT CPaaS

▶ アカウントをお持ちでない方へ|60日間無料トライアルを開始

チュートリアルの内容は、トライアル環境ですぐにお試しいただけます。クレジットカード情報の登録は不要、自動で課金されることもありません。送信テストや動作確認に、ぜひ無料トライアルをご活用ください。

事前準備・前提条件

このチュートリアルを始めるには、NTT CPaaSアカウントが必要です。 こちらからログインをお願いします。
API キーとベース URL も必要になります。詳細についてはAPIリファレンスを参照してください。
SMS APIの利用には発信元番号の登録が必要です。本申し込みから電話番号をご登録ください。また、無料トライアルの利用では、送信先の電話番号の認証が必要です。

実装手順

ステップ1 - 二要素認証アプリケーションの生成

『アプリケーションの作成2FA』を利用して、二要素認証を実現するアプリケーションを作成します。
ここでは以下の条件でAPIを利用します。

  • Method: POST
  • End Point : {baseUrl}/2fa/2/applications
  • Content-Type: application/json

リクエスト例:

{
  "name": "2fa application test",
  "enabled": true,
  "configuration": {
    "pinAttempts": 5,
    "allowMultiplePinVerifications": true,
    "pinTimeToLive": "10m",
    "verifyPinLimit": "2/4s",
    "sendPinPerApplicationLimit": "5000/12h",
    "sendPinPerPhoneNumberLimit": "2/1d"
  }
}

レスポンス例:

{
  "applicationId": "20AA84D1A9AB6DB22B6842092D62AB93",
  "name": "2fa application test",
  "configuration": {
    "pinAttempts": 5,
    "allowMultiplePinVerifications": true,
    "pinTimeToLive": "10m",
    "verifyPinLimit": "2/4s",
    "sendPinPerApplicationLimit": "5000/12h",
    "sendPinPerPhoneNumberLimit": "2/1d"
  },
  "enabled": true
}

ステップ2 - メッセージテンプレートの設定

『2FA(二要素認証) SMSまたはVoice メッセージ テンプレートを作成する』を利用して、メッセージテンプレートを作成します。
これは、エンドユーザーに送信される メッセージ本文です。1 つのアプリケーションごとに多数のメッセージ テンプレートを作成できるため、同じアプリケーションをさまざまなユース ケースやさまざまな言語でご利用頂けます。
メッセージ テンプレートを作成すると、後で PIN を送信するときに使用するメッセージ テンプレート ID が提供されます。メッセージ テンプレート ID を参照することで、システムは PIN を生成し、その PIN をメッセージ テンプレートに配置し、最後に PIN を含むメッセージをエンド ユーザーに送信します。

ここでは以下の条件でAPIを利用します。

  • Method: POST
  • End Point : {baseUrl}/2fa/2/applications/{applicationId}/messages
  • Content-Type: application/json

リクエスト例:

{
  "pinType": "NUMERIC",
  "messageText": "認証コードは {{pin}} です。",
  "pinLength": 4,
  "language": "ja",
  "senderId": "tutorial"
}

レスポンス例:

{
  "messageId": "643BE5B7424A47DA526B4E9D28A53395",
  "applicationId": "20AA84D1A9AB6DB22B6842092D62AB93",
  "pinPlaceholder": "{{pin}}",
  "messageText": "認証コードは {{pin}} です。",
  "pinLength": 4,
  "pinType": "NUMERIC",
  "language": "ja",
  "senderId": "tutorial",
  "speechRate": 1.0
}

ステップ3 - PINコードをSMSで送信する

『2FA(二要素認証)PINコードをSMSで送信する』を利用して、SMSを送信します。
PINコードの送信には、前のステップで作成したメッセージ テンプレートを使用します。

ここでは以下の条件でAPIを利用します。

  • Method: POST
  • End Point : {baseUrl}/2fa/2/pin
  • Content-Type: application/json

リクエスト例:

{
  "applicationId": "20AA84D1A9AB6DB22B6842092D62AB93",
  "messageId": "643BE5B7424A47DA526B4E9D28A53395",
  "from": "tutorial",
  "to": "+819999999999"
}

レスポンス例:

{
  "pinId": "FCFF0624BBDDC850F8CB2309E3CB66AC",
  "to": "819999999999",
  "ncStatus": "NC_NOT_CONFIGURED",
  "smsStatus": "MESSAGE_SENT"
}

ステップ4 - 認証結果を確認する

『PIN を確認する』を利用して、認証結果を確認します。
電話番号の検証が成功したことを確認します。

ここでは以下の条件でAPIを利用します。

  • Method: POST
  • End Point : {baseUrl}/2fa/2/applications/${pinId}/verify
  • Content-Type: application/json

リクエスト例:

{
  "pin": "2952"
}

レスポンス例:

{
  "pinId": "FCFF0624BBDDC850F8CB2309E3CB66AC",
  "msisdn": "818036031401",
  "verified": true,
  "attemptsRemaining": 0
}

NTT CPaaSを、
60日間無料でお試しください

・SMS・Voice・メールを本番同様に無料で検証
・全API機能に即日アクセス / 有料プランと同一環境
・国内開発者向けに最適化された日本語ガイド

無料トライアル

目次
  1. 二要素認証の利用シーン
  2. 二要素認証の導入メリット
  3. プロセスワークフロー
  4. 事前準備・前提条件
  5. 実装手順
    1. ステップ1 - 二要素認証アプリケーションの生成
    2. ステップ2 - メッセージテンプレートの設定
    3. ステップ3 - PINコードをSMSで送信する
    4. ステップ4 - 認証結果を確認する

2025.01.21