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)の使用

  1. Google Cloud コンソールで、[VPC ネットワーク] > [VPC ネットワーク] に移動します。
  2. [現在のプロジェクトのサブネット] タブをクリックします。
  3. フローログを有効にするサブネットを選択します。
  4. [フローログを管理] をクリックします。
  5. [新しい構成を追加] をクリックします。
  6. 構成の名前を入力します。
  7. 次の設定を行います(省略可)。
    • 集計間隔: 集計間隔を選択します(デフォルト: 5 秒)。間隔を短くすると、より詳細なデータが得られますが、ログの量が増加します。
    • メタデータを含める: VM インスタンスと VPC の詳細を含めるには、[すべてのメタデータを含める] を選択します。
    • セカンダリ サンプリング レート: サンプリング レートを設定します(デフォルト: Network Management API の場合は 100%)。レートが高いほど、キャプチャされるフローは多くなりますが、ログの量が増加します。
    • フィルタ式: 特定のフローを含めるか除外するためのオプションの CEL フィルタ式(最大 2,048 文字)。
  8. [保存] をクリックします。

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 バケットを作成する

  1. Google Cloud コンソールに移動します。
  2. プロジェクトを選択します。
  3. ナビゲーション メニューで、[Cloud Storage] > [バケット] に移動します。
  4. [バケットを作成] をクリックします。
  5. 次の構成情報を提供してください。

    設定 値
    バケットに名前を付ける グローバルに一意の名前(vpc-flow-logs-bucket など)を入力します。
    ロケーション タイプ ニーズに応じて選択します(リージョン、デュアルリージョン、マルチリージョン)。
    ロケーション ロケーションを選択します(例: us-central1)。
    ストレージ クラス Standard(頻繁にアクセスされるログに推奨)
    アクセス制御 均一(推奨)
    保護ツール 省略可: オブジェクトのバージョニングまたは保持ポリシーを有効にする
  6. [作成] をクリックします。

VPC Flow Logs を Cloud Storage にエクスポートする Logging シンクを作成する

Logging シンクは、Logging から Cloud Storage バケットに VPC Flow Logs を転送します。Google SecOps は、バケットからエクスポートされたオブジェクトを取り込みます。

ログシンクを作成します。

  1. Google Cloud コンソールで、[ロギング] > [ログルーター] に移動します。
  2. [シンクを作成] をクリックします。
  3. 次の構成情報を指定します。
    • シンク名: わかりやすい名前を入力します(例: vpc-flow-to-gcs)。
    • シンクの説明: 「Route VPC Flow Logs to Cloud Storage for Google SecOps ingestion」と入力します。
  4. [次へ] をクリックします。
  5. [シンクサービスの選択] セクションで、次の操作を行います。
    • シンクサービス: [Cloud Storage バケット] を選択します。
    • Cloud Storage バケットを選択する: バケット vpc-flow-logs-bucket を選択します。
  6. [次へ] をクリックします。
  7. [シンクに含めるログの選択] セクションで、次のフィルタを入力して 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> は、ターゲット サブネット名に置き換えます。
  8. [次へ] をクリックします。

  9. 構成を確認し、[シンクを作成] をクリックします。

シンクの書き込み権限を付与してバケットに書き込む

シンクを作成すると、Logging によってシンクに書き込みサービス アカウント(書き込み ID)が割り当てられます。この ID に、バケットにオブジェクトを書き込む権限を付与します。

  1. [ロギング] > [ログルーター] に移動します。
  2. シンク vpc-flow-to-gcs を見つけて、その他メニューをクリックし、[シンクの詳細を表示] を選択します。
  3. [書き込み ID] の値(serviceAccount:p<PROJECT_NUMBER>-<ID>@gcp-sa-logging.iam.gserviceaccount.com 形式)をコピーします。
  4. [Cloud Storage] > [バケット] に移動します。
  5. vpc-flow-logs-bucket バケットをクリックします。
  6. [権限] タブに移動します。
  7. [アクセス権を付与] をクリックします。
  8. 次の構成情報を指定します。
    • プリンシパルを追加: シンクの書き込み ID を貼り付けます(serviceAccount: 接頭辞は付けません)。
    • ロールを割り当てる: [Storage オブジェクト作成者](roles/storage.objectCreator)を選択します。
  9. [保存] をクリックします。

ログがエクスポートされていることを確認する

  1. [Cloud Storage] > [バケット] に移動します。
  2. vpc-flow-logs-bucket バケットをクリックします。
  3. シンクが最初のオブジェクトを書き込むまで数分待ちます。
  4. compute.googleapis.com/vpc_flows/ という名前のフォルダ(または日付付きのパス)が作成され、エクスポートされたログファイルが含まれていることを確認します。

VPC Flow Logs を取り込むように Google SecOps でフィードを構成する

  1. [設定] > [データ マネジメント] > [フィード] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [フィード] に移動します。
  2. [Add New Feed] をクリックします。
  3. [単一フィードを設定] をクリックします。
  4. [フィード名] フィールドに、フィードの名前を入力します(例: GCP VPC Flow Logs)。
  5. [ソースタイプ] として [Google Cloud Storage V2] を選択します。
  6. [ログタイプ] として [GCP VPC Flow] を選択します。
  7. [サービス アカウントを取得する] をクリックします。一意のサービス アカウントのメールアドレスが表示されます。例:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. このメールアドレスをコピーします。次のステップでこれを使用します。

  9. [次へ] をクリックします。

  10. 次の入力パラメータの値を指定します。

    • ストレージ バケット 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: このフィードのイベントに適用されるラベル。

  11. [次へ] をクリックします。

  12. [Finalize] 画面で新しいフィードの設定を確認し、[送信] をクリックします。

Google SecOps サービス アカウントに IAM 権限を付与する

Google SecOps サービス アカウントには、Cloud Storage バケットに対する Storage オブジェクト閲覧者のロールが必要です。

  1. [Cloud Storage] > [バケット] に移動します。
  2. vpc-flow-logs-bucket バケットをクリックします。
  3. [権限] タブに移動します。
  4. [アクセス権を付与] をクリックします。
  5. 次の構成情報を指定します。
    • プリンシパルを追加: Google SecOps サービス アカウントのメールアドレスを貼り付けます。
    • ロールを割り当てる: [Storage オブジェクト閲覧者](roles/storage.objectViewer)を選択します。
  6. [保存] をクリックします。

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 のプロフェッショナルから回答を得ることができます。