Verify APIにおけるサイレント認証の更新

我々は以下の重要な機能強化を導入している。 サイレント認証を導入しています。 Verify APIに導入します。.これらのアップデートは、開発者とテストのエクスペリエンスを向上させ、認証フローをよりコントロールできるように設計されています。

知っておくべきことのすべてと、その前に取るべき行動を紹介しよう。 2026年5月1日.

新しいcoverage_checkパラメータ

Silent Authenticationの最も一般的な課題の1つは、サポートされていないネットワークを効率的に処理することである。以前は、カバレッジ検証はフローの後半で行われることが多く、不必要なリダイレクトを引き起こす可能性があった。

皆様のご意見に耳を傾け、改良を加えています。新しい coverage_checkパラメータを追加しました。 VerifyAPIに新しいbooleanパラメータを追加します。.

仕組み

coverage_check=true(デフォルト）

• 同期検証

• ネットワークがサポートされている場合、APIはVonageアプリケーションがサイレント認証を有効にして正しく設定されていることを確認します。

• すべてのチェックがパスすると チェック_url が返されます。

• ネットワークがサポートされていない場合、即座にエラーを返す。

• 不必要なリダイレクトフローを防ぐ

coverage_check=false

• 非同期動作

• 常に check_url

• お客様側でネットワーク検証を管理できるようにする

重要な注意事項

• もし silent_authが唯一のチャンネルである場合、サポートされていないネットワークはエラーを返す。

• フェイルオーバー・チャネルが設定されている場合、リクエストは自動的に次のチャネルにフォールバックする。

生産に必要なネットワーク登録

キャリア統合を改善し、認証の失敗を減らす、 ネットワーク登録が必須となりつつある。

設定方法

を完了する必要があります。 ネットワークレジストリプロセス.

アシスタントがビジネスプロファイルとアプリケーションプロファイルの作成をお手伝いします。アプリケーション・プロファイルには、ネットワーク・アプリケーション・プロファイルが必要です。 「Accepted"ステータス（モバイルオペレータによって承認された）であり、開発者ダッシュボードで Vonage アプリケーションにリンクされている必要があります。

これらの手順は Vonage開発者ダッシュボード:

1. ダッシュボードを開く

2. ネットワーク登録 ネットワーク・レジストリ左側のメニューから

3. 登録手続きを完了する

4. お客様の を有効にします。 アプリケーション 設定

完了すると、アプリケーションはライブのサイレント認証トラフィック用に適切に設定されます。

では、5月1日以降はどうなるのか？

申請が行われ、ネットワーク・アプリケーション・プロファイルがまだ移動通信事業者によって承認されていない場合、エラーが返される：

• そのとき coverage_check=trueの場合、リクエストは412エラーで同期的に拒否される。

• そのとき coverage_check=falseの場合、エラーはコールバックによって非同期に返される。

サンドボックス・パラメータの廃止

また、Silent Authenticationのテスト方法も最新化しています。

この sandboxパラメータは廃止される。今後、テストは ネットワーク・レジストリー・プレイグラウンド,これは、安全かつ制御された環境でライブトラフィックを提供する。

プレイグラウンドでは、開発者のエクスペリエンスが大幅に改善されている：

• サポートされているAPIと5つの登録電話番号までの国のライブトラフィック。

• APIがまだ利用できない国でのAPIテストのための仮想オペレータサポート。

リクエストフラグに頼るよりも、より現実的で強力なテスト環境を手に入れることができる。

新しいプレイグラウンドへの移行は、かつてないほど簡単になりました：

• を削除します。 sandboxパラメータを削除してください。

• で説明されている手順に従ってください。 ネットワークレジストリプレイグラウンドガイドに記載されている手順に従って、Vonage アプリケーションでテスト環境を有効にしてください。Playground 使用のために新しい専用アプリケーションを作成することを忘れないでください。1つのVonageアプリケーションでPlaygroundと本番トラフィックの両方をサポートすることはできません。

5月1日以降はどうなりますか？APIは以下のように動作します：

• を持つリクエストは sandbox=trueを含むリクエストは 422エラー 無効なパラメータです。

• リクエスト sandbox=false(または sandbox パラメータは無視される)。

行動チェックリスト

その前にすべきことがある 2026年5月1日:

についてcoverage_check

• 現在の統合を見直す

• 同期()か非同期()か非同期(false)動作

• APIコールを適宜更新する

ネットワーク登録について

• ネットワーク・アプリケーション・プロファイルが正しくリンクされていることを確認する。

サンドボックス非推奨について

• 使用中止 sandbox=true

• テストを Network Registry Playground に移行する。

• 本番ワークフローがサンドボックスパラメータに依存しないようにする。

キーデート2026年5月1日

この日に

• coverage_checkが利用可能になる（デフォルト： 真)

• ライブ・トラフィックにネットワーク登録が必須に

• sandbox=trueは422エラーを返す。代わりにNetwork Registry Playgroundを使用してください。

結論

Silent Authentication は進化を続け、より信頼性が高く、より予測可能で、規模に応じた運用が容易になっている。これらのアップデートは、3つの主要目標を反映しています：

• 開発者エクスペリエンスの向上。この coverage_checkパラメータは不要なリダイレクトを減らし、サポートされていないネットワークに関するフィードバックを即座に提供します。

• ネットワークカバレッジ管理の向上。登録の義務化により、通信事業者の統合が向上し、認証の失敗が少なくなります。

• より良いテスト置き換える sandboxを Network Registry Playground に置き換えることで、より現実的で堅牢なテスト環境が得られます。