リスト

以下でサポートされています。

このドキュメントでは、カスタムリストの管理に役立つ一連のアクションについて説明します。

カスタムリストを検索する

説明

カスタムリストのレコード内で指定された文字列を検索します。値が指定されていない場合、検索ではすべてのカスタムリスト レコードが返されます。

パラメータ

パラメータ 型 デフォルト値 必須 説明
検索する文字列 文字列 なし いいえ カスタム リストのレコード内で検索する文字列。
カテゴリ 文字列 なし いいえ 検索対象のカスタムリストのカテゴリ。

例

この例では、カテゴリが「Blocked Domains」のカスタム リストのレコードに .com が含まれているかどうかを確認します。

アクションの構成

パラメータ 値
エンティティ すべてのエンティティ
検索する文字列 .com
カテゴリ ブロックされたドメイン

アクションの結果

  • スクリプトの結果
    スクリプトの結果名 値のオプション 例
    Match_records true または false true
  • JSON の結果 
    [{
"entityIdentifier": "sample.com", "category": "Blocked Domains", "forDBMigration": false, "environments": ["*"], "id": 1, "creationTimeUnixTimeInMs": 1674846992575, "modificationTimeUnixTimeInMs": 1674846992575
}]

環境のカスタムリストで指定された文字列を検索する

説明

現在のケース環境のカスタムリストのレコード内で、指定された文字列を検索します。値が指定されていない場合、検索ではすべてのカスタムリスト レコードが返されます。

パラメータ

パラメータ 型 デフォルト値 必須 説明
検索する文字列 文字列 なし いいえ カスタムリストのレコード内で検索する文字列。
カテゴリ 文字列 なし いいえ 検索用のカスタムリスト内のカテゴリの仕様。

例

この例では、カテゴリが「vuln_scanner」のカスタムリストのレコードに 1.1.1.1 が含まれているかどうかを確認します。

アクションの構成

パラメータ 値
エンティティ すべてのエンティティ
検索する文字列 1.1.1.1
カテゴリ vuln_scanner

アクションの結果

  • スクリプトの結果
    スクリプトの結果名 値のオプション 例
    Match_Records true または false true
  • JSON の結果
    [
  {
    "entityIdentifier": "1.1.1.1",
    "category": "vuln_scanner",
    "environments": [
      "Default Environment"
    ],
    "id": 5,
    "name": "test",
    "creationTimeUnixTimeInMs": 1673953571935,
    "modificationTimeUnixTimeInMs": 1673953571935
  }
]

文字列がカスタムリストに含まれているか

説明

文字列がカスタムリストに含まれているかどうかを確認します。

パラメータ

パラメータ 型 デフォルト値 必須 説明
ListItem 文字列 なし ○ カスタム リストに追加する文字列。
カテゴリ 文字列 許可リスト ○ カスタムリストのカテゴリまたは名前。

例

この例では、IP アドレス 0.0.0.0 が bad_ips_list という名前のリスト カテゴリに存在するかどうかを確認します。

アクションの構成

パラメータ 値
エンティティ すべてのエンティティ
IdentifierList 0.0.0.0
カテゴリ bad_ips_list

アクションの結果

  • スクリプトの結果
スクリプトの結果名 値のオプション 例
NumOf FoundResults true または false true
  • JSON の結果 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

カスタムリストに文字列を追加

説明

カスタムリストに文字列を追加します。

パラメータ

パラメータ 型 デフォルト値 必須 説明
ListItem 文字列 なし ○ カスタム リストに追加する文字列。
カテゴリ 文字列 許可リスト ○ カスタムリストのカテゴリまたは名前。

例

この例では、0.0.0.1 という IP アドレスが bad_ips_list という名前のカスタムリスト カテゴリに追加されます。

アクションの構成

パラメータ 値
エンティティ すべてのエンティティ
Listitem 0.0.0.1
カテゴリ bad_ips_list

アクションの結果

  • スクリプトの結果
    スクリプトの結果名 値のオプション 例
    NumOf FoundResults true または false true
  • JSON の結果 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

カスタムリストから文字列を削除

説明

カスタムリストから文字列を削除します。

パラメータ

パラメータ 型 デフォルト値 必須 説明
カテゴリ 文字列 許可リスト ○ カスタムリストのカテゴリまたは名前。
ListItem 文字列 なし ○ カスタムリストから削除する文字列。

例

この例では、IP アドレス 0.0.0.1 が bad_ips_list という名前のカスタムリスト カテゴリから削除されます。

アクションの構成

パラメータ 値
エンティティ すべてのエンティティ
IdentifierList 0.0.0.1
カテゴリ bad_ips_list

アクションの結果

  • スクリプトの結果
    スクリプトの結果名 値のオプション 例
    NumOfFoundResults true または false true
  • JSON の結果 
    {
"Entity" : "0.0.0.0",
"EntityResult" : "true"
}

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。