Commvault のログを収集する
パーサーのバージョン: 3.0
このドキュメントでは、Bindplane エージェントを使用して Commvault ログを Google Security Operations に取り込む方法について説明します。
Commvault は、バックアップ オペレーション、アラート、イベント、システム アクティビティに関する syslog メッセージを生成します。パーサーは、ログメッセージからフィールドを抽出し、Unified Data Model(UDM)にマッピングします。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Windows Server 2016 以降、または
systemdを使用する Linux ホスト - Bindplane エージェントと Commvault システム間のネットワーク接続
- プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認する
- Commvault 管理コンソールへの特権アクセス
Google SecOps の取り込み認証ファイルを取得する
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [収集エージェント] に移動します。
- 取り込み認証ファイル をダウンロードします。
Bindplane エージェントをインストールするシステムに、ファイルを安全に保存します。
Google SecOps のお客様 ID を取得する
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [プロファイル] に移動します。
[組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。
Bindplane エージェントをインストールする
次の手順に沿って、Windows または Linux オペレーティング システムに Bindplane エージェントをインストールします。
Windows へのインストール
- 管理者としてコマンド プロンプト または PowerShell を開きます。
次のコマンドを実行します。
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietインストールが完了するまで待ちます。
次のコマンドを実行して、インストールの内容を確認します。
sc query observiq-otel-collectorサービスは RUNNING と表示されます。
Linux へのインストール
- root 権限または sudo 権限でターミナルを開きます。
次のコマンドを実行します。
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shインストールが完了するまで待ちます。
次のコマンドを実行して、インストールの内容を確認します。
sudo systemctl status observiq-otel-collectorサービスは active (running) と表示されます。
その他のインストール リソース
その他のインストール オプションとトラブルシューティングについては、Bindplane エージェントのインストール ガイドをご覧ください。
syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する
構成ファイルを探す
Linux:
sudo nano /etc/bindplane-agent/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
構成ファイルを編集する
config.yamlの内容全体を次の構成に置き換えます。receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/commvault: compression: gzip creds_file_path: '/etc/bindplane-agent/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: COMMVAULT raw_log_field: body service: pipelines: logs/commvault_to_chronicle: receivers: - udplog exporters: - chronicle/commvault
構成パラメータ
各プレースホルダを次のように置き換えます。
レシーバーの構成:
listen_address: リッスンする IP アドレスとポート:- すべてのインターフェースでリッスンするには
0.0.0.0(推奨) - ポート
514は標準の syslog ポートです(Linux では root が必要です。root 以外の場合は1514を使用します)。
- すべてのインターフェースでリッスンするには
エクスポータの構成:
creds_file_path: 取り込み認証ファイルのフルパス:- Linux:
/etc/bindplane-agent/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: Google SecOps コンソールからコピーしたお客様 IDendpoint: リージョン エンドポイント URL:- 米国:
malachiteingestion-pa.googleapis.com - ヨーロッパ:
europe-malachiteingestion-pa.googleapis.com - アジア:
asia-southeast1-malachiteingestion-pa.googleapis.com - 完全なリストについては、リージョン エンドポイントをご覧ください。
- 米国:
構成ファイルを保存する
- 編集後、ファイルを保存します。
- Linux:
Ctrl+O、Enter、Ctrl+Xを押します。 - Windows: [ファイル] > [保存] をクリックします。
- Linux:
Bindplane エージェントを再起動して変更を適用する
Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。
sudo systemctl restart observiq-otel-collectorサービスが実行されていることを確認します。
sudo systemctl status observiq-otel-collectorログでエラーを確認します。
sudo journalctl -u observiq-otel-collector -f
Windows で Bindplane エージェントを再起動するには、次のいずれかのオプションを選択します。
管理者としてコマンド プロンプトまたは PowerShell を実行する:
net stop observiq-otel-collector && net start observiq-otel-collectorサービス コンソール:
Win+Rを押してservices.mscと入力し、Enter キーを押します。- observIQ OpenTelemetry Collector を探します。
- 右クリックして [再起動] を選択します。
サービスが実行されていることを確認します。
sc query observiq-otel-collectorログでエラーを確認します。
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
Commvault Cloud で syslog を構成する
- Commvault 管理コンソールにログインします。
- [Manage] > [System] に移動します。
- [SIEM] コネクタ タイルをクリックします。
- [Add connector] をクリックします。
- [General] タブで、次の詳細を入力します。
- コネクタ名: コネクタの名前を入力します。
- **Connector type**: [**Syslog**] を選択します。
- ストリーミング データ: エクスポートするデータを選択します。
- [次へ] をクリックします。
- [Connector Definition] タブで、[Add syslog server] をクリックします。
- 次の構成情報を提供してください。
- Syslog サーバー: Bindplane エージェントの IP アドレスを入力します。
- ポート番号: Bindplane エージェントのポート番号を入力します。
[送信] をクリックします。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
| AgentType | event.idm.read_only_udm.observer.application | ログメッセージの AgentType フィールドから取得した値。 |
| Alertid | event.idm.read_only_udm.security_result.detection_fields.value | ログメッセージの Alertid フィールドから取得した値。このフィールドは alert_id キーにマッピングされます。 |
| Alertname | event.idm.read_only_udm.security_result.detection_fields.value | ログメッセージの Alertname フィールドから取得した値。このフィールドは alert_name キーにマッピングされます。 |
| Alertseverity | event.idm.read_only_udm.security_result.severity | このフィールドは、その値に基づいて security_result.severity フィールドに入力するために使用されます。 |
| Alerttime | event.idm.read_only_udm.metadata.event_timestamp | ログメッセージの Alerttime フィールドから取得した値をタイムスタンプに変換します。 |
| BackupLevel | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの BackupLevel フィールドから取得した値。このフィールドは backup_level キーにマッピングされます。 |
| BackupSet | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの BackupSet フィールドから取得した値。このフィールドは backup_set キーにマッピングされます。 |
| Client | event.idm.read_only_udm.principal.hostname | ログメッセージの Client フィールドから取得した値。 |
| CommCell | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの CommCell フィールドから取得した値。このフィールドは comcell_field キーにマッピングされます。 |
| Computer | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの Computer フィールドから取得した値。このフィールドは computer_field キーにマッピングされます。 |
| Description | event.idm.read_only_udm.metadata.description | ログメッセージの Description フィールドから取得した値(処理とクリーンアップ後)。 |
| DetectedCriteria | event.idm.read_only_udm.security_result.detection_fields.value | ログメッセージの DetectedCriteria フィールドから取得した値。このフィールドは detected_criteria キーにマッピングされます。 |
| DetectedTime | event.idm.read_only_udm.security_result.detection_fields.value | ログメッセージの DetectedTime フィールドから取得した値。このフィールドは detected_time キーにマッピングされます。 |
| Details | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの Details フィールドから取得した値。このフィールドは details_field キーにマッピングされます。 |
| Eventid | event.idm.read_only_udm.metadata.product_log_id | ログメッセージの Eventid フィールドから取得した値。 |
| Eventseverity | event.idm.read_only_udm.security_result.severity | このフィールドは、その値に基づいて security_result.severity フィールドに入力するために使用されます。 |
| Failure | event.idm.read_only_udm.security_result.detection_fields.value | ログメッセージの Failure フィールドから取得した値。このフィールドは failure_filed キーにマッピングされます。 |
| Instance | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの Instance フィールドから取得した値。このフィールドは instance_field キーにマッピングされます。 |
| Jobid | event.idm.read_only_udm.principal.process.pid | ログメッセージの Jobid フィールドから取得した値。 |
| MonitoringCriteria | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの MonitoringCriteria フィールドから取得した値。このフィールドは monitoring_criteria キーにマッピングされます。 |
| Occurencetime | event.idm.read_only_udm.metadata.event_timestamp | ログメッセージの Occurencetime フィールドから取得した値をタイムスタンプに変換します。 |
| Opid | event.idm.read_only_udm.security_result.detection_fields.value | ログメッセージの Opid フィールドから取得した値。このフィールドは op_id キーにマッピングされます。 |
| Program | event.idm.read_only_udm.principal.application | ログメッセージの Program フィールドから取得した値。 |
| Severitylevel | event.idm.read_only_udm.security_result.severity | ログメッセージの Severitylevel フィールドから取得した値を、事前定義されたマッピングに基づいてマッピングします。 |
| StoragePoliciesUsed | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの StoragePoliciesUsed フィールドから取得した値。このフィールドは storage_policies_used キーにマッピングされます。 |
| Subclient | event.idm.read_only_udm.additional.fields.value.string_value | ログメッセージの Subclient フィールドから取得した値。このフィールドは subclient_field キーにマッピングされます。 |
| Type | event.idm.read_only_udm.security_result.detection_fields.value | ログメッセージの Type フィールドから取得した値。このフィールドは alert_type キーにマッピングされます。 |
| Username | event.idm.read_only_udm.principal.user.userid | ログメッセージの Username フィールドから取得した値。 |
| anomaly_type | event.idm.read_only_udm.security_result.detection_fields.value | grok パターンを使用して Description フィールドから抽出された値。このフィールドは detected_anomaly_type キーにマッピングされます。 |
| errors | event.idm.read_only_udm.security_result.detection_fields.value | grok パターンを使用して Description フィールドから抽出された値。このフィールドは errors_field キーにマッピングされます。 |
| file_name | event.idm.read_only_udm.security_result.detection_fields.value | grok パターンを使用して Description フィールドから抽出された値。このフィールドは detected_malicious_file キーにマッピングされます。 |
| media_agent | event.idm.read_only_udm.security_result.detection_fields.value | grok パターンを使用して Description フィールドから抽出された値。このフィールドは detected_media_agent キーにマッピングされます。 |
| no_of_files_created | event.idm.read_only_udm.security_result.detection_fields.value | grok パターンを使用して Description フィールドから抽出された値。このフィールドは no_of_files_created_field キーにマッピングされます。 |
| no_of_files_deleted | event.idm.read_only_udm.security_result.detection_fields.value | grok パターンを使用して Description フィールドから抽出された値。このフィールドは no_of_files_deleted_field キーにマッピングされます。 |
| no_of_files_modified | event.idm.read_only_udm.security_result.detection_fields.value | grok パターンを使用して Description フィールドから抽出された値。このフィールドは no_of_files_modified_field キーにマッピングされます。 |
| no_of_files_renamed | event.idm.read_only_udm.security_result.detection_fields.value | grok パターンを使用して Description フィールドから抽出された値。このフィールドは no_of_files_renamed_field キーにマッピングされます。 |
| URL | event.idm.read_only_udm.network.http.referral_url | grok パターンを使用して Description フィールドから抽出された値。 |
| event.idm.read_only_udm.metadata.event_type | Client フィールドが存在する場合は、このフィールドは STATUS_UPDATE に設定されます。存在しない場合は、GENERIC_EVENT に設定されます。 |
|
| event.idm.read_only_udm.metadata.product_name | このフィールドは COMMVAULT に設定されています。 |
|
| event.idm.read_only_udm.metadata.vendor_name | このフィールドは COMMVAULT に設定されています。 |
|
| event.idm.read_only_udm.principal.user.user_role | User フィールドが Administrator の場合、このフィールドは ADMINISTRATOR に設定されます。 |
|
Commcellname |
additional.fields |
変更履歴からマッピング |
Operation |
metadata.description |
変更履歴からマッピング |
Companyname |
principal.user.company_name |
変更履歴からマッピング |
machine_name |
principal.hostname |
変更履歴からマッピング |
locale |
additional.fields |
変更履歴からマッピング |
変更履歴
さらにサポートが必要な場合コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。