着信通信のメッセージ認証の設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

    • 基本認証または OAuth 認証の代わりに 仮想エージェント API のメッセージ認証を設定できます。メッセージ認証には、静的トークンまたはハッシュトークンの設定、プロバイダー認証の設定、およびチャネル ID の設定が含まれます。

    始める前に

    「受信 REST エンドポイントの確認と受信認証の構成」の手順に従ってください。

    必要なロール：admin

    手順

    1. トークンタイプに応じて、次のいずれかを実行してトークンを構成します。
      • 静的トークン：
        1. [ すべて] に移動し、フィルターに 「token_verification.list 」と入力します。
        2. [New] をクリックします。
        3. [トークン検証] フォームのフィールドに入力します。
          フィールド 説明
          名前 認証トークンの名前 ( B2BTestAppAuthToken など)。
          説明 認証トークンの説明 ( B2B テストアプリケーション認証トークンなど)。
          トークン 一般的なプログラミング言語またはスクリプト言語を使用して生成した認証トークンを入力するか、[関連リンク] の [セキュアトークンを生成 ] をクリックします。
        4. [Submit (送信)] を選択します。
      • ハッシュトークン：
        1. [ すべて] に移動し、フィルターに 「hash_message_verification.list 」と入力します。
        2. [New] をクリックします。
        3. [ハッシュメッセージの検証] フォームで、フィールドに入力します。
          フィールド 説明
          名前 認証トークンの名前 ( B2BTestAppAuthToken など)。
          説明 認証トークンの説明 ( B2B テストアプリケーション認証トークンなど)。
          シークレット 認証トークン (ランダムな文字列)。
        4. [Submit (送信)] を選択します。
    2. トークンベース認証のプロバイダー認証を設定します。
      1. [ すべて] に移動し、フィルターに「 message_auth.list 」と入力します。
      2. [New] をクリックします。
      3. [メッセージ認証] フォームのフィールドに入力します。
        フィールド 説明
        名前 メッセージ認証の名前 ( B2B 認証トークンなど)。
        プロバイダー プロバイダーの名前。
        グループ名 必須ではありません。
        サービスポータル 必須ではありません。
        着信メッセージの検証 作成した静的トークンまたはハッシュメッセージトークンを選択します。
        発信メッセージの作成 このフィールドは現在、 仮想エージェント API ではサポートされていません。作成した静的トークンまたはハッシュメッセージトークンを選択します。
        送信サービスのトークン このフィールドは現在、 仮想エージェント API ではサポートされていません。
      4. [Submit (送信)] を選択します。
    3. チャネル ID を設定します。
      1. [すべて] に移動して、フィルターに「sys_cs_provider_application.list」と入力します。
      2. VA ボット間プロバイダーアプリケーションレコードを選択して開きます。
      3. [プロバイダーチャネル ID] フォームで [メッセージ認証] フィールドを探し、前に設定したメッセージ認証を選択します。

        [メッセージ認証] フィールドがハイライト表示された、VA ボット間プロバイダーアプリケーションレコードのプロバイダーチャネル ID フォーム。

      4. [Update (更新)] をクリックします。
    4. ハッシュトークンベースの認証の場合のみ、要求ヘッダーで x-b2b-signature を送信します。
      値は要求ペイロードの HmacSHA1 エンコード値で、 ServiceNow インスタンスで作成されたトークンを使用します。たとえば、Postman で次の手順を実行します。
      1. ヘッダーで、 x-b2b-signature を {{hashValue}} に設定します。

        ヘッダーの Postman エンコーディングの例。

      2. [事前要求スクリプト] エリアで、次のようにトークンを設定します。 
        pm.environment.set('hashValue', CryptoJS.HmacSHA1(JSON.stringify(JSON.parse(request.data)), '<insert your token>').toString(CryptoJS.enc.Hex));

        トークンを入力する場所を示す Postman 事前要求スクリプトの例。

    次のタスク