Microsoft アカウント認証に適した番号の選び方

ワンタイムコードか、保持する番号か: Microsoft アカウントにはどちらが合うか？

Microsoft アカウントは後からまた別のコードを求めてくることが多いので、まずこれを決めてください。

• OTP Gateway は単発の認証に向いています。テスト用の Outlook.com 登録の確認、自社アプリの「Microsoft でサインイン」のオンボーディングの挙動チェック、QA ケースの再現などです。番号は 20 分の有効時間内に 1 つのコードを受け取り、その後は使えなくなります。
• 専用仮想番号（Dedicated Virtual Number） は、チームが使い続けるアカウントに向いています。共有の運用用メールボックス、ステージングテナントの管理者、あるいは Microsoft が後でセキュリティ情報の電話にコードを送る可能性のあるものです。これらの回線は米国とカナダで $1.95/月 から利用でき、ウォレットから更新され、受信 SMS を Webhook に転送します。

ゲートウェイの番号をセキュリティ情報として追加すると、アクティベーションが終わった時点でそれにアクセスできなくなります。長期的に使うものには、専用番号か、事業者が管理する電話を使ってください。一時番号と専用番号の比較でさらに詳しく解説しており、更新については仮想番号のページで説明しています。

Microsoft はいつ電話番号を求めるのか？

Microsoft アカウントは、Outlook.com と Hotmail のメール、OneDrive、Teams、Xbox、Microsoft 365 のサインインを対象にします。電話認証は、いくつかのおなじみの場面で現れます。Microsoft が追加の確認を求めるアカウント作成時、セキュリティ情報として電話を追加するとき、サインインがいつもと違い本人確認をしたいとき、二段階認証、そしてアカウント復旧です。SMS には通常、短い数字のセキュリティコードが含まれます。正確なプロンプトは時間とともに変わり、地域によっても異なるため、特定の画面ではなくコードそのものを軸にテストを組んでください。

API で Microsoft の認証コードをリクエストする

or_live_ で始まる Bearer キーで https://otproute.com/api/v1 に認証します。サービス ID は microsoft です。

1. GET /api/v1/prices?country=<id>&service=microsoft で料金を取得します。
2. POST /api/v1/activations に {"service": "microsoft", "country": "us"} を送ってアクティベーションを作成します。国 ID はテストに合わせて変更してください。
3. 返された番号を Microsoft のプロンプトに入力します。
4. activation.sms_received Webhook でコードを受け取るか、GET /api/v1/activations/{id} をポーリングします。
5. テストを取りやめる場合は POST /api/v1/activations/{id}/cancel を呼び出します。

Webhook では、エンドポイントのシークレットで "<t>.<raw body>" の HMAC-SHA256 を再計算して X-OTPRoute-Signature（t=<unix>,v1=<hex>）を確認し、古いタイムスタンプを拒否し、アクティベーション ID に対してハンドラーを冪等にします。activation.expired と activation.cancelled も処理してください。上限は、キー 10 個、Webhook エンドポイント 5 つ、1 分あたり 300 リクエストです。

Microsoft と Outlook のコードを受信できるのはどの国か？

microsoft サービスは現在 198 か国で提供されています。Microsoft は番号の地域に合わせてプロンプトや言語を調整することがあるため、アカウントの市場、または再現したいシナリオに合う国を選んでください。選択肢には、米国、カナダ、英国、ドイツ、インド、ブラジル、メキシコ、アルゼンチン、ギリシャ、ポーランド、日本、ナイジェリア、南アフリカ、フィリピン、オーストラリア、パプアニューギニアなどがあります。提供状況は一日の中で変わるため、まとめて実行する前に GET /api/v1/countries を確認してください。

ダッシュボードで Outlook 用の番号を注文する

1. サインアップで、メールと 6 桁のコード、または Google サインインでアカウントを作成します。
2. ウォレットにカードまたは USDT/USDC でチャージします。チャージごとに PDF の請求書が届きます。
3. OTP Gateway を開き、Microsoft & Outlook と国を選んで、表示された料金を確認します。
4. Microsoft の画面に番号を入力し、アクティベーションでコードを待ちます。

月額料金やプランはなく、ウォレットは従量課金です。リクエストにより、開発アカウントをサンドボックスに切り替えて、模擬のエンドツーエンドテストを行えます。

Microsoft のコードが届かないのはなぜか？

Microsoft は、仮想番号を拒否したり、短い間に送るコードの数を制限したり、認証アプリなど別の方法にプロンプトを振り向けたりすることがあります。配信時間もルートに左右されます。20 分の有効時間を使い切ってください。何も届かない場合やキャンセルした場合は、全額が自動的にウォレットに戻ります。その後、時間をおくか、別の国のルートを試し、短い間隔で連続注文することは避けてください。さらなる確認項目は、OTP 配信失敗を減らす方法の記事に載っています。

Microsoft 認証を責任を持って使うには

Microsoft の規約に従い、実在する一人または一つの事業につき 1 アカウントとし、セキュリティチェックを回避しようとしないでください。OTP Route は、ご自身のプロダクトのテストと、正当なアカウントの運用のためのものであり、利用規定（Acceptable Use Policy）が適用されます。Microsoft、Outlook および関連する名称は権利者の商標であり、OTP Route は Microsoft と提携していません。

よくある質問

OTP Route の API で Microsoft のサービス ID は何ですか？

microsoft です。アクティベーションの作成時の service フィールドと、料金のクエリで使います。

Microsoft のセキュリティ情報に仮想番号を使えますか？

保持し続ける番号に限ります。米国またはカナダの専用番号なら使えますが、ワンタイムのゲートウェイ番号は 20 分の有効時間が過ぎると失効します。

Microsoft の OTP を受信するにはいくらかかりますか？

国によって異なりますが、1 コード $0.20 からです。最新の価格は GET /api/v1/prices で返されます。

Microsoft はすべての仮想番号を受け付けますか？

いいえ。Microsoft は一部の番号を拒否することがあり、その場合、コードが届かなければアクティベーションは返金されます。

CI で Outlook の SMS 認証をテストできますか？

はい。API でアクティベーションを作成し、Webhook でコードを受け取り、失敗した試行がループしないようにバックオフを加えてください。

Outlook の電話番号にはどの国を選ぶべきですか？

アカウントまたはテストケースが属する市場を選んでください。プロンプトや言語が番号の地域に従うことがあるためです。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。