Google Cloud VPC フローログを収集する
パーサーのバージョン: 6.0
このドキュメントでは、Cloud Storage を使用して Google Cloud VPC フローログを Google Security Operations に取り込む方法について説明します。
VPC フローログは、VM インスタンスによって送受信されたネットワーク フローのサンプルを記録します。これには Google Kubernetes Engine ノードとして使用されるインスタンスも含まれます。これらのログは、ネットワーク モニタリング、フォレンジック、リアルタイム セキュリティ分析、費用の最適化に使用できます。フローログは、構成可能な間隔で接続ごとに集計され、Cloud Logging を介して準リアルタイムでエクスポートされます。Logging シンクは、VPC フローログを Cloud Storage バケットにルーティングし、Google SecOps はそこからログを取り込みます。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- 次の API が有効になっている Google Cloud プロジェクト。
- Cloud Storage API
- Cloud Logging API
- Compute Engine API
- 次の権限:
- サブネットで VPC Flow Logs を有効にする
- Cloud Storage バケットを作成、管理する
- Cloud Storage バケットの Identity and Access Management(IAM)ポリシーを管理する
- Cloud Logging API シンクを作成して管理する
- VPC Flow Logs を有効にする VPC サブネットが少なくとも 1 つ
サブネットで VPC Flow Logs を有効にする
取り込みパイプラインを構成する前に、ターゲット サブネットで VPC Flow Logs が有効になっていることを確認します。 Google Cloud は、VPC Flow Logs を管理するための 2 つの API(Network Management API(推奨)と Compute Engine API)をサポートしています。
Google Cloud コンソール(Network Management API)の使用
- Google Cloud コンソールで、[VPC ネットワーク] > [VPC ネットワーク] に移動します。
- [現在のプロジェクトのサブネット] タブをクリックします。
- フローログを有効にするサブネットを選択します。
- [フローログを管理] をクリックします。
- [新しい構成を追加] をクリックします。
- 構成の名前を入力します。
- 次の設定を行います(省略可)。
- 集計間隔: 集計間隔を選択します(デフォルト: 5 秒)。間隔を短くすると、より詳細なデータが得られますが、ログの量が増加します。
- メタデータを含める: VM インスタンスと VPC の詳細を含めるには、[すべてのメタデータを含める] を選択します。
- セカンダリ サンプリング レート: サンプリング レートを設定します(デフォルト: Network Management API の場合は 100%)。レートが高いほど、キャプチャされるフローは多くなりますが、ログの量が増加します。
- フィルタ式: 特定のフローを含めるか除外するためのオプションの CEL フィルタ式(最大 2,048 文字)。
- [保存] をクリックします。
gcloud コマンドライン ツール(Network Management API)の使用
次の構文を使用します。
gcloud network-management vpc-flow-logs-configs create <CONFIG_NAME> \ --location=global \ --subnet=projects/<PROJECT_ID>/regions/<REGION>/subnetworks/<SUBNET_NAME> \ --aggregation-interval=INTERVAL_5_SEC \ --metadata=INCLUDE_ALL_METADATA \ --flow-sampling=1.0
次のように置き換えます。
<CONFIG_NAME>: わかりやすい構成名(例:vpc-flow-logs-config)<PROJECT_ID>: 実際の Google Cloud プロジェクト ID<REGION>: サブネット リージョン(例:us-central1)<SUBNET_NAME>: サブネット名
gcloud コマンドライン ツール(Compute Engine API)の使用
次の構文を使用します。
gcloud compute networks subnets update <SUBNET_NAME> \ --region=<REGION> \ --enable-flow-logs \ --logging-aggregation-interval=interval-5-sec \ --logging-metadata=include-all \ --logging-flow-sampling=0.5 \ --project=<PROJECT_ID>
次のように置き換えます。
<SUBNET_NAME>: サブネット名<REGION>: サブネット リージョン(例:us-central1)<PROJECT_ID>: 実際の Google Cloud プロジェクト ID
Cloud Storage バケットを作成する
- Google Cloud コンソールに移動します。
- プロジェクトを選択します。
- ナビゲーション メニューで、[Cloud Storage] > [バケット] に移動します。
- [バケットを作成] をクリックします。
次の構成情報を提供してください。
設定 値 バケットに名前を付ける グローバルに一意の名前( vpc-flow-logs-bucketなど)を入力します。ロケーション タイプ ニーズに応じて選択します(リージョン、デュアルリージョン、マルチリージョン)。 ロケーション ロケーションを選択します(例: us-central1)。ストレージ クラス Standard(頻繁にアクセスされるログに推奨) アクセス制御 均一(推奨) 保護ツール 省略可: オブジェクトのバージョニングまたは保持ポリシーを有効にする [作成] をクリックします。
VPC Flow Logs を Cloud Storage にエクスポートする Logging シンクを作成する
Logging シンクは、Logging から Cloud Storage バケットに VPC Flow Logs を転送します。Google SecOps は、バケットからエクスポートされたオブジェクトを取り込みます。
ログシンクを作成します。
- Google Cloud コンソールで、[ロギング] > [ログルーター] に移動します。
- [シンクを作成] をクリックします。
- 次の構成情報を指定します。
- シンク名: わかりやすい名前を入力します(例:
vpc-flow-to-gcs)。 - シンクの説明: 「
Route VPC Flow Logs to Cloud Storage for Google SecOps ingestion」と入力します。
- シンク名: わかりやすい名前を入力します(例:
- [次へ] をクリックします。
- [シンクサービスの選択] セクションで、次の操作を行います。
- シンクサービス: [Cloud Storage バケット] を選択します。
- Cloud Storage バケットを選択する: バケット
vpc-flow-logs-bucketを選択します。
- [次へ] をクリックします。
[シンクに含めるログの選択] セクションで、次のフィルタを入力して VPC Flow Logs をキャプチャします。
resource.type="gce_subnetwork" AND log_id("compute.googleapis.com/vpc_flows")resource.type="gce_subnetwork" AND log_id("compute.googleapis.com/vpc_flows") AND resource.labels.subnetwork_name="<SUBNET_NAME>"<SUBNET_NAME>は、ターゲット サブネット名に置き換えます。
[次へ] をクリックします。
構成を確認し、[シンクを作成] をクリックします。
シンクの書き込み権限を付与してバケットに書き込む
シンクを作成すると、Logging によってシンクに書き込みサービス アカウント(書き込み ID)が割り当てられます。この ID に、バケットにオブジェクトを書き込む権限を付与します。
- [ロギング] > [ログルーター] に移動します。
- シンク
vpc-flow-to-gcsを見つけて、その他メニューをクリックし、[シンクの詳細を表示] を選択します。 - [書き込み ID] の値(
serviceAccount:p<PROJECT_NUMBER>-<ID>@gcp-sa-logging.iam.gserviceaccount.com形式)をコピーします。 - [Cloud Storage] > [バケット] に移動します。
vpc-flow-logs-bucketバケットをクリックします。- [権限] タブに移動します。
- [アクセス権を付与] をクリックします。
- 次の構成情報を指定します。
- プリンシパルを追加: シンクの書き込み ID を貼り付けます(
serviceAccount:接頭辞は付けません)。 - ロールを割り当てる: [Storage オブジェクト作成者](
roles/storage.objectCreator)を選択します。
- プリンシパルを追加: シンクの書き込み ID を貼り付けます(
- [保存] をクリックします。
ログがエクスポートされていることを確認する
- [Cloud Storage] > [バケット] に移動します。
vpc-flow-logs-bucketバケットをクリックします。- シンクが最初のオブジェクトを書き込むまで数分待ちます。
compute.googleapis.com/vpc_flows/という名前のフォルダ(または日付付きのパス)が作成され、エクスポートされたログファイルが含まれていることを確認します。
VPC Flow Logs を取り込むように Google SecOps でフィードを構成する
- [設定] > [データ マネジメント] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
- [Add New Feed] をクリックします。
- [単一フィードを設定] をクリックします。
- [フィード名] フィールドに、フィードの名前を入力します(例:
GCP VPC Flow Logs)。 - [ソースタイプ] として [Google Cloud Storage V2] を選択します。
- [ログタイプ] として [GCP VPC Flow] を選択します。
[サービス アカウントを取得する] をクリックします。一意のサービス アカウントのメールアドレスが表示されます。例:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comこのメールアドレスをコピーします。次のステップでこれを使用します。
[次へ] をクリックします。
次の入力パラメータの値を指定します。
ストレージ バケット URI: 接頭辞パスを含む Cloud Storage バケット URI を入力します。
gs://vpc-flow-logs-bucket/compute.googleapis.com/vpc_flows/- 次のように置き換えます。
vpc-flow-logs-bucket: Cloud Storage バケット名。compute.googleapis.com/vpc_flows: シンクがログを書き込むプレフィックス / フォルダパス(省略可、ルートの場合は空のままにします)。
- 次のように置き換えます。
Source deletion option: 必要に応じて削除オプションを選択します。
- なし: 転送後にファイルを削除しません(テストにおすすめ)。
- 転送されたファイルを削除する: 転送が完了した後にファイルを削除します。
- 転送されたファイルと空のディレクトリを削除する: 転送が成功した後にファイルと空のディレクトリを削除します。
ファイルの最長存続期間(日数): 過去数日間に変更されたファイルを含めます。デフォルトは 180 日です。
Asset namespace: アセットの名前空間。
Ingestion labels: このフィードのイベントに適用されるラベル。
[次へ] をクリックします。
[Finalize] 画面で新しいフィードの設定を確認し、[送信] をクリックします。
Google SecOps サービス アカウントに IAM 権限を付与する
Google SecOps サービス アカウントには、Cloud Storage バケットに対する Storage オブジェクト閲覧者のロールが必要です。
- [Cloud Storage] > [バケット] に移動します。
vpc-flow-logs-bucketバケットをクリックします。- [権限] タブに移動します。
- [アクセス権を付与] をクリックします。
- 次の構成情報を指定します。
- プリンシパルを追加: Google SecOps サービス アカウントのメールアドレスを貼り付けます。
- ロールを割り当てる: [Storage オブジェクト閲覧者](
roles/storage.objectViewer)を選択します。
[保存] をクリックします。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
_field |
additional.fields |
統合済み |
textpayload_label |
additional.fields |
統合済み |
tunnel_id_label |
additional.fields |
統合済み |
description |
metadata.description |
直接マッピングされます。 |
timestamp |
metadata.event_timestamp |
ISO8601 として解析 |
ts |
metadata.event_timestamp |
ISO8601 として解析 |
event_type |
metadata.event_type |
直接マッピングされます。 |
product_event_type |
metadata.product_event_type |
直接マッピングされます。 |
product_log_id |
metadata.product_log_id |
直接マッピングされます。 |
product_name |
metadata.product_name |
直接マッピングされます。 |
product_version |
metadata.product_version |
直接マッピングされます。 |
vendor_name |
metadata.vendor_name |
直接マッピングされます。 |
ip_protocol_out |
network.ip_protocol |
直接マッピングされます。 |
jsonPayload.bytes_sent |
network.sent_bytes |
名前変更 / マッピング |
jsonPayload.packets_sent |
network.sent_packets |
名前変更 / マッピング |
principal.ip |
principal.asset.ip |
統合済み |
target.ip |
principal.asset.ip |
統合済み |
jsonPayload.src_instance.vm_name |
principal.hostname |
直接マッピングされます。 |
target.hostname |
principal.hostname |
名前変更 / マッピング |
jsonPayload.connection.src_ip |
principal.ip |
直接マッピングされます。 |
target.ip |
principal.ip |
統合済み |
jsonPayload.src_location.city |
principal.location.city |
直接マッピングされます。 |
target.location.city |
principal.location.city |
名前変更 / マッピング |
jsonPayload.src_location.country |
principal.location.country_or_region |
直接マッピングされます。 |
target.location.country_or_region |
principal.location.country_or_region |
名前変更 / マッピング |
jsonPayload.src_instance.region |
principal.location.name |
直接マッピングされます。 |
resource.labels.location |
principal.location.name |
直接マッピングされます。 |
target.location.name |
principal.location.name |
名前変更 / マッピング |
jsonPayload.src_location.region |
principal.location.state |
直接マッピングされます。 |
target.location.state |
principal.location.state |
名前変更 / マッピング |
jsonPayload.src_vpc.project_id |
principal.namespace |
直接マッピングされます。 |
jsonPayload.src_vpc.vpc_name |
principal.namespace |
直接マッピングされます。 |
target.namespace |
principal.namespace |
名前変更 / マッピング |
jsonPayload.connection.src_port |
principal.port |
直接マッピングされます。 |
_field |
principal.resource.attribute.labels |
統合済み |
key |
principal.resource.attribute.labels |
マッピング済み: jsonPayload_src_google_service_type → _field |
src_gke_cluster_location |
principal.resource.attribute.labels |
統合済み |
src_gke_cluster_name |
principal.resource.attribute.labels |
統合済み |
src_gke_namespace |
principal.resource.attribute.labels |
統合済み |
src_gke_pod_name |
principal.resource.attribute.labels |
統合済み |
logName |
security_result.category_details |
統合済み |
severity |
security_result.severity |
マッピング済み: DEBUG → LOW |
principal.ip |
target.asset.ip |
統合済み |
target.ip |
target.asset.ip |
統合済み |
jsonPayload.dest_instance.vm_name |
target.hostname |
直接マッピングされます。 |
principal.hostname |
target.hostname |
名前変更 / マッピング |
jsonPayload.connection.dest_ip |
target.ip |
直接マッピングされます。 |
principal.ip |
target.ip |
統合済み |
jsonPayload.dest_location.city |
target.location.city |
直接マッピングされます。 |
principal.location.city |
target.location.city |
名前変更 / マッピング |
jsonPayload.dest_location.country |
target.location.country_or_region |
直接マッピングされます。 |
principal.location.country_or_region |
target.location.country_or_region |
名前変更 / マッピング |
jsonPayload.dest_instance.region |
target.location.name |
直接マッピングされます。 |
principal.location.name |
target.location.name |
名前変更 / マッピング |
jsonPayload.dest_location.region |
target.location.state |
直接マッピングされます。 |
principal.location.state |
target.location.state |
名前変更 / マッピング |
jsonPayload.dest_vpc.project_id |
target.namespace |
直接マッピングされます。 |
jsonPayload.dest_vpc.vpc_name |
target.namespace |
直接マッピングされます。 |
principal.namespace |
target.namespace |
名前変更 / マッピング |
jsonPayload.connection.dest_port |
target.port |
名前変更 / マッピング |
dest_gke_cluster_location |
target.resource.attribute.labels |
統合済み |
dest_gke_cluster_name |
target.resource.attribute.labels |
統合済み |
dest_gke_namespace |
target.resource.attribute.labels |
統合済み |
dest_gke_pod_name |
target.resource.attribute.labels |
統合済み |
service_name_label |
target.resource.attribute.labels |
統合済み |
service_namespace_label |
target.resource.attribute.labels |
統合済み |
subnetwork_id_field |
target.user.attribute.labels |
統合済み |
| なし | network.direction |
定数: OUTBOUND |
| なし | network.ip_protocol |
定数: network.ip_protocol |
| なし | network.sent_bytes |
定数: network.sent_bytes |
| なし | principal.hostname |
定数: target.hostname |
| なし | principal.location.city |
定数: target.location.city |
| なし | principal.location.country_or_region |
定数: target.location.country_or_region |
| なし | principal.location.name |
定数: target.location.name |
| なし | principal.location.state |
定数: target.location.state |
| なし | principal.namespace |
定数: target.namespace |
| なし | principal.port |
定数: principal.port |
| なし | security_result.severity |
定数: LOW |
| なし | target.hostname |
定数: principal.hostname |
| なし | target.location.city |
定数: principal.location.city |
| なし | target.location.country_or_region |
定数: principal.location.country_or_re... |
| なし | target.location.name |
定数: principal.location.name |
| なし | target.location.state |
定数: principal.location.state |
| なし | target.namespace |
定数: principal.namespace |
| なし | target.port |
定数: -99 |
resource.labels.subnetwork_id |
target.user.attribute.labels |
変更履歴からマッピング |
変更ログ
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。