Security Center:コンポーネントパラメーターとノード実行フロー

パラメーターの分類

パラメーターは、2つの分類ディメンションに分けられます：

• ロール別：プレイブック入力パラメーター、プレイブック出力パラメーター、コンポーネントアクション入力パラメーター、コンポーネントアクション出力パラメーター。

• ソース別：システムパラメーター、コンポーネントパラメーター。

コンポーネント (ノード) の入出力パラメーター

ノードの入力には、固定値 (定数) または上流ノードの出力を指定できます。上流ノードの出力を参照するには、そのノードが同じオーケストレーションパス上で現在のノードより前にある必要があります。

次の図は、このルールを示しています。ノード B は、ノード A (直接の上流) の出力とプレイブックの入力パラメーターにアクセスできます。ノード D (異なるブランチ) やノード C (どのパス上でもノード B の先行ノードではない) にはアクセスできません。

システムパラメーター

パラメーターのフォーマット

ノードの入力パラメーターは、定数、変数、式の 3 つの基本フォーマットと、それらの任意の組み合わせをサポートします。

{
  "datalist": [
    {
      "person": {
        "weight": "120",
        "age": "12"
      }
    },
    {
      "person": {
        "weight": "121",
        "age": "13"
      }
    }
  ],
  "total_data_successful": 2,
  "total_data": 2,
  "total_exe_successful": 2,
  "total_exe": 2,
  "total_data_with_dup": 2,
  "status": true
}

データ型変換

プレイブックの実行中、ほとんどのデータは文字列として処理されます。アクションが特定の型を必要とする場合は、${data_type:data} を使用して変換します。

例：

JSONObject の例：プレイブック入力：{"src_ip":"127.0.0.1","dst_ip":"127.0.0.2","msg":"hello"}

JSONArray の例：プレイブック入力：{"datalist":[{"src_ip":"127.0.0.1","dst_ip":"127.1.0.1","msg":"hello"},{"src_ip":"127.1.0.1","dst_ip":"127.1.0.1","msg":"hello"}]}

パラメーター処理とノード実行フロー

1. ノードパラメーターの抽出：すべての必須の上流ノードの実行が完了した後、システムは現在のノードの入力構成に基づいて、実際の入力データを抽出します。抽出プロセスについては、以下で詳しく説明します。

2. ノードの実行：ノードの入力パラメーターがアセンブルされた後、システムは同一のパラメーターセットを重複排除し、コンポーネントアクションを実行します。

   説明

   アクションが複数のパラメーター値のセットを受け入れる場合、アクションは自動的に複数回実行されます。

   たとえば、侵害されたアプリケーションのすべてのサーバー (複数のサーバー) で「悪意のあるファイルのパージ」アクションを実行するには、サーバー IP パラメーターを ${node1.datalist.*.ip} に設定します。システムはループを必要とせずに、各 IP アドレスで自動的にアクションを実行します。

3. 出力結果の集約と重複排除：ノードが複数回実行された後、システムは結果を集約し、自動的に重複排除します。すべてのフィールドが同一である場合、エントリは重複と見なされます。

   重複排除前：

   [
       {
           "a":"11",
           "b":"22"
       },
       {
           "a":"11",
           "b":"22"
       },
       {
           "a":"11",
           "b":"33"
       }
   ]

   重複排除後：

   [
       {
           "a":"11",
           "b":"22"
       },
       {
           "a":"11",
           "b":"33"
       }
   ]

パラメーター抽出プロセス

単一データソース

任意の深さの複雑な JSON 構造は、ツリーと見なすことができます。JSON からパラメーターを抽出する原則は次のとおりです：同じ深さの兄弟関係は維持され、先祖ノードは展開され、兄弟でも先祖でもないフィールドはデカルト積を形成します。

1. 任意の深さのデータを自動的に抽出します。例：

   

2. 兄弟関係の維持：JSON 構造の同じレベルにあるフィールドはペアのままです。

   

3. 先祖ノードの展開：親ノードに複数の子がある場合、子の数に合わせて展開されます。

   

4. 兄弟でも先祖でもないノードはデカルト積を形成：2つのフィールドに兄弟関係も先祖関係もない場合、すべての組み合わせが生成されます。

   

複数データソース

個々のデータソースの抽出結果にデカルト積を適用します。