Proton Mail の SMS 認証: テスト用チェックリストとワークフロー

Proton Mail のコードを要求する前の事前チェックリスト

Proton Mail の SMS 認証テストは、事前の準備を済ませておけばスムーズに進みます。

• Proton が求める理由を把握する: このサインアップまたは復旧のステップで、画面が SMS を認証手段として提示していることを確認します。
• 国を意図して選ぶ: アカウントの市場、またはテスト計画のシナリオに合わせます。
• 料金と提供状況を確認する: GET /api/v1/prices?country=<id>&service=protonmail を呼び出すか、ダッシュボードで確認します。
• 受信側を用意する: activation.sms_received を購読する Webhook エンドポイント、または適切な間隔のポーリングループを用意します。
• メールボックスの将来を考える: 後で復旧や再認証が必要になるなら、Dedicated Number のほうが適している場合があります。
• ルールを読み直す: Proton の規約と OTP Route の Acceptable Use Policy の両方が適用されます。

Proton Mail はどこで電話番号を求めますか？

Proton Mail はプライバシー重視のメールサービスで、電話番号の利用を最小限に抑えています。よくある場面は、サインアップ時のヒューマン検証です。新しいアカウントが実在の人物のものであることを Proton がより確かめたいとき、複数ある選択肢の 1 つとして SMS コードを提示することがあります。アカウント所有者は、復旧手段として番号を追加することもできます。Proton の 2 段階ログインは SMS ではなく認証アプリやセキュリティキーに依存しているため、サインアップ時に一度だけ使った番号は、復旧用の電話として保存していない限り、その後のログインでは必要ありません。

手順で見る Proton Mail 認証コード API

1. 開発者コンソールで作成した Bearer キー（プレフィックス or_live_）で認証します。
2. GET /api/v1/prices?country=de&service=protonmail で料金を確認します。別の国 ID でも構いません。
3. POST /api/v1/activations に {"service": "protonmail", "country": "de"} を送って注文します。
4. 返された番号を Proton の認証欄に入力します。
5. コードを受信します。Webhook には activation.sms_received が届きます。X-OTPRoute-Signature ヘッダー（タイムスタンプ、ドット、生のボディを連結し、エンドポイントのシークレットをキーにした HMAC-SHA256）を検証し、古いタイムスタンプは拒否してください。代替手段は GET /api/v1/activations/{id} のポーリングです。
6. 再配信された Webhook が 1 回だけ処理されるよう、結果はアクティベーション ID をキーにして記録します。

1 アカウントあたり API キー 10 個、Webhook エンドポイント 5 個、1 分あたり 300 リクエストまで利用できます。より詳しい解説はWebhook による OTP 取得を参照してください。

手順で見る、ダッシュボードでの同じ作業

1. サインインして OTP Gateway を開きます。
2. Proton Mail を検索し、国を選びます。
3. 表示された料金を確認して確定します。
4. 番号を Proton の SMS 認証画面に貼り付けます。
5. 注文は開いたままにしておきます。メッセージが届くと、番号の横にコードが表示されます。
6. Proton から何も送られてこない場合はキャンセルするか、20 分のウィンドウが切れるのを待ちます。どちらの場合もウォレットに返金されます。

Proton Mail の電話番号はどの国で利用できますか？

現在、Proton Mail のルートは 197 か国に及びます。例として、スイス、ドイツ、イギリス、ブラジル、インド、フランス、スペイン、メキシコ、インドネシア、フィリピン、ナイジェリア、ケニア、日本、ポーランド、アメリカなどがあります。国の選択は重要です。ドイツ語のオンボーディング経路のテストにはドイツの番号を使うべきですし、ブラジルのチームが運用するアカウントは、ブラジルの番号のほうが一貫性があります。どのサービスでも、最新の提供状況は GET /api/v1/countries と料金エンドポイントで確認できます。

トラブルシューティング: Proton Mail の SMS が届かなかった

• 仮想番号が拒否された: Proton は、仮想番号とみなした番号を拒否することがあります。別のヒューマン検証の方法か別のルートを選んでください。返金で今回の試行分はカバーされます。
• まだ何も届かない: すぐに再注文せず、20 分のウィンドウが終わるまで待ちます。短時間の繰り返し注文はほとんど効果がありません。
• ルートが混雑している: 時間を置いて再試行するか、テストケースに合う別の国を選びます。
• Webhook が届かない: エンドポイントのシークレット、署名のロジック、サーバーの時計を確認し、GET /api/v1/activations/{id} を直接呼び出した結果と比較します。

Dedicated Number のほうが適しているのはどんなときですか？

サインアップの確認には、1 回限りの番号が適切です。ただし、数か月後にチームが復旧しなければならないメールボックスには向きません。その番号には二度と届かないためです。共有のサポート用受信箱や回帰テスト用のステージングアカウントのように、使える復旧用電話が必要なアカウントには、米国またはカナダの Dedicated Virtual Number を、1 か月 $1.95 からでご利用ください。更新を続ける限り保持でき、SMS はダッシュボードと number.sms_received として Webhook で受信でき、不要になればいつでも解約できます。両者の詳しい比較はワンタイム番号と専用番号の違いにあります。

責任ある使い方と課金

Proton はプライバシーを軸にプロダクトを作っており、その姿勢は尊重されるべきです。OTP Route の番号は、自社のオンボーディングのテスト、事業に本当に必要なアカウントの開設、あるいは共有ログインにスタッフの個人番号を使わないようにするためにお使いください。アカウントは実在する 1 人または 1 社につき 1 つとし、Proton の規約を守ってください。料金は前払いの USD ウォレットで月額料金はなく、カードまたは USDT/USDC でチャージでき、チャージごとに PDF の請求書が発行されます。連携作業向けには、リクエストに応じてサンドボックスも利用できます。関連するワークフローはプライバシー重視のサインアップのページで紹介しています。

よくある質問

API で Proton Mail の OTP コードを受け取るには？

サービス protonmail と選んだ国でアクティベーションを作成し、番号を Proton に入力して、activation.sms_received Webhook またはアクティベーションのポーリングでコードを取得します。

Proton Mail のサインアップで、Proton は仮想番号を受け付けますか？

すべてのケースではありません。どの番号を信頼するかは Proton が決めており、20 分以内にコードが届かなければ自動的に返金されます。

あとでアカウントを復旧するために同じ番号を使えますか？

OTP Gateway のワンタイム番号では使えません。保持する復旧用の電話番号には Dedicated Number を使ってください。提供は米国とカナダのみです。

Proton は 2 要素ログインに SMS を使いますか？

いいえ。Proton の 2 段階ログインは認証アプリまたはセキュリティキーを使います。SMS が登場するのは主にヒューマン検証と復旧オプションです。

資金を使わずに Proton Mail の認証をリハーサルできますか？

連携作業であれば可能です。サポートに依頼して開発用アカウントをサンドボックスに切り替えると、シミュレートされた番号とコードが返されます。本物の Proton のコードを受け取るには、通常の注文が必要です。

この方法で複数の Proton アカウントを開設してもよいですか？

いいえ。アカウントは実在する 1 人または 1 社につき 1 つとし、Proton の規約を守ってください。OTP Route は、自社の正当なアカウントやプロダクトのテストと運用のためのものです。

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