GRR Rapid Response を Google SecOps と統合する
このドキュメントでは、GRR Rapid Response を構成して Google Security Operations と統合する方法について説明します。
ユースケース
GRR Rapid Response 統合は、Google SecOps の機能を使用して、次のユースケースをサポートします。
エンドポイントのフォレンジック収集: 調査中にリモート エンドポイントからファイル、レジストリキー、メモリアーティファクトを収集するフォレンジック フローを自動的にトリガーします。
迅速な脅威ハンティング: すべてのマネージド クライアントで特定のファイルまたはハッシュを検索して、侵害の範囲を特定します。
クライアント メタデータの拡充: OS バージョン、ハードウェア仕様、ネットワーク構成などの詳細なクライアント情報を取得して、セキュリティ通知のコンテキストを提供します。
インシデント対応の自動化: ハンドブックを使用して、悪意のあるアクティビティが検出された直後に、アクティブなクライアントを一覧表示したり、不審なアーティファクトを検索したりします。
始める前に
Google SecOps で統合を構成する前に、GRR Rapid Response 環境が次の要件を満たしていることを確認します。
API 認証情報: GRR サーバーへの API アクセス権を持つユーザー アカウントの有効なユーザー名とパスワードが必要です。
アカウントの権限: 統合に使用するアカウントに、フローを開始してターゲット クライアントでアーティファクトを検索するための十分な権限があることを確認します。
サーバー構成: GRR サーバーの API ルート(
https://<grr-server-address>:8000など)を特定します。ネットワーク アクセス: ネットワーク構成で、Google SecOps 環境から GRR API エンドポイントへのアウトバウンド HTTPS 接続が許可されていることを確認します。
統合のパラメータ
GRR Rapid Response の統合には、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
API Root |
必須。 ポートを含む GRR サーバー API のベース URL(例: |
Username |
必須。 接続の認証に使用される GRR アカウントのユーザー名。 |
Password |
必須。 認証に使用される GRR アカウントに関連付けられたパスワード。 |
Verify SSL |
省略可。 選択すると、統合は GRR サーバーに接続するときに SSL 証明書を検証します。 デフォルトで有効になっています。 |
Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。
必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。
操作
アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。
クライアントの詳細を取得する
Get Client Details アクションを使用して、クライアントの詳細をすべて取得します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Get Client Details アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Client ID |
必須。 クライアントの ID。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 |
アクションの出力
Get Client Details アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
[Get Client Details] アクションでは、次のテーブルを生成できます。
テーブル名: GRR のクライアントの詳細
テーブル列:
- クライアント ID
- ホスト
- OS バージョン
- ラベル
- メモリサイズ
- クライアントのバージョン
- 初回検出
- 最終検出
- OS のインストール日
JSON の結果
次の例は、Get Client Details アクションを使用した場合に受信する JSON 結果の出力を示しています。
[
{
"HardwareInfo": {
"system_product_name": "HVM domU",
"bios_rom_size": "64 kB",
"bios_vendor": "Xen",
"system_sku_number": "Not Specified",
"system_family": "Not Specified",
"system_uuid": "UUID",
"system_manufacturer": "Xen",
"bios_release_date": "08/24/2006",
"bios_version": "4.2.amazon",
"serial_number": "UUID",
"bios_revision": "4.2"
},
"LastClock": 1535907460060247,
"Interfaces": [
{
"ifname": "lo",
"addresses": [
{
"packed_bytes": "fwAAAQ==",
"address_type": "INET"
},
{
"packed_bytes": "AAAAAAAAAAAAAAAAAAAAAQ==",
"address_type": "INET6"
}
],
"mac_address": "MAC_ADDRESS"
},
{
"ifname": "eth0",
"addresses": [
{
"packed_bytes": "rB8sWw==",
"address_type": "INET"
},
{
"packed_bytes": "/oAAAAAAAAAE1kv//h5yfg==",
"address_type": "INET6"
}
],
"mac_address": "MAC_ADDRESS"
}
],
"OS": {
"kernel": "4.4.0-1065-aws",
"install_date": 1534280169000000,
"system": "Linux",
"fqdn": "ip-192-0-2-91.example",
"machine": "x86_64",
"version": "16.4",
"release": "Ubuntu"
},
"AgentInfo": {
"client_name": "grr",
"client_description": "grr linux amd64",
"client_version": 3232,
"build_time": "2018-06-28 09:37:57"
},
"Labels": [],
"LastBootedAt": 1535292604000000,
"FirstSeenAt": 1535293827970976,
"User": [],
"Volumes": [
{
"total_allocation_units": 50808745,
"bytes_per_sector": 4096,
"sectors_per_allocation_unit": 1,
"unixvolume": {
"mount_point": "/"
},
"actual_available_allocation_units": 50027766
}
],
"LastCrashAt": null,
"LastSeenAt": 1535907460075229,
"ID": "CLIENT_ID"
}
]
出力メッセージ
Get Client Details アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Get Client Details". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Get Client Details アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ハンティングの詳細を取得する
[Get Hunt Details] アクションを使用して、ハントの詳細を取得します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
[Get Hunt Details] アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Hunt ID |
必須。 取得するハントの ID。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 |
アクションの出力
[Get Hunt Details] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用可能 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォールのリンク
[Get Hunt Details] アクションでは、次のリンクを生成できます。
API_ROOT/#/hunts/HUNT_ID
JSON の結果
次の例は、Get Hunt Details アクションを使用した場合に受信される JSON 結果の出力を示しています。
[
{
"Name": "ExampleHunt",
"Expires": 1537063517000000,
"Description": "test",
"Creator": "admin",
"IsRobot": false,
"Status": "PAUSED",
"Hunt_ID": "HUNT_ID",
"Created": 1535853917657925,
"Start_Time": 1535853917657925,
"Duration": "2w",
"Expiration time": " ",
"Crash_limit": 100,
"Client_limit": 100,
"Client_rate (clients/min)": "20.5",
"Client_Queued": "20.5",
"Client_Scheduled": "20.5",
"Client_Outstanding": "20.5",
"Client_Completed": "20.5",
"Client_with Results": "20.5",
"Results": "20.5",
"Total_CPU_Time_Used": "20.5",
"Total_Network_Traffic": "20.5",
"Flow_Name": "KeepAlive",
"Flow_Arguments": "20.5",
"Client_Rule_Set": " "
}
]
出力メッセージ
[Get Hunt Details] アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Get Hunt Details". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Get Hunt Details アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
クライアントを一覧表示する
クライアントを一覧表示アクションを使用して、クライアントを検索し、操作します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
List Clients アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Offset |
省略可。 クライアントを検索する開始点(オフセット)。 |
Max Results To Return |
省略可。 すべてのレスポンスで返されるクライアントの最大数。 デフォルト値は |
アクションの出力
List Clients アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
クライアントを一覧表示アクションでは、次の表を生成できます。
テーブル名: GRR Clients
テーブル列:
- クライアント ID
- ホスト
- OS バージョン
- 初回検出
- クライアントのバージョン
- ラベル
- 前回のチェックイン
- OS のインストール日
JSON の結果
次の例は、List Clients アクションを使用した場合に受信される JSON 結果の出力を示しています。
[{
"Client_ID": "CLIENT_ID",
"Agent_Info":{
"Client_Name": "example",
"Client_Version": 3420}
"OS_Info":{
"System": "Linux",
"Release": "Ubuntu",
"Architecture": "x86_64",
"Installation_Time": "2020-04-09 13:44:17 UTC",
"Kernel": "4.15.0-96-generic",
"Version": "18.04"}
"Client_Last_Booted_At": "",
"Client_First_Seen_At": "2020-09-25 14:26:38 UTC",
"Client_Last_Seen": "2020-11-19 10:12:52 UTC",
"Client_Last_Clock": "2020-11-19 10:12:52 UTC",
"Memory_Size": "985.6MiB",
"Client_Labels": []
}]
出力メッセージ
List Clients アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "List Clients". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、List Clients アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ハントを一覧表示する
List Hunts アクションを使用して、使用可能なすべてのハントに関する情報を取得します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
List Hunts アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Creator |
省略可。 ハントを作成したユーザー。 |
Offset |
省略可。 ハントを検索する開始点(オフセット)。 |
Max Results To Return |
省略可。 各レスポンスで返されるハントの最大数。 デフォルト値は |
アクションの出力
[List Hunts] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
List Hunts アクションは、次のテーブルを生成できます。
テーブル名: Hunts
テーブル列:
- ハント ID
- ステータス
- 作成日時
- 開始時間
- 期間
- クライアントの上限
- 有効期限
- クリエイター
- 説明
JSON の結果
次の例は、List Hunts アクションの使用時に受信した JSON 結果の出力を示しています。
[
{
"Hunt_Description": "Interrogate run by cron to keep host info fresh.",
"Creator": "GRRCron",
"Is_Robot": false,
"State": "STARTED",
"Creation Time": "1605690387510082",
"Start Time (initial)": "1605690387678448",
"Start Time (last)": "1605690387678448",
"Duration": " ",
"Client Limit": 0,
"Expiration Time": " ",
"Hunt_ID": "HUNT_ID",
}
]
出力メッセージ
List Hunts アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "List Hunts". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、List Hunts アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
起動されたフローを一覧表示する
List Launched Flows アクションを使用して、指定したクライアントで起動されたフローを一覧表示します。
このアクションは、次の Google SecOps エンティティに対して実行されます。
IP AddressHostname
アクションへの入力
List Launched Flows アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Offset |
省略可。 フローを検索する開始点(オフセット)。 |
Max Results To Return |
省略可。 すべてのレスポンスで返されるフローの最大数。 デフォルト値は |
アクションの出力
[List Launched Flows] アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用可能 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
ケースウォール テーブル
List Launched Flows アクションは、次の表を生成できます。
テーブル名: GRR Launch Flows
テーブル列:
- フロー名
- フロー ID
- State
- 作成日時
- 最終アクティビティ
- クリエイター
JSON の結果
次の例は、List Launched Flows アクションの使用時に受信した JSON 結果の出力を示しています。
{
"Creator": "admin",
"NestedFlow": [],
"LastActiveAt": 1535900632278975,
"Args": {
"ARGUMENTS"
},
"State": "TERMINATED",
"StartedAt": 1535900542745106,
"Flow_ID": "FLOW_ID",
"Flow_Name": "FLOW_NAME"
}
出力メッセージ
List Launched Flows アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "List Launched Flows". Reason:
ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、List Launched Flows アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
Ping
Ping アクションを使用して、GRR Rapid Response への接続をテストします。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
なし
アクションの出力
Ping アクションは、次の出力を提供します。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用不可 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
出力メッセージ
Ping アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
Successfully connected to the GRR server with the provided
connection parameters! |
アクションが成功しました。 |
Failed to connect to the GRR server! Error is ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ハントを開始する
[Start A Hunt] アクションを使用して、新しく作成したハントを開始します。デフォルトでは、GRR Rapid Response は、すべての新しいハントに PAUSED 状態を割り当てます。
GRR Rapid Response は、クライアントの上限に達したすべてのハントを PAUSED 状態に設定します。クライアントの上限を削除したら、[Start A Hunt] アクションを使用して、一時停止したハントを再開できます。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Start A Hunt アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Hunt ID |
必須。 開始するハントの ID。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 |
アクションの出力
[Start A Hunt] アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Start A Hunt アクションの使用時に受信した JSON 結果の出力を示しています。
[{ "Hunt_ID": "HUNT_ID", "State": STARTED}]
出力メッセージ
Start A Hunt アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Start A Hunt". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
ハントを停止する
[Stop A Hunt] アクションを使用すると、新しいクライアントがスケジュールを設定できなくなり、状態が変化した時点で現在のフローが中断されます。
ハントを停止すると、再開することはできません。この操作を行うと、進行中の現在の結果がすべて削除されます。すでに報告されている結果には影響しません。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Stop A Hunt アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Hunt ID |
必須。 停止するハントの ID。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 |
アクションの出力
Stop A Hunt アクションでは、次の出力が提供されます。
| アクションの出力タイプ | 対象 |
|---|---|
| ケースウォールのアタッチメント | 利用不可 |
| ケースウォールのリンク | 利用不可 |
| ケースウォール テーブル | 利用不可 |
| 拡充テーブル | 利用不可 |
| JSON の結果 | 利用可能 |
| 出力メッセージ | 利用可能 |
| スクリプトの結果 | 利用可能 |
JSON の結果
次の例は、Stop A Hunt アクションを使用した場合に受信される JSON 結果の出力を示しています。
[{ "Hunt_ID": "HUNT_ID", "State": STOPPED}]
出力メッセージ
Stop A Hunt アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
Error executing action "Stop A Hunt". Reason: ERROR_REASON |
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Stop A Hunt アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。