API 応答を SPC 属性にマッピング

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

    • API 応答プロパティを SPC 属性にマッピングします。属性をマッピングしたら、コネクタを公開してデータをインポートします。

    始める前に

    このステップでは、API コネクタでインポートしたデータから、パラメーターを SPC 属性およびポリシーにマッピングします。
    • SPC属性の [参照] セクションのリストで API 応答サンプルを選択して使用します。
    • API 属性のリストで API 応答スキーマサンプルを選択すると、プロパティを専用の SPC 属性にマッピングできます。
    これらのスキーマとサンプルは、 前のステップで値を入力して編集を保存した後に表示されます。応答スキーマが集計されます。観測されたすべてのプロパティを表示するには、参照リストを API 応答スキーマに変更します。

    このステップには、 Now Assist スキルを持つテンプレートを選択するためのガイダンスを取得するオプションがあります。生成 AI スキルの詳細と、コネクタフレームワークでのスキルの使用に関する脆弱性対応向け Now Assistを使用した API コネクタの作成については、「脆弱性対応向け Now Assist AI スキルとエージェント型ワークフローの詳細」を参照してください。

    注:
    パラメーターを手動で入力するか、Now Assist を使用してパラメーターを自動的に生成するかにかかわらず、パラメーターを公開する前に API コネクタを検証 する必要があります。

    必要なロール：

    • sn_sec_spc_core.developer
    • sn_spc_cxf.admin:詳細スクリプティングに必要

    手順

    1. 必要な属性を追加します。

      ツールヒントを選択すると、このページのフィールドに関する詳細とコンテキストが表示されます。

      ホスト名属性と資産識別子属性は必須です。その他のフィールドはオプションです。すべての属性値は、スクリプト切り替えを使用してスクリプト化できます。スクリプトをコミットするには、[ スクリプトを保存して閉じる] を選択する必要があります。属性をスクリプト化する必要がなくなった場合は、スクリプティングの切り替えを選択して非アクティブ化します。

      [コレクション] フィールドはすべての属性に同じコレクションを適用します。この値は、フォームにすばやく入力するのに役立ちます。このフィールドには、まだマッピングされていないフィールドが自動入力されます。

      1. 資産識別子を追加します。

        資産識別子は、構成アイテムを識別するために API によって返されるプロパティの一意の組み合わせです。

      2. ホスト名属性を追加します。
      3. オプション: プロパティを追加する場合は、 SPC カスタム属性を作成します。
        カスタムプロパティは、提供されているデフォルト属性の一部として含まれていない場合にのみ作成してください。カスタムプロパティを作成するには、次の手順に従います。
    2. 例として、参照サンプルから資産のオペレーティングシステムの属性 osName を作成します。
      1. [参照] ウィンドウで [API 応答サンプル ] を選択します。
      2. オブジェクト ( 「operatingSystem」など) を見つけて、「 osName」などのプロパティが含まれている可能性があることを確認します。
      3. [ 属性を追加] を選択します。
      4. [コレクション] フィールドを選択して、API 属性リストにフィルターを適用します。この例では、 これは $.operatingSystem のようになります。
      5. API 属性フィールドを選択し、リストから osName を選択します。

        [タイプ] リストには、そのタイプにマッピングされた値が保持されます。この属性を保存するタイプを選択します。このフィールドは必須です。

        [トランスフォーマー] フィールドを使用して、API から返される値を強化します。たとえば、[タイプ] で [ 日付 ] を選択した場合、[トランスフォーマー] フィールドを使用してタイプ間をキャストできます。トランスフォーマーの使用はオプションです。

      6. オプション: プロパティを追加して、この属性を持つ特定のタイプの資産を識別できるようにデータをフィルタリングできるようにします。
      7. [資産識別子属性] フィールドを選択し、必要なプロパティ ( 住所 や assetType など) を追加します。
        これらのプロパティを追加すると、特定の資産を識別するのに役立つだけでなく、複数のセキュリティツールによって異なる方法で報告される資産を識別するのに役立つ場合があります。たとえば、あるツールが アドレスを使用してインポートし、別のツールが assetType を報告する場合があります。これらの属性を追加すると、同じ資産に対して重複する結果を作成しないようにすることができます。
    3. マッピングが完了したら、[ 保存] を選択して続行し、変更を保存します。
      続行するには、変更内容を保存する必要があります。