アジアでは電話番号を先に入力するサインアップが一般的です。中国では 11 桁の番号と SMS コード、インドとパキスタンでは携帯電話番号とワンタイムコード、インドネシアでは WhatsApp でコードが届くことがよくあります。これをテストするには、自分が管理する番号に、毎回確実かつすぐに届くコードが必要です。実際の SMS では、これらを安定して得られません。
実際の SMS でテストするのが難しい理由
- 送信前の登録。 インドでは、SMS を配信する前に、企業が送信者 ID とメッセージのテンプレートを登録する必要があります(DLT)。中国本土では、SMS の署名とテンプレートを使用前にプロバイダーが承認します。
- 実名登録の SIM。 中国とパキスタンでは SIM カードが個人の身分証に紐づけて登録されるため、チームがテスト用の番号をまとめて買うことは簡単にはできません。
- コストと遅延。 テストを実行するたびにメッセージ料金がかかり、配信には数秒から数分かかることがあります。
- 仮想番号の拒否。 番号照会サービスは仮想(VoIP)番号と携帯電話番号を区別できます。ボットが仮想番号を使うため、多くのアプリはコードを送る前に仮想番号を拒否します。オンラインの SMS サービスが提供するのは、まさにその仮想番号です。
方法 1:認証プロバイダーのテスト番号
多くの認証プロバイダーでは、固定のコードを受け付け、メッセージを送信しないテスト番号を登録できます。
- Firebase Authentication: Phone プロバイダーの設定の「Phone numbers for testing」で、架空の番号を最大 10 件、それぞれ 6 桁のコードとともに追加できます。SMS は送信されません。
- Supabase Auth: Authentication → Sign In / Providers → Phone の「Test Phone Numbers and OTPs」で、テスト番号とそのコードを、無効になる日付とともに追加します。SMS プロバイダーの設定は必要ですが、SMS は送信されません。
- Clerk: 開発環境では、+1 (XXX) 555-0100〜555-0199 の番号でコード 424242 が使えます。
これらは開発用とステージング用のプロジェクトだけで使ってください。本番プロジェクトには設定しないでください。
方法 2:自社バックエンドでのテストモード用コード
SMS を自社で送信している場合は、固定コードを使うテストモードが一般的な方法です。中国ではよく「万能验证码」と呼ばれます。不用意に実装すると、すべてのアカウントへの入口になります。慎重に実装するには、次のようにします。
- 登録した番号に限定する。 固定コードは短いテスト用リストにある番号だけで使えるようにし、任意の番号では使えないようにします。
- 設定で有効にし、既定では無効にする。 開発環境とステージング環境だけが設定する環境変数から読み込みます。
- リリースビルドに含めない。 モバイルアプリでは、リリースビルドに含まれないビルドフラグの内側にこの処理を置きます。出荷前に、リリースビルドがこのコードを拒否することを確認してください。
- 本番環境で拒否されることを確認する。 テスト番号と固定コードで本番環境にサインインし、失敗することを期待するテストをリリース時のチェックに追加します。
フローでテストすること
- 誤ったコードが拒否され、試行回数が制限されること。
- 期限切れのコードが拒否され、再リクエストすると新しいコードが送られること。
- 再送信後、古いコードが使えるかどうかが決めたとおりに動作し、アプリがどちらなのかを表示すること。
- 入力された形式(スペース、先頭の 0、+86 など)に関係なく、番号が 1 つの形式(国番号付き)で保存されること。
- 同じ番号で再度サインアップした人が、2 つ目のアカウントを作られるのではなく、サインインに案内されること。
- アプリがメールアドレスも求める場合は、確認メールが届いて正しく機能すること。この手順は Proxy Mail QA で対応できます。アドレスを作成してサインアップし、コードやリンクを待ちます。