Siemplify を Google SecOps と統合する
このドキュメントでは、Siemplify を Google Security Operations(Google SecOps)と統合する方法について説明します。
ユースケース
Siemplify の統合により、次のユースケースに対応できます。
フィッシング調査: Google SecOps の機能を使用して、フィッシング メールの分析、セキュリティ侵害インジケーター(IOC)の抽出、脅威インテリジェンスによる拡充のプロセスを自動化します。
マルウェアの封じ込め: Google SecOps の機能を使用して、マルウェアの検出時に感染したエンドポイントを自動的に隔離し、スキャンを開始して、悪意のあるファイルを隔離します。
脆弱性管理: Google SecOps の機能を使用して、脆弱性スキャンのオーケストレーション、リスクに基づく脆弱性の優先順位付け、修復のためのチケットの自動作成を行います。
脅威ハンティング: Google SecOps の機能を使用して、さまざまなセキュリティ ツールとデータセットにわたる脅威ハンティング クエリの実行を自動化します。
セキュリティ通知のトリアージ: Google SecOps の機能を使用して、セキュリティ通知をコンテキスト情報で自動的に拡充し、他のイベントと関連付け、重大度に基づいて優先順位を付けます。
インシデント対応: Google SecOps の機能を使用して、最初の検出から封じ込め、根絶まで、インシデント対応プロセス全体をオーケストレートします。
コンプライアンス レポート: Google SecOps の機能を使用して、コンプライアンス レポート用のセキュリティ データの収集と分析を自動化します。
始める前に
この統合により、ネイティブ プラットフォーム機能が提供され、認証に外部のサードパーティ API キーや認証情報は必要ありません。始める前に、Google SecOps インスタンスのコンテンツ ハブから統合がインストールされていることを確認してください。
統合のパラメータ
Siemplify 統合には、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Monitors Mail Recipients |
必須。 統合のメール関連ワークフローで検証するメールアドレスのカンマ区切りのリスト。 このリストは、処理対象の受信者を定義するために使用されます。 デフォルト値は |
Elastic Server Address |
必須。 Siemplify データベースへの接続に使用される Elastic サーバーのアドレス。 これは通常、Elastic インスタンスが実行されているホストマシンのアドレスです。 デフォルト値は |
Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。
必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。
操作
アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。
エンティティ分析情報の追加
エンティティ分析情報の追加アクションを使用して、Siemplify の Google SecOps エンティティに分析情報を追加します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
[Add Entity Insight] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Message |
必須。 エンティティに追加するメッセージ。 このパラメータは、次のような HTML 要素をサポートしています。
|
アクションの出力
Add Entity Insight アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Add Entity Insight アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Add Entity Insight". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Add Entity Insight] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
一般的な分析情報の追加
[Add General Insight] アクションを使用して、ケースに一般的な分析情報を追加します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Add General Insight] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Title |
必須。 分析情報のタイトル。 |
Message |
必須。 エンティティに追加するメッセージ。 このパラメータは、次のような HTML 要素をサポートしています。
|
Triggered By |
省略可。 インサイトの理由を説明するフリーテキスト フィールド。ケースに追加された理由を説明します。 |
アクションの出力
Add General Insight アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Add General Insight アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Add General Insight". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Add General Insight] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
同様のケースへのタグの追加
[Add Tags To Similar Cases] アクションを使用して、同様のケースにタグを追加します。
類似したケースを見つけるために、このアクションは siemplify.get_similar_cases() 関数を使用して、一連の条件とパラメータに基づいてケース ID のリストを取得します。
論理 AND 演算子が Rule Generator、Port、Category Outcome、Entity Identifier パラメータに適用され、指定されたすべての条件に一致するケースがフィルタされます。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Add Tags To Similar Cases] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Rule Generator |
省略可。 選択すると、アクションはルール ジェネレータを使用して類似のケースを検索します。 デフォルトで有効になっています。 |
Port |
省略可。 選択すると、ポート番号を使用して類似のケースが検索されます。 デフォルトで有効になっています。 |
Category Outcome |
省略可。 選択すると、カテゴリの結果を使用して類似のケースが検索されます。 デフォルトで有効になっています。 |
Entity Identifier |
省略可。 選択すると、エンティティ識別子を使用して類似のケースが検索されます。 デフォルトで有効になっています。 |
Days Back |
必須。 類似のケースを検索する、現在の日付より前の日数。 |
Tags |
必須。 見つかった類似ケースに適用するタグのカンマ区切りのリスト。 |
アクションの出力
Add Tags To Similar Cases アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Add Tags To Similar Cases アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Add Tags To Similar Cases". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Add Tags To Similar Cases アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
SimilarCasesIds |
類似のケース ID のリスト。 |
カスタムリストに追加
[カスタムリストに追加] アクションを使用して、分類されたカスタムリストにエンティティ識別子を追加し、他のアクションで今後の比較を行います。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
カスタムリストに追加アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Category |
必須。 エンティティ識別子を追加するカスタムリスト カテゴリの名前。 |
アクションの出力
カスタムリストに追加アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[カスタムリストに追加] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Add to Custom List". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[カスタムリストに追加] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースの割り当て
[ケースを割り当てる] アクションを使用して、ケースを特定のユーザーまたはユーザー グループに割り当てます。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Assign Case] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Assigned User |
省略可。 ケースを割り当てるユーザーまたはユーザー グループ(
|
Assignee |
省略可。 ケースを割り当てるユーザーまたはユーザー グループ(文字列値を受け入れます)。
|
Case ID |
省略可。 更新するケース ID のカンマ区切りのリスト。 値が指定されていない場合、アクションは実行元のケースを更新します。 |
アクションの出力
[Assign Case] アクションの出力は次のとおりです。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[カスタムリストに追加] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Assign Case". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ケースの割り当てアクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ハンドブックをアラートにアタッチ
[ハンドブックをアラートにアタッチ] アクションを使用して、特定のハンドブックをアラートにアタッチします。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
ハンドブックをアラートにアタッチアクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Playbook Name |
必須。 現在のアラートにアタッチするハンドブックの名前。アクションを成功させるには、ハンドブックを有効にする必要があります。 |
Allow Duplicates |
省略可。 選択すると、ハンドブックをアラートに複数回アタッチできます。 デフォルトで有効になっています。 |
アクションの出力
[ハンドブックをアラートにアタッチ] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Search Graphs アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Attach Playbook to Alert". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Attach Playbook to Alert] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
ケースにハンドブックを関連付ける
[Attach Playbook to Case] アクションを使用して、Google SecOps のケースにハンドブックを関連付けます。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Attach Playbook to Case] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Playbook Name |
必須。 ケースにアタッチするハンドブックの名前。 |
アクションの出力
[Attach Playbook to Case] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Attach Playbook to Case アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
Successfully attached the
PLAYBOOK_NAME playbook to the
case. |
アクションが成功しました。 |
The PLAYBOOK_NAME
playbook was already attached to the case. |
アクションが失敗しました。 指定されたハンドブックがプラットフォームに存在しません。 |
Error executing action "Attach Playbook to Case". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または権限を確認してください。 |
スクリプトの結果
次の表に、[Attach Playbook to Case] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースコメント
[ケースコメント] アクションを使用して、現在のアラートがグループ化されているケースにコメントを追加します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
ケースコメント アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Comment |
必須。 ケースに追加するコメント。 |
アクションの出力
Case Comment アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Add Vote To Entity] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Case Comment". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ケースのコメント アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
SuccessStatus |
true または false |
ケースタグ
[ケースタグ] アクションを使用して、現在のアラートがグループ化されているケースにタグを追加します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
ケースタグ アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Tag |
必須。 ケースに追加するタグ。
|
Delimiter |
省略可。
値を指定しない場合、区切り文字は適用されません。 |
アクションの出力
ケースタグ アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Case Tag アクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"added_tags": ["123", "321"]
}
出力メッセージ
Case Tag アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Add Vote To Entity". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Case Tag アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
アラートの優先度を変更する
[Change Alert Priority] アクションを使用して、ケース内のアラートの優先度を更新します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
アラートの優先度を変更するアクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Alert Priority |
必須。 アラートの新しい優先度。 アラートの優先度が現在のケースの優先度よりも高くなるように更新されると、ケースの優先度は、新しい高い優先度に合わせて自動的に更新されます。 値は次のいずれかになります。
|
アクションの出力
Change Alert Priority アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Add Vote To Entity] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Change Alert Priority". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Change Alert Priority] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
ケースのステージを変更する
ケースのステージを変更するには、[Change Case Stage](ケースのステージを変更)アクションを使用します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Change Case Stage] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Stage |
必須。 ケースの移動先のステージ。 値は次のいずれかになります。
|
アクションの出力
[Change Case Stage] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Add Vote To Entity] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Change Case Stage". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ケースステージを変更アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
優先度の変更
[優先度を変更] アクションを使用して、ケースの優先度を変更します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
優先度の変更アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Priority |
必須。 ケースに設定する優先度。 値は次のいずれかになります。
|
アクションの出力
Change Priority アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
優先度の変更アクションでは、次の出力メッセージが返されることがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Change Priority". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[優先度の変更] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
アラートをクローズする
[アラートを閉じる] アクションを使用してアラートを閉じます。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Close Alert] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Reason |
必須。 アラートのクローズの主な分類。 値は次のいずれかになります。
|
Root Cause |
必須。 アラートの原因となった技術的な問題の詳細な説明。 |
Comment |
必須。 メモ、調査の概要、またはアラートのクローズに関する追加のコンテキスト。 |
Assign to User |
省略可。 クローズ後にアラートを割り当てるユーザー。 |
Tags |
省略可。 分類、フィルタリング、今後の検索性のためにアラートに適用するタグのカンマ区切りのリスト。 |
Custom Fields |
省略可。 アラートがクローズされたときに更新するカスタム フィールドを含む JSON オブジェクト。 |
Append Custom Field Values |
省略可。 選択すると、指定された JSON 値が既存のカスタム フィールドに追加されます。 選択しない場合、アクションは既存の値を JSON オブジェクトで指定された値で上書きします。 デフォルトでは無効にされています。 |
アクションの出力
[Close Alert] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Add Vote To Entity] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Close Alert". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Close Alert] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
StatusResult |
true または false |
ケースをクローズする
[ケースをクローズする] アクションを使用してケースをクローズします。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Close Case アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Reason |
必須。 アラートのクローズの主な分類。 値は次のいずれかになります。
|
Root Cause |
必須。 アラートの原因となった技術的な問題の詳細な説明。 |
Comment |
必須。 メモ、調査の概要、またはアラートのクローズに関する追加のコンテキスト。 |
Custom Fields |
省略可。 ケースがクローズされたときに更新するカスタム フィールドを含む JSON オブジェクト。 |
Append Custom Field Values |
省略可。 選択すると、指定された JSON 値が既存のカスタム フィールドに追加されます。 選択しない場合、アクションは既存の値を JSON オブジェクトで指定された値で上書きします。 デフォルトでは無効にされています。 |
アクションの出力
[ケースをクローズする] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Add Vote To Entity] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Close Case". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ケースを閉じるアクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
StatusResult |
true または false |
エンティティの作成
[エンティティを作成] アクションを使用して、新しいエンティティを作成し、アラートに追加します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
[Create Entity] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Entities Identifies |
必須。 ケースで作成するエンティティ識別子のカンマ区切りのリスト( |
Delimiter |
省略可。
値が指定されていない場合、アクションは入力を単一のエンティティ識別子として扱います。 デフォルト値は |
Entity Type |
必須。 作成するエンティティのタイプ( |
Is Internal |
省略可。 選択すると、アクションはエンティティを内部ネットワークの一部としてマークします。 デフォルトでは有効になっていません。 |
Is Suspicious |
省略可。 選択すると、アクションはエンティティを不審としてマークします。 デフォルトでは有効になっていません。 |
アクションの出力
[Create Entity] アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Create Entity アクションの使用時に受信した JSON 結果の出力を示しています。
[
{
"additional_properties": {
"OriginalIdentifier": "ACCOUNT_ID"
},
"alert_identifier": "ACCESS DISABLED ACCOUNTS",
"case_identifier": 7113,
"creation_time": 0,
"entity_type": "USERUNIQNAME",
"identifier": "ACCOUNT_ID",
"is_artifact": false,
"is_enriched": false,
"is_internal": false,
"is_pivot": false,
"is_suspicious": false,
"is_vulnerable": false,
"modification_time": 0
}
]
出力メッセージ
[Create Entity] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Create Entity". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Create Entity] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
StatusResult |
true または false |
Gemini でケースの概要を作成する
[Create Gemini Case Summary] アクションを使用して、新しい Gemini ケースの概要を作成し、アラートに追加します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
なし
アクションの出力
Create Gemini Case Summary アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Create Gemini Case Summary アクションを使用した場合に受信する JSON 結果の出力を示しています。
{
"summary": "On the Linux agent instance-1 (IP addresses 10.150.0.3 and 34.85.128.214), user vanshikavw_google_com initiated the process curl (SHA1 hash 3395856ce81f2b7382dee72602f798b642f14140) to create the malware file /home/vanshikavw_google_com/eicar_test_vanshikavw-test-new.\n* VirusTotal identifies the SHA1 hash 3395856ce81f2b7382dee72602f798b642f14140 as a virus.eicar/test.\n* CURL is associated with multiple actors, including APT27, APT34, APT41, APT44, APT9, FIN11, FIN13, FIN6, TEMP.Armageddon, Turla Team, UNC1151, UNC1860, UNC215, UNC2165, UNC2500, UNC251, UNC2595, UNC2633, UNC2900, UNC2975, UNC3569, UNC3661, UNC3944, UNC4483, UNC4936, UNC4962, UNC5007, UNC5051, UNC5055, UNC5156, UNC5221, UNC5266, UNC5330, UNC5371, UNC5470, UNC5859, and UNC961.\n* CURL is known to use MITRE ATT&CK techniques such as T1113, T1095, T1036, T1553, T1222, T1055, T1140, T1070, T1027, T1622, T1057, T1010, T1083, T1518, T1082, T1016, T1059, T1496, and T1588.\n* A GTI MALWARE search did not find any information about eicar_test_vanshikavw-test-new.\n* A GTI IP_ADDRESS search did not find any information about 10.150.0.3 or 34.85.128.214.",
"next_steps": ["Isolate instance-1 to prevent any potential lateral movement or further compromise of the network, as the curl process is associated with multiple threat actors.",
"Investigate the user account vanshikavw_google_com to determine if the user's credentials have been compromised or if the user initiated the curl process intentionally, as the curl process is associated with multiple threat actors.",
"Analyze the network traffic to and from the IP addresses 10.150.0.3 and 34.85.128.214 for any suspicious communication patterns, as the curl process is associated with multiple threat actors.",
"Examine the process execution logs on instance-1 for any other unusual or unauthorized activities, as the curl process is associated with multiple threat actors.",
"Review the configuration of the Linux agent on instance-1 to ensure that it is properly secured and that no unauthorized modifications have been made, as the curl process is associated with multiple threat actors."],
"reasons": ["The case involves a Linux agent instance-1 (IP addresses 10.150.0.3 and 34.85.128.214) where user vanshikavw_google_com initiated the process curl to create the file /home/vanshikavw_google_com/eicar_test_vanshikavw-test-new.",
"The SHA1 hash 3395856ce81f2b7382dee72602f798b642f14140 of the curl process is identified by VirusTotal as virus.eicar/test, indicating it is a known test virus.",
"The process CURL is associated with multiple threat actors, including APT27, APT34, APT41, APT44, APT9, FIN11, FIN13, FIN6, TEMP.Armageddon, Turla Team, UNC1151, UNC1860, UNC215, UNC2165, UNC2500, UNC251, UNC2595, UNC2633, UNC2900, UNC2975, UNC3569, UNC3661, UNC3944, UNC4483, UNC4936, UNC4962, UNC5007, UNC5051, UNC5055, UNC5156, UNC5221, UNC5266, UNC5330, UNC5371, UNC5470, UNC5859, and UNC961, suggesting a potential link to malicious activity.",
"CURL is known to use various MITRE ATT&CK techniques such as T1113, T1095, T1036, T1553, T1222, T1055, T1140, T1070, T1027, T1622, T1057, T1010, T1083, T1518, T1082, T1016, T1059, T1496, and T1588, indicating a wide range of potential malicious behaviors.",
"The file eicar_test_vanshikavw-test-new was not found in GTI MALWARE searches, and the IP addresses 10.150.0.3 and 34.85.128.214 were not found in GTI IP_ADDRESS searches."]
}
出力メッセージ
Create Gemini Case Summary アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Create Gemini Case Summary".
Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Create Gemini Case Summary] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
エンティティ プロパティの作成または更新
[エンティティ プロパティの作成または更新] アクションを使用して、エンティティ スコープ内のエンティティのプロパティを作成または変更します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
Create Or Update Entity Properties アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Entity Field |
必須。 作成または更新するエンティティ フィールド。 |
Field Value |
必須。 指定されたエンティティ フィールドの値。 |
アクションの出力
Create Or Update Entity Properties アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Create Or Update Entity Properties] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Create Or Update Entity Properties".
Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、エンティティ プロパティの作成または更新アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースをエクスポート
[Export Case] アクションを使用して、ケース情報と添付ファイルを含むアーカイブを作成します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Export Case] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Export Method |
省略可。 アクションのアーカイブの宛先と取得方法。
値は次のいずれかになります。
デフォルト値は |
Fields To Export |
省略可。 エクスポートに含めるケース フィールドのカンマ区切りのリスト( 値が指定されていない場合、アクションは利用可能なすべてのメタデータを含むケースをエクスポートします。 |
Include Attachments |
省略可。 選択すると、アクションはアーカイブに添付ファイルを含めます。 デフォルトで有効になっています。 |
Attachment Names |
省略可。 アーカイブに含める添付ファイルのカンマ区切りのリスト。 値を指定しない場合、アクションはすべての添付ファイルをエクスポートします。 |
アクションの出力
Export Case アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Export Case アクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"file_path": "/tmp/case_1_Default_Environment_1919191919.zip",
"export_type": "case_wall/file_system"
}
出力メッセージ
Export Case アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Export Case". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Export Case] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースアラートを取得する
[Get Case Alerts] アクションを使用して、指定したケースに関連するアラートを取得します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Get Case Alerts アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Case ID |
必須。 アクションが関連するアラートを取得するケース ID のカンマ区切りのリスト。 |
Alert ID |
省略可。 アラート ID のカンマ区切りのリスト。返されるアラートを制限します。 このパラメータは、 |
Fields To Return |
省略可。 JSON 結果で返されるフィールドのカンマ区切りのリスト。 ネストされた値を取得するには、 値を指定しない場合、すべてのフィールドが返されます。 |
Nested Keys Delimiter |
省略可。 返すフィールドを定義するときに、ネストされたキーとリスト インデックスを区切るために使用される文字。 このパラメータをカンマ( |
ケースの詳細を取得する
[Get Case Details] アクションを使用して、ケースからすべてのデータ(コメント、エンティティ情報、分析情報、実行されたハンドブック、アラート情報、イベントなど)を取得します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Get Case Details アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Case Id |
省略可。 詳細情報を取得するケースの ID。 値が指定されていない場合、アクションは現在のケースを使用します。 |
Fields to Return |
省略可。 返されるフィールドのカンマ区切りのリスト。 何も指定しないと、すべてのフィールドが返されます。 特定のネストされた値を取得するには、 |
Nested Keys Delimiter |
省略可。 特定のフィールドをリクエストするときに、ネストされたキーを区切るために使用される文字。これにより、ネストされたオブジェクトから値を取得できます。 区切り文字をカンマ( |
アクションの出力
[Get Case Details] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Get Case Details アクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"id": 1001,
"creationTimeUnixTimeInMs": 1749547533606,
"modificationTimeUnixTimeInMs": 1750073142090,
"name": "Security-Incident-Phishing-01",
"isImportant": false,
"isIncident": false,
"startTimeUnixTimeInMs": 1749547529741,
"endTimeUnixTimeInMs": 1749547529741,
"assignedUser": "@Tier1_Analyst",
"description": "Potential phishing email detected with suspicious attachment.",
"isTestCase": false,
"incidentId": null,
"lastModifyingUserId": "secops_admin",
"createTime": 1749547533606,
"updateTime": 1750073142090,
"alertCount": 1,
"type": "External",
"overflowCase": false,
"status": "Opened",
"score": 21,
"involvedSuspiciousEntity": false,
"workflowStatus": "Completed",
"source": "Security_Server",
"products": [],
"tasks": [],
"displayName": "Phishing email detector",
"stage": "Triage",
"priority": "PriorityLow",
"important": false,
"assignee": "@Tier1_Analyst",
"incident": false,
"environment": "Production Environment",
"relatedAlerts": [],
"tags": [
"Phishing"
],
"alertCards": [
{
"id": 1024,
"creationTimeUnixTimeInMs": 1749547533634,
"modificationTimeUnixTimeInMs": 1750073142082,
"identifier": "alert-phish-778899",
"status": 0,
"name": "SUSPICIOUS PHISHING EMAIL",
"priority": 40,
"workflowsStatus": 2,
"slaExpirationUnixTime": 1749547833634,
"slaCriticalExpirationUnixTime": 1749547773634,
"startTime": 1749547529741,
"endTime": 1749547529741,
"alertGroupIdentifier": "group-id-554433",
"eventsCount": 1,
"title": "SUSPICIOUS PHISHING EMAIL",
"ruleGenerator": "Phishing email detector",
"deviceProduct": "Phishing email detector",
"deviceVendor": "Corporate Email Gateway",
"playbookAttached": "Phishing Response Playbook",
"playbookRunCount": 1,
"isManualAlert": false,
"sla": {
"slaExpirationTime": 1749547833634,
"criticalExpirationTime": 1749547773634,
"expirationStatus": 0,
"remainingTimeSinceLastPause": null
},
"fieldsGroups": [],
"sourceUrl": null,
"sourceRuleUrl": null,
"siemAlertId": null,
"relatedCases": [],
"lastSourceUpdateUnixTimeInMs": null,
"nestingDepth": 0,
"eventCount": 1,
"caseId": 1001,
"createTime": 1750684686624,
"updateTime": 1750684686949,
"product": "Microsoft:AccessDisabledAccounts",
"displayName": "ACCESS DISABLED ACCOUNTS",
"vendor": "Microsoft",
"environment": "Production Environment",
"ticketId": "c4db60fa-b510-414a-a462-c3f215809f96",
"sourceSystemName": "Cloud App Security",
"manual": false,
"additionalProperties": "{\"Name\":\"Access Disabled Accounts\",\"Type\":\"ALERT\",\"EndTime\":\"1750684684139\",\"Alert_Id\":\"c4db60fa-b510-414a-a462-c3f215809f96\",\"TicketId\":\"c4db60fa-b510-414a-a462-c3f215809f96\",\"DisplayId\":\"c4db60fa-b510-414a-a462-c3f215809f96\",\"StartTime\":\"1750684684139\",\"IsArtifact\":\"False\",\"IsEnriched\":\"False\",\"IsTestCase\":\"False\",\"Description\":\"Access Disabled Accounts\",\"Environment\":\"Production Environment\",\"IsSuspicious\":\"False\",\"IsVulnerable\":\"False\",\"DataAccessScope\":null,\"IsInternalAsset\":\"False\",\"AlertBaseEventIds\":\"d85ca9a7-58a7-4329-b615-ebe3dcfc6fd1\",\"EstimatedStartTime\":\"1750684684139\"}",
"securityEventCards": [
{
"fields": [
{
"order": 0,
"groupName": "Highlighted Fields",
"isIntegration": false,
"isHighlight": true,
"items": [
{
"originalName": "DestinationHostName",
"name": "Destination Host Name",
"value": "WORKSTATION-01.LOCAL"
}
]
}
],
"identifier": "d7ab8656-c862-498c-a266-69718e46b1b7",
"caseId": 1001,
"alertIdentifier": "SECURITY_RISK_FOUND_ID_998877",
"name": "Virus found",
"product": "symantec:endpoint:protection",
"port": null,
"sourceSystemName": "ArcSight ESM",
"outcome": null,
"time": 1766566370354,
"type": "Virus found",
"artifactEntities": []
}
],
"involvedRelations": [],
"sourceIdentifier": "GCP_Ingestion",
"playbookStatus": 0
}
],
"isOverflowCase": false,
"isManualCase": false,
"slaExpirationUnixTime": 1749547833634,
"slaCriticalExpirationUnixTime": 1749547773634,
"stageSlaExpirationUnixTimeInMs": null,
"stageSlaCriticalExpirationUnixTimeInMs": null,
"canOpenIncident": false,
"sla": {
"slaExpirationTime": 1749547833634,
"criticalExpirationTime": 1749547773634,
"expirationStatus": 0,
"remainingTimeSinceLastPause": null
},
"stageSla": {
"slaExpirationTime": null,
"criticalExpirationTime": null,
"expirationStatus": 2,
"remainingTimeSinceLastPause": null
},
"relatedAlertTicketId": null,
"relatedAlertCards": [],
"activities": [
{
"id": "Activity-Insight-16",
"creatorUserId": "security_bot",
"activityId": 16,
"activityType": "CaseInsight",
"caseId": 1001,
"createTime": 1750068343993,
"updateTime": 1750068343993,
"alertIdentifier": "alert-phish-778899",
"activityDataJson": {
"TriggeredBy": "SecurityAutomator",
"EntityIdentifier": "URGENT: ACTION REQUIRED ON SALARY",
"EntityData": {
"CaseId": 1001,
"AlertIdentifier": "alert-phish-778899",
"AlertStatus": 0,
"Identifier": "URGENT: ACTION REQUIRED ON SALARY",
"EntityType": "EMAILSUBJECT",
"IsInternal": true,
"IsSuspicious": false,
"IsArtifact": true,
"IsPivot": false,
"Environment": "Production Environment",
"FieldsGroups": [
{
"Order": 0,
"GroupName": "Default",
"IsIntegration": false,
"IsHighlight": false,
"Items": [
{
"OriginalName": "Network_Priority",
"Name": "Network Priority",
"Value": "0"
}
]
}
],
"HighlightedFieldsGroups": [],
"IsManuallyCreated": false,
"SourceUrl": null
},
"Title": "Phishing Subject Insight",
"Content": "Detected unusual keywords in subject line.",
"Severity": 0,
"InsightType": 1,
"AdditionalDataType": null,
"AdditionalData": null,
"AdditionalDataTitle": null,
"AlertIdentifiers": [
"ALERT_PHISH_INSTANCE_ID_001"
],
"EntityType": "EMAILSUBJECT",
"CreatorUserId": "system",
"CreatorFullName": "System Administrator",
"Id": 16,
"Type": 6,
"CaseId": 1001,
"IsFavorite": false,
"ModificationTimeUnixTimeInMs": 1750068343993,
"CreationTimeUnixTimeInMs": 1750068343993,
"AlertIdentifier": "ALERT_PHISH_INSTANCE_ID_001"
},
"favorite": false
}
],
"entityCards": [
{
"identifier": "WORKSTATION-01.LOCAL",
"type": "HOSTNAME",
"suspicious": false,
"linkedEntities": [
{
"identifier": "192.168.1.50",
"type": "ADDRESS",
"suspicious": false,
"linkedEntities": [],
"direction": 0
}
]
}
],
"entities": [
{
"caseId": 1001,
"type": "FILEHASH",
"enriched": false,
"artifact": true,
"vulnerable": false,
"suspicious": false,
"attacker": false,
"pivot": false,
"internal": true,
"manuallyCreated": false,
"fields": [
{
"highlighted": false,
"displayName": "Default",
"hidden": false,
"items": [
{
"name": "Network Priority",
"originalName": "Network_Priority",
"value": "0"
}
]
}
],
"identifier": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"id": 505,
"alertIdentifier": "SECURITY_RISK_FOUND_ID_998877",
"environment": "Production Environment",
"additionalProperties": "{\"Type\":\"FILEHASH\",\"IsArtifact\":\"True\",\"IsEnriched\":\"False\",\"IsTestCase\":\"False\",\"IsVulnerable\":\"False\",\"IsInternalAsset\":\"False\",\"OriginalIdentifier\":\"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\"}",
"alertGroupIdentifier": "group-id-virus-scan-results",
"networkPriority": 0
}
],
"totalSize": 1,
"moveEnvironment": {},
"insights": [
{
"alertIdentifier": "SECURITY_RISK_FOUND_ID_998877",
"caseId": 1001,
"triggeredBy": "Analyst_John",
"title": "Endpoint Discovery",
"content": "Host workstation matched known internal asset list.",
"entity": {
"caseId": 1001,
"alertIdentifier": "SECURITY_RISK_FOUND_ID_998877",
"alertStatus": 0,
"identifier": "WORKSTATION-01.LOCAL",
"entityType": "HOSTNAME",
"isInternal": true,
"isSuspicious": false,
"isArtifact": false,
"isPivot": false,
"environment": "Production Environment",
"highlightedFieldsGroups": [],
"isManuallyCreated": false,
"sourceUrl": null,
"fields": [
{
"order": 0,
"groupName": "Entity",
"isIntegration": false,
"isHighlight": false,
"items": [
{
"originalName": "IsPivot",
"name": "Is Pivot",
"value": "False"
}
]
}
]
},
"severity": 0,
"type": 6,
"additionalDataType": null,
"additionalData": null,
"additionalDataTitle": null,
"creatorUserName": "analyst_admin",
"entityIdentifier": "WORKSTATION-01.LOCAL",
"insightType": 1,
"alertIdentifiers": [
"SECURITY_RISK_FOUND_ID_998877"
],
"entityType": "HOSTNAME",
"creatorUserId": "user_id_101",
"id": 444,
"isFavorite": false,
"modificationTimeUnixTimeInMs": 1766569221777,
"creationTimeUnixTimeInMs": 1766569221777
}
]
}
出力メッセージ
Get Case Details アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Get Case Details".
Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Get Case Details アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
コネクタ コンテキスト値の取得
[Get Connector Context Value] アクションを使用して、コネクタ コンテキストの Google SecOps データベース内の指定されたキーから値を取得します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Get Connector Context Value アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Connector Identifier |
必須。 コンテキスト値を取得するコネクタの固有識別子。 |
Key Name |
必須。 コンテキスト値が保存されるキー。 |
Create Case Wall Table |
省略可。 選択すると、取得したコンテキスト値を含むケースウォール テーブルが作成されます。 取得した値が文字数制限を超えている場合、テーブルは作成されません。 デフォルトで有効になっています。 |
アクションの出力
Get Connector Context Value アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
コネクタ コンテキスト値の取得アクションは、次のテーブルを生成できます。
テーブル名: Connector
テーブル列:
- コネクタ識別子
- Key(キー)
- 値
出力メッセージ
Get Connector Context Value アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Get Connector Context Value". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、コネクタ コンテキスト値の取得アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
カスタム フィールドの値を取得する
カスタム フィールド値を取得するアクションを使用して、指定されたスコープに基づいてカスタム フィールドの現在の値を取得します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Get Custom Field Values] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Scope |
必須。 カスタム フィールドを取得するスコープ。 値は次のいずれかになります。
|
アクションの出力
Get Custom Field Values アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、カスタム フィールド値を取得するアクションを使用した場合に受信される JSON 結果の出力を示しています。
[{
"Case": {
"Case Custom Field Name 1": "Updated Custom Field Value",
"Case Custom Field Name 2": "Updated Custom Field Value"
},
"Alert": {
"Alert Custom Field Name 1": "Updated Custom Field Value",
"Alert Custom Field Name 2": "Updated Custom Field Value"
}
}]
出力メッセージ
カスタムフィールド値の取得アクションは、以下の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Get Custom Field Values". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、カスタム フィールド値を取得アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
スコープ コンテキスト値の取得
スコープ コンテキスト値を取得アクションを使用して、指定されたキーとコンテキストで保存されている Google SecOps データベースから値を取得します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Get Scope Context Value アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Context Scope |
必須。 値を取得するコンテキスト スコープ。 値は次のいずれかになります。
デフォルト値は |
Key Name |
必須。 指定されたコンテキストに値が保存されるキー。 |
Create Case Wall Table |
省略可。 選択すると、取得したコンテキスト値を含むケースウォール テーブルが作成されます。 取得した値が文字数制限を超えている場合、テーブルは作成されません。 デフォルトで有効になっています。 |
アクションの出力
Get Scope Context Value アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
Get Scope Context Value アクションは、次のテーブルを生成できます。
テーブル名: SCOPE
テーブル列:
- Key(キー)
- 値
出力メッセージ
Get Scope Context Value アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Get Scope Context Value". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Get Scope Context Value] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
同様のケースの取得
[Get Similar Cases] アクションを使用して、類似のケースを検索し、その ID を返します。
このアクションは、Rule Generator、Port、Category Outcome、Entity Identifier、Include Open Cases、Include Closed Cases の各パラメータに論理 AND 演算子を適用して、指定されたすべての条件に一致するケースをフィルタします。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
Get Similar Cases アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Rule Generator |
省略可。 選択すると、アクションはルール ジェネレータを使用して類似のケースを検索します。 デフォルトで有効になっています。 |
Port |
省略可。 選択すると、ポート番号を使用して類似のケースが検索されます。 デフォルトで有効になっています。 |
Category Outcome |
省略可。 選択すると、カテゴリの結果を使用して類似のケースが検索されます。 デフォルトで有効になっています。 |
Entity Identifier |
省略可。 選択すると、エンティティ識別子を使用して類似のケースが検索されます。 デフォルトで有効になっています。 |
Days Back |
必須。 アクションが検索する現在の日付より前の日数。 |
Include Open Cases |
省略可。 選択すると、アクションはオープンケースを検索に含めます。 デフォルトで有効になっています。 |
Include Closed Cases |
省略可。 選択すると、アクションはクローズされたケースを検索に含めます。 デフォルトで有効になっています。 |
アクションの出力
Get Similar Cases アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Get Similar Cases アクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"results": [{
"id": 23874,
"name": "Malware",
"tags": ["hi", "Simulated Case"],
"start time": "2024-09-25 05:43:41.999000+00:00",
"start time unix": 1727243021999,
"last modified": "2025-06-19 13:24:01.062000+00:00",
"priority": "Informative",
"assigned user": "@Tier1",
"matching_criteria": {
"ruleGenerator": true,
"port": true,
"outcome": true,
"entities": true
},
"matched_entities": [
{"entity": "INSTANCE-1", "type": "HOSTNAME", "isSuspicious": false},
{"entity": "10.150.0.3", "type": "ADDRESS", "isSuspicious": false}, {"entity": "172.17.0.1", "type": "ADDRESS", "isSuspicious": false}, {"entity": "VANSHIKAVW_GOOGLE_COM", "type": "USERUNIQNAME", "isSuspicious": false},
{"entity": "CURL", "type": "PROCESS", "isSuspicious": false}, {"entity": "EICAR_TEST_VANSHIKAVW-TEST-NEW", "type": "FILENAME", "isSuspicious": false},
{"entity": "3395856CE81F2B7382DEE72602F798B642F14140", "type": "FILEHASH", "isSuspicious": false},
{"entity": "34.85.128.214", "type": "ADDRESS", "isSuspicious": false},
{"entity": "/HOME/VANSHIKAVW_GOOGLE_COM/EICAR_TEST_VANSHIKAVW-TEST-NEW", "type": "FILENAME", "isSuspicious": false}
],
"status": "Open"}],
"stats":
{"Malicious": 0.0, "Is Important": 0.0, "Is Incident": 0.0, "Status Open": 100.0},
"platform_url": "https://soarapitest.backstory.chronicle.security/"
}
出力メッセージ
類似ケースを取得アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Get Similar Cases". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Get Similar Cases アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
SimilarCasesIds |
類似のケース ID のリスト。 |
指示
指示アクションを使用して、ケースに関する指示をアナリストに直接提供します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Instruction アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Instruction |
必須。 アナリスト向けの手順。 |
アクションの出力
Instruction アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Add Vote To Entity] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Instruction". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Instruction アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
カスタムリストに含まれる
[カスタムリストに存在する] アクションを使用して、指定されたカスタムリスト内にエンティティが存在するかどうかを確認します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
Is In Custom List アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Category |
必須。 検索するカスタムリスト カテゴリの名前。 |
アクションの出力
Is In Custom List アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Is In Custom List アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Is In Custom List". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、カスタムリストに含まれるアクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
ScriptResult |
true または false |
重要としてマーク
[重要マークを付ける] アクションを使用して、ケースに重要マークを付けます。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
なし
アクションの出力
重要としてマークアクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
重要としてマークアクションは、以下の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Mark As Important". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[重要としてマーク] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
ウェブ URL を開く
[Open Web Url] アクションを使用して、ブラウザリンクを生成します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
ウェブ URL を開くアクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Title |
必須。 URL のタイトル。 |
URL |
必須。 ターゲット URL。 |
アクションの出力
Open Web Url アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Open Web Url アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Open Web Url". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[ウェブ URL を開く] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
アラートの SLA を一時停止
[Pause Alert SLA] アクションを使用して、アラートのサービスレベル契約(SLA)タイマーを一時停止します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
SLA のアラートを一時停止するアクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Message |
省略可。 アラート SLA を一時停止する理由。 |
アクションの出力
SLA のアラートを一時停止するアクションでは、次の出力が表示されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Pause Alert SLA アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Pause Alert SLA". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Pause Alert SLA アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースの SLA を一時停止
[Pause Case SLA] アクションを使用して、ケースのサービスレベル契約(SLA)タイマーを一時停止します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
ケースの SLA を一時停止アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Message |
省略可。 ケースの SLA を一時停止する理由。 |
アクションの出力
ケースの SLA を一時停止アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
ケースの SLA を一時停止アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Pause Case SLA". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Pause Case SLA アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
許可されているアラート時刻
[Permitted Alert Time] アクションを使用して、アラートの開始時刻がユーザー定義の時間条件に準拠しているかどうかを確認します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
許可されたアラート時間アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Timestamp Type |
省略可。 比較に使用するタイムスタンプのタイプ。 値は次のいずれかになります。
デフォルト値は |
Permitted Start Time |
必須。 アラートが許可される期間の開始時間( |
Permitted End Time |
必須。 アラートが許可される期間の終了時間(例: |
Monday |
省略可。 選択すると、アラートの許可された日に月曜日が含まれます。 デフォルトでは有効になっていません。 |
Tuesday |
省略可。 選択すると、アラートの許可された日に火曜日が含まれます。 デフォルトで有効になっています。 |
Wednesday |
省略可。 選択すると、アラートの許可された日に水曜日が含まれます。 デフォルトで有効になっています。 |
Thursday |
省略可。 選択すると、アラートの許可された日に木曜日が含まれます。 デフォルトでは有効になっていません。 |
Friday |
省略可。 選択すると、アラートの許可された曜日に金曜日が含まれます。 デフォルトでは有効になっていません。 |
Saturday |
省略可。 選択すると、アラートの許可された日に土曜日が含まれます。 デフォルトでは有効になっていません。 |
Sunday |
省略可。 選択すると、アラートの許可された日に日曜日が含まれます。 デフォルトでは有効になっていません。 |
Input Timezone |
省略可。 このアクションは、IANA ゾーン( IANA ゾーンを指定すると、アクションは夏時間を自動的に調整します。 |
アクションの出力
Permitted Alert Time アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Permitted Alert Time アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Permitted Alert Time". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Permitted Alert Time] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
Permitted |
true または false |
Ping
Ping アクションを使用して、Siemplify への接続をテストします。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
なし
アクションの出力
Ping アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Ping アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Ping". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
インシデントの提起
[インシデントを報告] アクションを使用して、真陽性のケースを Critical としてマークし、ケース インシデントを報告します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[インシデントを報告] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Soc Role |
省略可。 ケースを割り当てる Google SecOps SOC ロール。 |
アクションの出力
[Raise Incident] アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
インシデントを報告するアクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Raise Incident".
Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、インシデントを報告アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
| スクリプトの結果 | true または false |
タグの削除
ケースからタグを削除するには、[Remove Tag] アクションを使用します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
タグを削除アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Tag |
必須。 ケースから削除するタグのカンマ区切りのリスト。 |
アクションの出力
Remove Tag アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Remove Tag アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
Successfully removed the following tags from case CASE_ID:TAGS |
アクションが成功しました。 |
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、タグを削除アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
カスタムリストから削除
[カスタムリストから削除] アクションを使用して、アラートに関連付けられているエンティティをカスタムリスト カテゴリから削除します。
このアクションは、すべての Google SecOps エンティティに対して実行されます。
アクションへの入力
Remove From Custom List アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Category |
必須。 エンティティ識別子を削除するカスタムリスト カテゴリの名前。 |
アクションの出力
[Remove From Custom List] アクションの出力は次のとおりです。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Remove From Custom List] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Remove From Custom List". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[カスタムリストから削除] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
ScriptResult |
true または false |
アラートの SLA を再開する
[Resume Alert SLA] アクションを使用して、アラートのサービスレベル契約(SLA)タイマーの一時停止を解除して再開します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
なし
アクションの出力
Resume Alert SLA アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Resume Alert SLA アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Resume Alert SLA". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Resume Alert SLA アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースの SLA を再開
[Resume Case SLA] アクションを使用して、ケースのサービスレベル契約(SLA)タイマーの一時停止を解除して再開します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
なし
アクションの出力
[Resume Case SLA] アクションでは、次の出力が表示されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
[Resume Case SLA] アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Resume Case SLA". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Resume Case SLA アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースを検索
[Search Cases] アクションを使用して、動的フィルタ条件でケースを検索します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Search Cases アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Assignee |
省略可。 検索結果のフィルタに使用される、ケースに割り当てられたユーザーのカンマ区切りのリスト。 |
Status |
省略可。 検索結果をフィルタするために使用されるケース ステータスの選択。 値は次のいずれかになります。
|
Playbook Status |
省略可。 検索結果のフィルタに使用されるハンドブックのステータスの選択。 値は次のいずれかになります。
|
Severity |
省略可。 検索結果をフィルタするために使用されるケースの重大度レベルの選択。 値は次のいずれかになります。
|
Environment |
省略可。 検索結果のフィルタに使用される環境のカンマ区切りのリスト。複数の値は「OR」ロジックを使用して評価されます。 このパラメータは、 |
Case Names |
省略可。 検索結果のフィルタリングに使用されるケース名のカンマ区切りのリスト。複数の値は「OR」ロジックを使用して評価されます。 このパラメータは、 |
Alert Names |
省略可。 検索結果のフィルタに使用されるアラート名のカンマ区切りのリスト。複数の値は「OR」ロジックを使用して評価されます。 このパラメータは、 |
Product Names |
省略可。 検索結果のフィルタリングに使用される商品名のカンマ区切りのリスト。複数の値は「OR」ロジックを使用して評価されます。 このパラメータは、 |
Tag Names |
省略可。 検索結果のフィルタに使用されるタグ名のカンマ区切りのリスト。複数の値は「OR」ロジックを使用して評価されます。 |
Timestamp Type |
省略可。
値は次のいずれかになります。
デフォルト値は |
Time Frame |
省略可。 検索結果を制限するために使用される期間。 値は次のいずれかになります。
デフォルト値は |
Start Time |
条件付き。 検索結果の期間の開始点(ISO 8601 形式)。
|
End Time |
省略可。 検索結果の期間の終了ポイント(ISO 8601 形式)。
|
アクションの出力
Search Cases アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Search Cases アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"name": "projects//locations//instances//cases/4",
"relatedAlerts": [],
"dataAccessScopes": [],
"id": 4,
"lastModifyingUserId": "9c6562ad-f74f-424f-a2f7-c0d2d8629bbb",
"createTime": 1769592095506,
"updateTime": 1769689090290,
"alertCount": 1,
"type": "External",
"overflowCase": false,
"status": "Opened",
"involvedSuspiciousEntity": false,
"workflowStatus": "Completed",
"source": "Server",
"tags": [
{
"displayName": "Simulated Case",
"priority": 0
}
],
"products": [
{
"displayName": "Windows:AccessDisabledAccounts",
"alert": "ACCESS DISABLED ACCOUNTS_5FB4AAF2-1CB2-49F7-850D-EECCAB91B203"
}
],
"tasks": [],
"displayName": "Access Disabled Accounts",
"stage": "Triage",
"priority": "PriorityHigh",
"important": false,
"assignee": "@Administrator",
"incident": false,
"environment": "Default Environment",
"moveEnvironment": {}
}
]
出力メッセージ
Search Cases アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Search Cases". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Search Cases アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
アラートの SLA の設定
[Set Alert SLA] アクションを使用して、アラートの SLA タイマーを設定します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Set Alert SLA アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
SLA Period |
必須。 違反とみなされるまでの SLA の合計期間。 合計 SLA 期間は 30 日を超えることはできません。 デフォルト値は |
SLA Time Unit |
必須。 SLA 期間の時間単位。 値は次のいずれかになります。
デフォルト値は |
SLA Time To Critical Period |
必須。 SLA が重大な状態に入るまでの期間。 デフォルト値は |
SLA Time To Critical Unit |
必須。 クリティカルな SLA 期間の時間単位。 値は次のいずれかになります。
デフォルト値は |
アクションの出力
[Set Alert SLA] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Set Alert SLA アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Set Alert SLA". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、アラート SLA を設定アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースの SLA の設定
[Set Case SLA](ケースの SLA の設定)アクションを使用して、ケースの SLA を設定します。
このアクションは優先度が最も高く、特定のケースに定義されている既存の SLA をオーバーライドします。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Set Case SLA アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
SLA Period |
必須。 違反とみなされるまでの SLA の合計期間。 合計 SLA 期間は 30 日を超えることはできません。 デフォルト値は |
SLA Time Unit |
必須。 SLA 期間の時間単位。 値は次のいずれかになります。
デフォルト値は |
SLA Time To Critical Period |
省略可。 SLA が重大な状態に入るまでの期間。 デフォルト値は |
SLA Time To Critical Unit |
必須。 クリティカルな SLA 期間の時間単位。 値は次のいずれかになります。
デフォルト値は |
アクションの出力
Set Case SLA アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Search ASM Issues アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Set Case SLA". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ケース SLA を設定アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
カスタム フィールドを設定する
[カスタム フィールドを設定] アクションを使用して、カスタム フィールドの値を設定します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
カスタム フィールドを設定アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Scope |
必須。 カスタム フィールドに設定するスコープ。 値は次のいずれかになります。
デフォルト値は |
Custom Fields Data |
必須。 カスタム フィールドの更新された値。 1 回のアクション実行で複数のカスタム フィールドを更新できます。 デフォルト値は次のとおりです。 { "Custom Field Name 1":"Custom Field Value 1", "Custom Field Name 2":"Custom Field Value 2" } |
Append Values |
省略可。 選択すると、 選択しない場合、アクションは既存の値を デフォルトでは有効になっていません。 |
アクションの出力
[カスタム フィールドを設定] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、カスタム フィールドを設定アクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"Custom Field Name": "Updated Custom Field Value",
"Custom Field Name": "Updated Custom Field Value",
}
出力メッセージ
カスタム フィールドを設定アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
Successfully updated the following SCOPE custom fields: UPDATED_CUSTOM_FIELD_NAMES |
アクションが成功しました。 |
Error executing action "Set Custom Fields". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[カスタム フィールドを設定] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
リスクスコアを設定
[リスクスコアを設定] アクションを使用して、ケースのリスクスコアを更新します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
リスクスコアを設定アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Risk Score |
必須。 ケースに設定するリスクスコア。 |
アクションの出力
[Set Risk Score] アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Set Risk Score アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
Successfully set Risk Score for case
CASE_ID |
アクションが成功しました。 |
Error executing action "Set Risk Score". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Set Risk Score] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
スコープ コンテキスト値の設定
[Set Scope Context Value] アクションを使用して、Google SecOps データベースに保存されているキーの値を設定します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Set Scope Context Value アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Context Scope |
必須。 データを取得するコンテキスト スコープ。 値は次のいずれかになります。
デフォルト値は |
Key Name |
必須。 対応する値を取得するキー名。 |
Key Value |
必須。 指定されたキーに保存する値。 |
アクションの出力
[Set Scope Context Value] アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Set Scope Context Value アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
Successfully set context value for the context key
CONTEXT_KEY with scope
CONTEXT_SCOPE. |
アクションが成功しました。 |
Error executing action "Set Scope Context Value". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Set Scope Context Value] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ケースの説明の更新
ケースの説明を更新するには、[Update Case Description] アクションを使用します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Update Case Description アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Description |
必須。 ケースに設定する説明。 |
アクションの出力
[Update Case Description] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Update Case Description アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
Successfully updated the case description. |
アクションが成功しました。 |
Error executing action "Update Case Description". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Update Case Description アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
カスタム フィールドを待機
カスタム フィールドを待機アクションを使用して、カスタム フィールドの値がプレイブックの実行を続行するまで待機します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[カスタム フィールドを待機] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Scope |
必須。 カスタム フィールドに設定するスコープ。 値は次のいずれかになります。
デフォルト値は |
Custom Fields Data |
必須。 ハンドブックを再開するために満たす必要があるカスタム フィールドの条件。カスタム フィールド名と必要な値は、JSON オブジェクトとして構成する必要があります。 複数のフィールドに条件を設定すると、アクションはすべてのフィールドがそれぞれの条件に一致するまで待機します。
デフォルト値は、想定される JSON 形式を示しています。 { "Custom Field Name 1": "Custom Field Value 1", "Custom Field Name 2": "Custom Field Value 2" } |
アクションの出力
[Wait For Custom Fields] アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、カスタム フィールドを待機するアクションを使用した場合に受信される JSON 結果の出力を示しています。
{
"Custom Field Name": "Updated Custom Field Value",
"Custom Field Name": "Updated Custom Field Value",
}
出力メッセージ
[Wait For Custom Fields] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Wait For Custom Fields". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[Wait For Custom Fields] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
true または false |
ジョブ
ジョブの詳細については、 新しいジョブを構成すると 高度なスケジューリングをご覧ください。
Siemplify - アクション モニター
Siemplify - Actions Monitor ジョブを使用して、過去 3 時間に少なくとも 3 回失敗したアクションに関する通知を受け取ります。
ジョブ パラメータ
Siemplify - Actions Monitor ジョブには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Run Interval In Seconds |
省略可。 ジョブを実行する間隔(秒単位)。 このパラメータは、統合が失敗したハンドブック アクションをチェックする頻度を決定します。 デフォルト値は |
Is Enabled |
省略可。 選択すると、ジョブは有効になり、スケジュールどおりに実行されます。選択しない場合、ジョブは無効になり、実行されません。 デフォルトで有効になっています。 |
Siemplify - Cases Collector DB
Siemplify - Cases Collector DB ジョブを使用して、指定されたパブリッシャーからセキュリティ ケースを取得して処理します。
ジョブ パラメータ
Siemplify - Cases Collector DB ジョブには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Publisher Id |
必須。 ケースとログを収集するパブリッシャーの ID。 |
Verify SSL |
省略可。 選択すると、ジョブはパブリッシャーの SSL 証明書が有効であることを確認します。 デフォルトでは有効になっていません。 |
Siemplify - ログコレクタ
Siemplify - Logs Collector ジョブを使用して、指定したパブリッシャーからログを取得して処理します。
ジョブの入力
Siemplify - ログコレクタ ジョブには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Publisher Id |
必須。 ログを収集するパブリッシャーの ID。 |
Verify SSL |
省略可。 選択すると、ジョブはパブリッシャーの SSL 証明書が有効であることを確認します。 デフォルトでは有効になっていません。 |
Siemplify - レスポンスの統合とコネクタのアップグレード
レスポンス統合とコネクタのアップグレード ジョブを使用すると、レスポンス統合とコネクタを最新バージョンにアップグレードするか、Content Hub で新しいバージョンが利用可能になったときに通知を生成することで、環境を自動的に維持できます。
ジョブの動作
このジョブは、Content Hub をスキャンして、最新バージョンを実行していない統合とコネクタを特定します。選択した Mode に応じて、ジョブは次の処理を行います。
フィルタリング ロジック: ジョブは、次の条件を使用して、スキャン中に除外するコンポーネントを決定します。
- ステージング環境: ジョブは、すでにインストールされている統合のみをスキャンします。
Update Staging Onlyが有効になっている場合、ジョブは手動で作成されたステージング環境内の統合のみを処理します。このモードでジョブが更新を識別できるようにするには、ステージング環境を構成し、関連する統合を割り当てる必要があります。
統合: ジョブは、
Integrations To Ignoreリストを適用するときに、識別子と表示名の両方をチェックします。コネクタ: コネクタ識別子は一意ではないため、フィルタリングは表示名にのみ適用されます。
- ステージング環境: ジョブは、すでにインストールされている統合のみをスキャンします。
通知モード:
Notificationモードに設定すると、ジョブは利用可能なアップデートを識別し、次の構造のシステム通知を生成します。次のレスポンス統合の新しいバージョンが利用可能です。
{統合名}: {以前のバージョン} -> {新しいバージョン}
次のコネクタのアップデートが利用可能です。
{コネクタの表示名}これらの通知は、Google SecOps プラットフォームの 通知 [通知] > [システム通知] に表示されます。
アップグレード モード:
Upgradeモードに設定すると、ジョブは自動的に更新を適用し、次の構造の確認通知を生成します。次のレスポンス統合が最新バージョンに更新されました。
{レスポンス統合名}
次のコネクタが最新バージョンに更新されました。
{コネクタの表示名}
ジョブの入力
Siemplify - Response Integration & Connector Upgrade ジョブには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Update Staging Only |
省略可。 選択すると、ジョブは手動で構成されたステージング環境内の統合のみを更新または通知します。これにより、変更を本番環境に push する前に更新をテストできます。 デフォルトで有効になっています。 |
Update Enabled Connectors Only |
省略可。 選択すると、現在有効になっているコネクタのアップグレードまたは通知の生成のみがジョブによって行われます。無効になっているコネクタ インスタンスは、スキャン中に無視されます。 デフォルトでは選択されていません。 |
Mode |
必須。 ジョブの運用モード。 値は次のいずれかになります。
デフォルト値は |
Integrations To Ignore |
省略可。 アップグレード プロセス中にスキップする統合識別子のカンマ区切りのリスト。表示名ではなく、統合の詳細に記載されている固有識別子( |
Connectors To Ignore |
省略可。 アップグレード プロセス中にスキップするコネクタの表示名のカンマ区切りのリスト。これにより、更新する特定のコネクタ インスタンスを細かく制御できます。 |
Overwrite Custom Integration |
省略可。 選択すると、ジョブは、商用バージョンまたはコミュニティ バージョンをベースにしたカスタム統合(エクスポートされてからプラットフォームにインポートされた商用統合を含む)をアップグレードします。 デフォルトで有効になっています。 |
Ignore Ontology Mapping Update For Integrations |
省略可。 アップグレード プロセスで既存のオントロジー マッピングを保持する統合識別子のカンマ区切りのリスト。表示名ではなく、統合の詳細に記載されている固有識別子( |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。