Cisco VPN ログを収集する

パーサーのバージョン: 22.0

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

このドキュメントでは、Bindplane エージェントを使用して Cisco ASA VPN ログを Google Security Operations に取り込む方法について説明します。

パーサーは、grok パターンを使用して Cisco ASA VPN syslog メッセージからフィールドを抽出し、標準の syslog 形式と代替メッセージ構造の両方を処理します。抽出されたフィールドを統合データモデル(UDM)にマッピングし、ASA イベント ID に基づいてイベントを分類します。

始める前に

次の前提条件を満たしていることを確認してください。

  • Google SecOps インスタンス
  • Windows Server 2016 以降、または systemd を使用する Linux ホスト
  • Bindplane エージェントと Cisco ASA 間のネットワーク接続
  • プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
  • Cisco ASA への特権アクセス

Bindplane エージェントの Google SecOps 認証情報を取得する

Bindplane エージェントを Google SecOps に対して認証するには、次のいずれかの方法を選択します。

  • 新規デプロイ: Chronicle API を使用します(オプション 1)。
  • 以前のデプロイ: 2027 年 7 月 20 日に Ingestion API が廃止されるまで、取り込み認証ファイル(オプション 2)を引き続き使用します。
  1. Google Cloud コンソールにログインし、Google SecOps インスタンスにリンクされている Google Cloud プロジェクトを選択します。
  2. [IAM と管理] > [サービス アカウント] に移動します。
  3. [サービス アカウントを作成] をクリックします。
  4. 次の構成情報を指定します。
    • サービス アカウント名: アカウントの名前を入力します(例: bindplane-ingest)。
    • サービス アカウントの説明: 説明を入力します(例: Bindplane agent log ingestion)。
  5. [作成して続行] をクリックします。
  6. [このサービス アカウントにプロジェクトへのアクセスを許可する] セクションで、[ロールを選択] をクリックし、[Chronicle 編集者] を選択します。
  7. [続行] をクリックして [完了] をクリックします。
  8. 作成したサービス アカウントをクリックし、[キー] タブに移動します。
  9. [鍵を追加] > [新しい鍵を作成] の順にクリックします。
  10. [JSON] を選択し、[作成] をクリックします。鍵ファイルがパソコンにダウンロードされます。
  11. 鍵ファイルを ingestion-auth.json として Bindplane コレクタ ディレクトリ(Linux の場合は /opt/observiq-otel-collector/ingestion-auth.json、Windows の場合は C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json)に保存するか、config.yaml の creds_file_path を更新して、保存先のパスと一致させます。
  12. [IAM と管理] > [設定] に移動し、プロジェクト番号をコピーします。これはエクスポータの構成に必要です。

オプション 2: 取り込み認証ファイルをダウンロードする(レガシー)

  1. Google SecOps コンソールにログインします。
  2. [設定] > [データ管理] > [収集エージェント] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [収集エージェント] に移動します。
  3. 取り込み認証ファイルをダウンロードします。
  4. Bindplane エージェントがインストールされるシステムにファイルを安全に保存します。

Google SecOps のお客様 ID を取得する

  1. Google SecOps コンソールにログインします。
  2. [Settings] > [Administration] > [Profile] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [プロファイル] に移動します。
  3. [組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。

Bindplane エージェントをインストールする

次の手順に沿って、Windows または Linux オペレーティング システムに Bindplane エージェントをインストールします。

Windows へのインストール

  1. 管理者としてコマンド プロンプトまたは PowerShell を開きます。
  2. 次のコマンドを実行します。

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. インストールが完了するまで待ちます。

  4. 次のコマンドを実行して、インストールの内容を確認します。

    sc query observiq-otel-collector
    

    サービスが RUNNING と表示されます。

Linux へのインストール

  1. root 権限または sudo 権限でターミナルを開きます。
  2. 次のコマンドを実行します。

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. インストールが完了するまで待ちます。

  4. 次のコマンドを実行して、インストールの内容を確認します。

    sudo systemctl status observiq-otel-collector
    

    サービスが active (running) と表示されます。

その他のインストール リソース

その他のインストール オプションとトラブルシューティングについては、Bindplane エージェントのインストール ガイドをご覧ください。

syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する

構成ファイルを探す

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

構成ファイルを編集します。

  • config.yaml の内容全体を次の構成に置き換えます。

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/cisco_vpn:
        protocol: https
        # Region of your instance, for example us, europe, asia-southeast1
        location: <LOCATION>
        # Project number of the Google Cloud project linked to the instance
        project: '<PROJECT_NUMBER>'
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: chronicle.googleapis.com
        log_type: CISCO_VPN
        raw_log_field: body
    
    service:
      pipelines:
        logs/cisco_vpn_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/cisco_vpn
    

構成パラメータ

各プレースホルダを次のように置き換えます。

  • レシーバーの構成:

    • listen_address: リッスンする IP アドレスとポート。
      • 0.0.0.0: すべてのインターフェースでリッスンします(推奨)。
      • ポート 514 は標準の syslog ポートです(Linux では root が必要です。root 以外の場合は 1514 を使用します)。
  • エクスポータの構成:

    • creds_file_path: サービス アカウントの JSON キーファイルのフルパス(オプション 1):
      • Linux: /opt/observiq-otel-collector/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: Google SecOps コンソールからコピーしたお客様 ID
    • location: <LOCATION> は、Google SecOps インスタンスのリージョン(us、europe、asia-southeast1 など)に置き換えます。エクスポーターは、chronicle.googleapis.com の前にこの値を付加します。完全なリストについては、リージョン エンドポイントをご覧ください。
    • project: <PROJECT_NUMBER> を、[IAM と管理] > [設定] のプロジェクト番号に置き換えます。
    • endpoint: chronicle.googleapis.com に設定したままにします。

以前の Ingestion API エクスポータ

  • オプション 2 の取り込み認証ファイルを使用する場合は、exporters ブロックを次のように置き換えます。creds_file_path を取り込み認証ファイルのパスに設定します。インスタンスが米国以外にある場合は、malachiteingestion-pa.googleapis.com をリージョン エンドポイント(例: europe-malachiteingestion-pa.googleapis.com)に置き換えます。

    exporters:
      chronicle/cisco_vpn:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CISCO_VPN
        raw_log_field: body
    

構成ファイルを保存する

  • 編集が完了したら、ファイルを保存します。
    • Linux: Ctrl+O、Enter、Ctrl+X の順に押します。
    • Windows の場合: [ファイル] > [保存] をクリックします。

Bindplane エージェントを再起動して変更を適用する

  • Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。

    sudo systemctl restart observiq-otel-collector
    
    1. サービスが実行されていることを確認します。

      sudo systemctl status observiq-otel-collector
      
    2. ログでエラーを確認します。

      sudo journalctl -u observiq-otel-collector -f
      
  • Windows で Bindplane エージェントを再起動するには、次のいずれかのオプションを選択します。

    • 管理者としてコマンド プロンプトまたは PowerShell を実行します。

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • サービス コンソール:

      1. Win+R を押し、「services.msc」と入力して Enter キーを押します。
      2. observIQ OpenTelemetry Collector を見つけます。
      3. 右クリックして [再起動] を選択します。
      4. サービスが実行されていることを確認します。

        sc query observiq-otel-collector
        
      5. ログでエラーを確認します。

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
        

Cisco ASA VPN の syslog を構成する

  1. Cisco ASDM を開きます。
  2. [Configuration] > [Features] > [Properties] > [Logging] > [Logging Setup] に移動します。
  3. [ロギングを有効にする] チェックボックスをオンにして、syslog を有効にします。
  4. [Logging] で [Syslog サーバー] を選択し、[Add] をクリックします。
  5. [Add Syslog Server] ウィンドウで、次の構成の詳細を入力します。
    • インターフェース: アウトバウンド通信のインターフェースを選択します。
    • IP アドレス: Bindplane エージェントの IP アドレスを入力します。
    • プロトコル: [UDP] を選択します。
    • Port: Bindplane エージェントのポート番号を入力します。
    • [OK] をクリックします。
  6. [ロギング] セクションで [ロギング フィルタ] を選択します。
  7. [Syslog Servers] を選択し、[Edit] をクリックします。
  8. [重大度でフィルタ] として、リストから [情報] を選択します。
  9. [OK] をクリックします。
  10. [適用] をクリックします。

UDM マッピング テーブル

ログフィールド UDM マッピング ロジック
accesslist target.resource.name eventtype が「ASA-4-106103」の場合、message_info から抽出されます。アクセスリストの名前を表します。
action security_result.action ログ メッセージ内のキーワード(「Deny」、「Reject」、「Allow」、「Accept」など)に基づいてパーサーによって派生されます。ALLOW または BLOCK にマッピングされます。
action security_result.action_details 実行されたアクションの未加工の文字列値(「permitted」、「denied」、「disconnected」など)。
app_name principal.application プリンシパルが使用するアプリケーションの名前(「CLI」など)。イベント ID 111008、111009、111010 の message_details から抽出されます。
assigned_ipv4 なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
assigned_ipv6 なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
bytes_rcv network.received_bytes セッションで受信したバイト数。イベント ID 113019 の log_mssg から抽出。
bytes_sent network.sent_bytes セッションで送信されたバイト数。イベント ID 113019 の log_mssg から抽出。
cipher network.tls.cipher SSL セッションに使用される暗号。イベントタイプ 725012 の message_info から抽出。
cisco_message_number security_result.rule_name eventtype フィールドから抽出された Cisco メッセージ番号。
cisco_severity security_result.severity_details eventtype フィールドから抽出された未加工の Cisco の重大度レベル。
command なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
cumulative_total_count.key security_result.outcomes.key キー「cumulative_total_count」が security_result.outcomes 配列に追加されます。
cumulative_total_count.value security_result.outcomes.value message_info から抽出された累積合計数の値。
current_average_rate.key security_result.outcomes.key キー「current_average_rate」が security_result.outcomes 配列に追加されます。
current_average_rate.value security_result.outcomes.value message_info から抽出された現在の平均レートの値。
current_burst_rate.key security_result.outcomes.key キー「current_burst_rate」が security_result.outcomes 配列に追加されます。
current_burst_rate.value security_result.outcomes.value 現在のバーストレートの値。message_info から抽出されます。
desc metadata.description ログメッセージから抽出されたイベントの説明。より具体的な説明がない場合に使用されます。
description metadata.description イベントの詳細な説明。利用可能な場合はログ メッセージから抽出されます。
destination_ip target.ip、target.asset.ip 宛先 IP アドレス。さまざまなログ メッセージ形式から抽出されます。
destination_ip_port target.port または network.application_protocol さまざまなログ メッセージ形式から抽出された宛先ポート。抽出された値が数値でない場合は、アプリケーション プロトコルとして扱われます。
dst_email target.user.email_addresses または target.user.userid message_info から抽出された宛先のメールアドレスまたはユーザー ID。値がメール形式と一致する場合は email_addresses に追加され、それ以外の場合は userid として使用されます。
dst_host target.hostname 宛先ホスト名。message_info から抽出されます。
dst_ip target.ip、target.asset.ip 宛先 IP アドレス。メインの grok パターンまたは他の特定のパターンから抽出されます。
dst_port target.port 宛先ポート。メインの grok パターンまたはその他の特定のパターンから抽出されます。
duration network.session_duration セッションの実行時間。message_details から抽出され、秒に変換されます。
event_date @timestamp イベントの日時。未加工ログのさまざまなタイムスタンプ フィールドから作成され、date フィルタを使用して解析されます。
event_id metadata.product_event_type(一部) event_severity と組み合わせて使用して、metadata.product_event_type フィールドを形成します。
event_name metadata.product_event_type(一部) event_severity および event_type と組み合わせて使用され、利用可能な場合は metadata.product_event_type フィールドを形成します。
event_severity metadata.product_event_type(一部)、security_result.severity、is_alert、is_significant event_id または event_name および event_type と組み合わせて使用して、metadata.product_event_type フィールドを形成します。security_result.severity、is_alert、is_significant フィールドの導出にも使用されます。
event_type metadata.product_event_type(一部) event_name および event_severity と組み合わせて使用され、利用可能な場合は metadata.product_event_type フィールドを形成します。
eventtype metadata.product_event_type、security_result.rule_name、security_result.severity_details、security_result.severity イベントタイプ文字列。metadata.product_event_type、security_result.rule_name、security_result.severity_details、security_result.severity フィールドの導出に使用されます。
fragment_id security_result.about.resource.id IP フラグメントの ID。イベント ID 209005 の message_details から抽出されます。
group principal.group.group_display_name、principal.user.group_identifiers、target.user.group_identifiers さまざまなログ メッセージ形式から抽出されたグループ名。
group_name principal.group.group_display_name group フィールドがホスト名の場合に、このフィールドから抽出されたグループ名。
has_principal_ip なし ロジックに使用される内部変数。UDM にはマッピングされません。
has_target_ip なし ロジックに使用される内部変数。UDM にはマッピングされません。
hostname principal.hostname、principal.asset.hostname さまざまなログメッセージ形式から抽出された、プリンシパルのホスト名。
hostname2 principal.hostname、principal.asset.hostname プリンシパルのホスト名。hostname が使用できない場合にフォールバックとして抽出されます。
icmp_code なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
icmp_dst_ip target.ip、target.asset.ip ICMP エラー メッセージの宛先 IP アドレス。
icmp_id なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
icmp_src_ip principal.ip、principal.asset.ip ICMP エラー メッセージの送信元 IP アドレス。
icmp_type なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
intermediary_ip principal.ip、principal.asset.ip イベント ID 111010 の message_info から抽出された中間 IP アドレス。
invalid_ip なし ロジックに使用される内部変数。UDM にはマッピングされません。
ip_1 principal.ip、principal.asset.ip 送信元 IP と宛先 IP が同じ場合にフォールバックとして抽出される送信元 IP アドレス。
ip_2 target.ip、target.asset.ip 送信元 IP と宛先 IP が同じ場合にフォールバックとして抽出される宛先 IP アドレス。
ipprotocol network.ip_protocol IP プロトコル。さまざまなログ メッセージ形式から抽出され、大文字に変換されます。
issuer network.tls.client.certificate.issuer ピア証明書の発行者。イベント ID 717037 の message_details から抽出されます。
local_proxy_ip intermediary.ip ローカル プロキシ IP アドレス。イベント ID 713041 の message_details から抽出されます。
log_mssg security_result.description、sr.action security_result.description フィールドへの入力と、認証アクションの抽出に使用されます。
login security_result.summary ログイン ステータス(message_info から抽出)。
max_configured_rate.key security_result.outcomes.key キー「max_configured_rate」が security_result.outcomes 配列に追加されます。
max_configured_rate.value security_result.outcomes.value message_info から抽出された、構成された最大レートの値。
message_details 各種フィールド ログ メッセージのメイン部分。イベントの詳細が含まれます。イベント ID に応じて、さまざまな grok パターンを使用して解析されます。
message_info metadata.description 利用可能な場合に metadata.description フィールドに入力するために使用されます。
observer observer.hostname または observer.ip ログ メッセージから抽出されたオブザーバーのホスト名または IP アドレス。
observer_ip observer.ip オブザーバーの IP アドレス。observer フィールドから抽出されます。
peer_type なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
policy target.resource.name ポリシー名。イベント ID 113003 の message_details から抽出されます。
policy_name target.resource.name ポリシー名。イベント ID 113009 と 113011 の message_details から抽出されます。
principal_ip principal.ip、principal.asset.ip プリンシパル IP アドレス。イベント ID 113009 の message_details から抽出されます。
privilege_level_from なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
privilege_level_to なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
process principal.process.command_line プロセス名。イベント ID 711004 の message_details から抽出されます。
protocol network.ip_protocol または network.application_protocol イベントで使用されるプロトコル。さまざまなログ メッセージ形式から抽出されます。プロトコルが標準の IP プロトコル(ICMP、TCP、UDP、ESP)の場合は network.ip_protocol にマッピングされ、それ以外の場合は network.application_protocol にマッピングされます。
reason security_result.description イベントの理由。イベント ID 113016 の message_details から抽出されます。
remote_proxy_ip intermediary.ip リモート プロキシ IP アドレス。イベント ID 713041 の message_details から抽出されます。
retrieved_file target.file.full_path 取得したファイルのパス。message_info から抽出されます。
security_action security_result.action セキュリティ アクション。イベント コンテキストに基づいてパーサーによって導出されます。
security_category security_result.category セキュリティ カテゴリ。イベント コンテキストに基づいてパーサーによって導出されます。
security_result.description security_result.description ログメッセージから抽出または派生したセキュリティ結果の説明。
security_result.severity security_result.severity セキュリティ結果の重大度。event_severity フィールドから取得されます。
security_result.summary security_result.summary ログメッセージから抽出または派生したセキュリティ結果の概要。
sent_bytes network.sent_bytes 送信されたバイト数。message_info から抽出されます。
ses_id network.session_id セッション ID。message_info から抽出されます。
session_id network.session_id セッション ID。message_info から抽出されます。
sess_type principal.hostname、principal.asset.hostname セッション タイプ。log_mssg から抽出され、hostname が使用できない場合にホスト名として使用されます。
source_ip principal.ip、principal.asset.ip さまざまなログ メッセージ形式から抽出された送信元 IP アドレス。
source_ip_port principal.port 送信元ポート。さまざまなログ メッセージ形式から抽出されます。
src_email principal.user.email_addresses または principal.user.userid message_info から抽出された送信元のメールアドレスまたはユーザー ID。値がメール形式と一致する場合は email_addresses に追加され、それ以外の場合は userid として使用されます。
src_ip principal.ip、principal.asset.ip 送信元 IP アドレス。メインの grok パターンまたは他の特定のパターンから抽出されます。
src_port principal.port 送信元ポート。メインの grok パターンまたはその他の特定のパターンから抽出されます。
src_user principal.user.user_display_name ソースユーザーの表示名。イベント ID 713049 と 713120 の message_details から抽出されます。
subject network.tls.client.certificate.subject ピア証明書のサブジェクト。イベント ID 717037 の message_details から抽出されます。
summary security_result.summary イベント ID 113016 の message_details から抽出されたイベントの概要。
target_host target.hostname ターゲット ホスト名。イベント ID 113004 の message_details から抽出されます。
target_ip target.ip、target.asset.ip ターゲット IP アドレス。イベント ID 113004 の message_details から抽出されます。
target_user target.user.userid ターゲット ユーザー ID。イベント ID 113003 の message_details から抽出されます。
task_duration なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
tcp_dst_ip target.ip、target.asset.ip ICMP エラー メッセージの元の TCP ペイロードの宛先 IP アドレス。
tcp_dst_port なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
tcp_src_ip principal.ip、principal.asset.ip ICMP エラー メッセージの元の TCP ペイロードの送信元 IP アドレス。
tcp_src_port なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
threshold なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
tls_version network.tls.version TLS バージョン。イベント ID 725002 の message_details から抽出されます。
ts @timestamp イベントのタイムスタンプ。date フィルタを使用して解析されます。
ts_day @timestamp(一部) タイムスタンプの日。@timestamp フィールドの作成に使用されます。
ts_month @timestamp(一部) タイムスタンプの月。@timestamp フィールドの作成に使用されます。
ts_time @timestamp(一部) タイムスタンプから取得した時刻。@timestamp フィールドの作成に使用されます。
ts_year @timestamp(一部) タイムスタンプの年。@timestamp フィールドの作成に使用されます。
tunnel_type なし 解析されますが、このフィールドは UDM の IDM オブジェクトにマッピングされません。
user principal.user.userid、target.user.userid さまざまなログ メッセージ形式から抽出されたユーザー ID。
user_agent network.http.user_agent ユーザー エージェント文字列。イベント ID 722055 の message_details から抽出されます。
user_attr.key principal.user.attribute.labels.key ユーザー属性のキー。イベント ID 734003 と 734001 の message_details から抽出されます。
user_attr.value principal.user.attribute.labels.value ユーザー属性の値。イベント ID 734003 と 734001 の message_details から抽出されます。
userid principal.user.userid ユーザー ID。イベント ID 106103 の message_details から抽出されます。
username principal.user.userid イベント ID 111008、111009、111010、113008 の message_details から抽出されたユーザー名。
なし metadata.vendor_name 「CISCO」にハードコードされます。
なし metadata.product_name 「ASA VPN」または「VPN」にハードコードされています。
なし metadata.event_type 特定のフィールドとイベント ID の有無に基づいてパーサー ロジックによって決定されます。GENERIC_EVENT、NETWORK_CONNECTION、STATUS_UPDATE、NETWORK_FTP、USER_LOGIN、USER_LOGOUT、NETWORK_UNCATEGORIZED、USER_UNCATEGORIZED、NETWORK_FLOW のいずれかです。
なし metadata.log_type 「CISCO_VPN」にハードコードされています。
なし metadata.event_timestamp 解析された @timestamp フィールドからコピーされます。
なし extensions.auth.type イベントのコンテキストに応じて、「VPN」、「AUTHTYPE_UNSPECIFIED」、「MACHINE」のいずれかに設定されます。
なし security_result.about.resource.type イベント ID 209005 の場合は「PACKET FRAGMENT」に設定されます。
なし is_alert 重大度の高いイベント(event_severity 0 または 1)の場合は true に設定します。
なし is_significant 重大度の高いイベント(event_severity 0 または 1)の場合は true に設定します。
puser_id principal.user.userid 変更履歴からマッピング

変更ログ

このパーサーの変更ログを表示する

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