サーバー認証

前提条件

このガイドでは、以下の条件を満たしていることを前提としています：

• Vonageアプリケーションでネットワーク機能機能が有効になっています。次の手順に従ってください。 ガイド をご覧ください。
• あなたは有効な JWT.私たちの オンラインジェネレーター を作成する。 JWT にある秘密鍵とVonageアプリケーションのIDを使用します。 カスタマーダッシュボードまたは指示に従ってください。 これ 別の方法を使う

認証APIリファレンス

ネットワーク・フィーチャー認証エンドポイントのOpenAPI仕様は以下の通りです。 これ.

認証フロー

APIコールを行うには3つのステップがある：

1. バックエンドアプリケーション 認証IDを要求する.
2. バックエンドのアプリケーションは、その認証IDを使用して、次のことを行う。 CAMARAアクセストークンをリクエストする.
3. 最後に、バックエンドのアプリケーションはアクセストークンを使って次のことを行います。 APIコールを行う.

OIDCリクエストを行う

OpenID Connect（OIDC）は、OAuth 2.0プロトコルの上に構築されたIDレイヤーであり、OIDCを使用してユーザーのIDを検証する方法を提供する。 JWT トークン

[POST］ https://api-eu.vonage.com/oauth2/bc-authorize

  curl --request POST \
  --url https://api-eu.vonage.com/oauth2/bc-authorize \
  --header 'Authorization: Bearer $JWT' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'login_hint=$PHONE_NUMBER' \
  --data 'scope=openid dpv:purpose#api-scope'

ヘッダー

ボディ・パラメーター

応答

成功すると、レスポンスには 200 OK ステータスと、以下のJSONデータがレスポンス・ボディに含まれる：

CAMARAアクセストークンのリクエスト

CAMARAアクセストークンをリクエストするには、以下のアドレスに

  curl --request POST \
    --url https://api-eu.vonage.com/oauth2/token \
    --header 'Authorization: Bearer $JWT' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data auth_req_id=$AUTH_REQ_ID \
    --data grant_type=urn:openid:params:grant-type:ciba

ヘッダー

ボディ・パラメーター

応答

成功すると、レスポンスには 200 OK ステータスと、以下のJSONデータがレスポンス・ボディに含まれる：

APIコールを行う

すべてのネットワーク・フィーチャー・コールには、以下のヘッダーが含まれていなければならない：