Cisco Prime のログを収集する
パーサーのバージョン: 1.0
このドキュメントでは、Bindplane を使用して Cisco Prime ログを Google Security Operations に取り込む方法について説明します。パーサーは、Grok パターンを使用してさまざまな syslog メッセージ形式からフィールドを抽出し、統合データモデル(UDM)にマッピングします。Key-Value ペアを含むさまざまなログ構造を処理し、ログ メッセージ内で見つかった特定のキーワードとパターンに基づいて、ユーザー、プリンシパル、ターゲット、セキュリティ情報でデータを拡充します。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Windows 2016 以降、または
systemdを使用する Linux ホスト - プロキシの背後で実行している場合は、ファイアウォール ポートが開いていることを確認します。
- Cisco Prime への特権アクセス
Bindplane エージェントの Google SecOps 認証情報を取得する
Bindplane エージェントを Google SecOps に対して認証するには、次のいずれかの方法を選択します。
- 新規デプロイ: Chronicle API を使用します(オプション 1)。
- 以前のデプロイ: 2027 年 7 月 20 日に Ingestion API が廃止されるまで、取り込み認証ファイル(オプション 2)を引き続き使用します。
オプション 1: Chronicle API のサービス アカウントを作成する(推奨)
- Google Cloud コンソールにログインし、Google SecOps インスタンスにリンクされている Google Cloud プロジェクトを選択します。
- [IAM と管理] > [サービス アカウント] に移動します。
- [サービス アカウントを作成] をクリックします。
- 次の構成情報を指定します。
- サービス アカウント名: アカウントの名前を入力します(例:
bindplane-ingest)。 - サービス アカウントの説明: 説明を入力します(例:
Bindplane agent log ingestion)。
- サービス アカウント名: アカウントの名前を入力します(例:
- [作成して続行] をクリックします。
- [このサービス アカウントにプロジェクトへのアクセスを許可する] セクションで、[ロールを選択] をクリックし、[Chronicle 編集者] を選択します。
- [続行] をクリックして [完了] をクリックします。
- 作成したサービス アカウントをクリックし、[キー] タブに移動します。
- [鍵を追加] > [新しい鍵を作成] の順にクリックします。
- [JSON] を選択し、[作成] をクリックします。鍵ファイルがパソコンにダウンロードされます。
- 鍵ファイルを
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を更新して、保存先のパスと一致させます。 - [IAM と管理] > [設定] に移動し、プロジェクト番号をコピーします。これはエクスポータの構成に必要です。
オプション 2: 取り込み認証ファイルをダウンロードする(レガシー)
- Google SecOps コンソールにログインします。
- [設定] > [データ管理] > [収集エージェント] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [収集エージェント] に移動します。
- 取り込み認証ファイルをダウンロードします。
- Bindplane エージェントがインストールされるシステムにファイルを安全に保存します。
Google SecOps のお客様 ID を取得する
- Google SecOps コンソールにログインします。
- [Settings] > [Administration] > [Profile] に移動します。SIEM のみのプラットフォームを使用している場合は、[設定] > [プロファイル] に移動します。
- [組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。
Bindplane エージェントをインストールする
次の手順に沿って、Windows または Linux オペレーティング システムに Bindplane エージェントをインストールします。
Windows へのインストール
- 管理者として コマンド プロンプトまたは PowerShell を開きます。
次のコマンドを実行します。
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Linux へのインストール
- root 権限または sudo 権限でターミナルを開きます。
次のコマンドを実行します。
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
その他のインストール リソース
その他のインストール オプションについては、インストール ガイドをご覧ください。
Syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する
- 構成ファイルにアクセスします。
config.yamlファイルを見つけます。通常、Linux の場合は/opt/observiq-otel-collector/ディレクトリ、Windows の場合はインストール ディレクトリにあります。- テキスト エディタ(
nano、vi、メモ帳など)を使用してファイルを開きます。
config.yamlファイルを次のように編集します。receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: 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 # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: chronicle.googleapis.com # Add optional ingestion labels for better organization log_type: 'CISCO_PRIME' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels- 自社のインフラストラクチャでの必要性に応じて、ポートと IP アドレスを置き換えます。
<LOCATION>は、Google SecOps インスタンスのリージョン(us、europe、asia-southeast1など)に置き換えます。エクスポーターは、chronicle.googleapis.comの先頭にこの値を付加します。<PROJECT_NUMBER>は、[IAM と管理] > [設定] のプロジェクト番号に置き換えます。<customer_id>は、実際のお客様 ID に置き換えます。/path/to/ingestion-authentication-file.jsonの値を、Bindplane エージェントの Google SecOps 認証情報を取得するでサービス アカウント キーファイル(オプション 1)を保存したパスに更新します。
以前の Ingestion API エクスポータ
オプション 2 の取り込み認証ファイルを使用する場合は、
exportersブロックを次のように置き換えます。creds_file_pathを取り込み認証ファイルのパスに設定します。インスタンスが米国以外にある場合は、malachiteingestion-pa.googleapis.comをリージョン エンドポイント(例:europe-malachiteingestion-pa.googleapis.com)に置き換えます。exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization log_type: 'CISCO_PRIME' raw_log_field: body ingestion_labels:
Bindplane エージェントを再起動して変更を適用する
Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。
sudo systemctl restart bindplane-agentWindows で Bindplane エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。
net stop BindPlaneAgent && net start BindPlaneAgent
変更監査通知を構成し、syslog レシーバーを構成する
次のイベントに関連する変更監査の syslog 通知を送信するようにシステムを構成できます。
- デバイス インベントリの更新
- 構成の変更
- 構成テンプレートの変更
- テンプレート関連のオペレーション
- ログイン、ログアウト、アカウントの変更などのユーザー アクティビティ
Cisco Prime ウェブ UI にログインします。
[Administration] > [Settings] > [System Settings] に移動します。
[Mail and Notification] > [Change Audit Notification] を選択します。
[変更監査通知を有効にする] チェックボックスをオンにします。
[+] ボタンをクリックして、Syslog サーバーを指定します。
次の構成情報を提供してください。
- Bindplane エージェントの IP アドレスを入力します。
- [UDP] プロトコルを選択します。
- Bindplane エージェントのポート番号を入力します。
[保存] をクリックします。
システム監査ログを syslog として転送するように構成する
- Cisco Prime ウェブ UI にログインします。
- [Administration] > [Settings] > [Logging] > [Syslog Logging Options] に移動します。
- [Syslog を有効にする] チェックボックスをオンにします。
- 次の構成情報を指定します。
- Bindplane エージェントの IP アドレスを入力します。
- [UDP] プロトコルを選択します。
- Bindplane エージェントのポート番号を入力します。
- 8 つの施設または
local0のいずれかを選択します。
- [保存] をクリックします。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
| client_ip_address | principal.ip, principal.asset.ip | 値は client_ip_address フィールドから取得されます。このフィールドは、kv フィルタを使用して未加工ログから抽出されます。 |
| 日付 | metadata.event_timestamp | 値は date フィールドから取得されます。このフィールドは、grok パターンを使用して未加工ログから抽出され、日付フィルタを使用してタイムスタンプに変換されます。 |
| 説明 | security_result.description | 値は description フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| dest_mac | target.mac | 値は dest_mac フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出され、小文字に変換されます。 |
| device_id | principal.asset_id | 値は device_id フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。最終的な値は「デバイス ID: |
| device_ip | principal.ip, principal.asset.ip | 値は device_ip フィールドから取得されます。このフィールドは、kv フィルタを使用して未加工ログから抽出されます。次に、値が JSON 配列として解析され、配列内の各 IP アドレスが UDM フィールドに追加されます。 |
| device_type | target.resource.attribute.labels.value | 値は device_type フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| dst_user | target.user.userid | 値は dst_user フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| メール | src.hostname | 値は email フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| file_path | principal.process.file.full_path | 値は file_path フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| hostname | target.resource.attribute.labels.value | 値は hostname フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| id | principal.asset_id | 値は id フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。最終的な値は「Entity ID: |
| ip_address | principal.ip, principal.asset.ip | 値は ip_address フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| log_level | security_result.severity | 値は log_level フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。severity が存在しない場合に重大度を決定するために使用されます。 |
| mac_address | principal.mac、source_mac | 値は mac_address フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出され、小文字に変換されます。source_mac が空の場合、source_mac の値としても使用されます。 |
| oid | principal.asset.product_object_id | 値は oid フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| principal_ip | principal.ip, principal.asset.ip | 値は principal_ip フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| principal_port | principal.port | 値は principal_port フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出され、整数に変換されます。 |
| process_name | principal.resource.name | 値は process_name フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| sec_description | security_result.description | 値は sec_description フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| session_id | network.session_id | 値は session_id フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| 重要度 | security_result.severity | 値は severity フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。存在する場合、重大度レベルを決定するために使用されます。 |
| source_mac | principal.mac | 値は source_mac フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出され、小文字に変換されます。空の場合、mac_address の値が使用されます。 |
| 概要 | security_result.summary | 値は summary フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| target_ip | target.ip、target.asset.ip | 値は target_ip フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| thread_pool | metadata.product_event_type | 値は thread_pool フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| timestamp | metadata.event_timestamp | 値は timestamp フィールドから取得されます。このフィールドは、grok パターンを使用して未加工ログから抽出され、日付フィルタを使用してタイムスタンプに変換されます。 |
| 種類 | metadata.product_event_type | 値は Type フィールドから取得されます。このフィールドは、kv フィルタを使用して未加工ログから抽出されます。 |
| user_name | principal.user.userid | 値は user_name フィールドから取得されます。このフィールドは、grok パターンまたは kv フィルタを使用して未加工ログから抽出されます。 |
| metadata.event_type | metadata.event_type | この値は、未加工ログ内の特定のフィールドとパターンの有無に基づいて決定されます。ロジックには以下が含まれます。 - デフォルト値: GENERIC_EVENT - thread_pool が「EmailAlertHelper」の場合: EMAIL_TRANSACTION - application_name が「aesSystem」で、desc に「HealthMonitorHelper」が含まれている場合: STATUS_HEARTBEAT - user_present と target_resource_present が両方とも true の場合: USER_RESOURCE_ACCESS - user_present が true の場合: USER_UNCATEGORIZED - principal_present と target_present が両方とも true の場合: NETWORK_CONNECTION - principal_present が true の場合: STATUS_UPDATE - dst_user が存在し、description に「logout」が含まれている場合: USER_LOGOUT - dst_user が存在し、description に「logout」が含まれていない場合: USER_LOGIN |
| metadata.vendor_name | metadata.vendor_name | 値は「CISCO」に設定されます。 |
| metadata.product_name | metadata.product_name | 値は「CISCO_PRIME」に設定されます。 |
| metadata.log_type | metadata.log_type | 値は「CISCO_PRIME」に設定されます。 |
| network.session_id | network.session_id | 値は session_id フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| principal.application | principal.application | 値は application_name フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| principal.asset.ip | principal.asset.ip | 値は、client_ip_address、device_ip、ip_address、principal_ip、target_ip のいずれかのフィールドから取得できます。 |
| principal.asset.product_object_id | principal.asset.product_object_id | 値は oid フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| principal.asset_id | principal.asset_id | 値は、device_id、id のいずれかのフィールドから取得できます。 |
| principal.ip | principal.ip | 値は、client_ip_address、device_ip、ip_address、principal_ip のいずれかのフィールドから取得できます。 |
| principal.mac | principal.mac | 値は、mac_address、source_mac のいずれかのフィールドから取得できます。 |
| principal.port | principal.port | 値は principal_port フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出され、整数に変換されます。 |
| principal.process.file.full_path | principal.process.file.full_path | 値は file_path フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| principal.resource.name | principal.resource.name | 値は process_name フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| principal.user.userid | principal.user.userid | 値は user_name フィールドから取得されます。このフィールドは、grok パターンまたは kv フィルタを使用して未加工ログから抽出されます。 |
| security_result.action | security_result.action | description に「fail」が含まれている場合、値は「BLOCK」に設定されます。 |
| security_result.description | security_result.description | 値は、desc、description、sec_description のいずれかのフィールドから取得できます。 |
| security_result.severity | security_result.severity | 値は、log_level、severity のいずれかのフィールドから取得できます。 |
| security_result.summary | security_result.summary | 値は summary フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| src.hostname | src.hostname | 値は email フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| target.asset.ip | target.asset.ip | 値は target_ip フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| target.ip | target.ip | 値は target_ip フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| target.mac | target.mac | 値は dest_mac フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出され、小文字に変換されます。 |
| target.resource.attribute.labels.key | target.resource.attribute.labels.key | 値は、コンテキストに応じて「デバイスタイプ」または「デバイスのホスト名」に設定されます。 |
| target.resource.attribute.labels.value | target.resource.attribute.labels.value | 値は、device_type、hostname のいずれかのフィールドから取得できます。 |
| target.user.userid | target.user.userid | 値は dst_user フィールドから取得されます。このフィールドは、Grok パターンを使用して未加工のログから抽出されます。 |
| extensions.auth.mechanism | extensions.auth.mechanism | dst_user が存在し、description に「password」が含まれている場合、値は「USERNAME_PASSWORD」に設定されます。 |
| extensions.auth.type | extensions.auth.type | dst_user が存在する場合、値は「MACHINE」に設定されます。 |
ts |
event.idm.read_only_udm.metadata.event_timestamp |
変更履歴からマッピング |
principal_hostname |
event.idm.read_only_udm.principal.hostname |
変更履歴からマッピング |
target_hostname |
event.idm.read_only_udm.target.hostname |
変更履歴からマッピング |
target_port |
event.idm.read_only_udm.target.port |
変更履歴からマッピング |
device_hostname |
target.resource.attribute.labels |
変更履歴からマッピング |
変更ログ
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。