Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Digi Modems のログを収集する

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

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

Google SecOps SIEM

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

Digi モデムは、ログインイベント、認証試行、ネットワーク接続の syslog メッセージを生成する産業用セルラーモデムです。パーサーは grok パターンを使用してフィールドを抽出し、Unified Data Model（UDM）にマッピングします。

始める前に

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

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

Google SecOps の取り込み認証ファイルを取得する

Google SecOps コンソールにログインします。
[SIEM 設定] > [収集エージェント] に移動します。
取り込み認証ファイル をダウンロードします。
Bindplane エージェントがインストールされるシステムにファイルを安全に保存します。

注: この JSON ファイルには、Bindplane エージェントを Google SecOps に対して認証するための認証情報が含まれています。

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

Google SecOps コンソールにログインします。
[SIEM 設定] > [プロファイル] に移動します。
[組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。

注: Bindplane エージェントエクスポータを構成するには、顧客 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.yaml

Windows:

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

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

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

receivers:
    udplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/digi_modems:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: DIGI_MODEMS
        raw_log_field: body

service:
    pipelines:
        logs/digi_modems_to_chronicle:
            receivers:
                - udplog
            exporters:
                - chronicle/digi_modems

構成パラメータ

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

レシーバーの構成:
- 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
- customer_id: Google SecOps コンソールからコピーしたお客様 ID
- endpoint: リージョンエンドポイント URL:
  - 米国: malachiteingestion-pa.googleapis.com
  - ヨーロッパ: europe-malachiteingestion-pa.googleapis.com
  - アジア: asia-southeast1-malachiteingestion-pa.googleapis.com
  - 完全なリストについては、リージョンエンドポイントをご覧ください。

構成ファイルを保存する

編集後、ファイルを保存します。
- 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"
```

Digi Modem で syslog サーバーを構成する

Digi Remote Manager またはローカルの Digi Modem ウェブ UI にログインします。
Remote Manager を使用してデバイス構成にアクセスします。
- syslog を構成するデバイスを見つけます。
- [Device ID> Settings> Config] をクリックします。
ローカル Digi Modem ウェブ UI を使用してデバイス構成にアクセスします。
- [システム] > [構成] > [デバイス構成] をクリックします。
[System] > [Log] に移動します。
クリックして [サーバーリスト] を開きます。
[サーバーを追加 +] をクリックします。
次の構成情報を指定します。
- サーバー: Bindplane エージェントの IP アドレスを入力します。
- サーバーに送信するイベントカテゴリを選択します（デフォルトではすべてのイベントカテゴリが有効になっています）。
- Syslog 下り（外向き）ポート: Bindplane エージェントのポート番号を入力します（デフォルトは 514）。
- プロトコル: [UDP] を選択します。
[適用] をクリックします。

サポートされている Digi モデムのサンプルログ

SYSLOG

{
  "priority": 14,
  "timestamp": "Dec 28 17:27:45",
  "hostname": "host-device.router",
  "tag": "Eventlog",
  "message": "17:27:33, 28 Dec 2006,Login failure by Host: 10.0.0.25:23: CMD,Telnet"
}

SYSLOG

{
  "priority": 14,
  "timestamp": "May 25 11:03:55",
  "hostname": "internal-srv-01",
  "tag": "Eventlog",
  "message": "11:03:55, 25 May 2023,Login failure by sanitized_user: WEB"
}

SYSLOG

{
  "priority": 14,
  "timestamp": "Jun 11 23:58:26",
  "hostname": "internal-srv-01",
  "tag": "Eventlog",
  "message": "23:58:26, 11 Jun 2023,Login failure by GET /masked_path HTTP/1.0: CMD,Telnet"
}

SYSLOG

{
  "priority": 14,
  "timestamp": "Jun 19 19:52:19",
  "hostname": "gateway-device-02",
  "tag": "Eventlog",
  "message": "19:52:18, 19 Jun 2023,WEB Login OK by internal_admin lvl 0"
}

UDM マッピングテーブル

ログフィールド	UDM マッピング	ロジック
コンテンツ	security_result.description	最初の Grok 解析後に `content` フィールドから直接マッピングされます。
http_method	network.http.method	grok パターンを使用して `content` フィールドから抽出されます。
http_version	network.application_protocol_version	grok パターンを使用して `content` フィールドから抽出されます。
hostname	principal.hostname	Grok パターンを使用してログメッセージから抽出されます。
ip	target.ip	grok パターンを使用して `content` フィールドから抽出されます。
ポート	target.port	Grok パターンを使用して `content` フィールドから抽出され、整数に変換されます。
proto	network.application_protocol	grok パターンを使用して `content` フィールドから抽出されます。
ts	metadata.event_timestamp	Grok パターンを使用してログメッセージから抽出され、タイムスタンプに変換されます。
type	login_type_label.value	grok パターンを使用して `content` フィールドから抽出されます。
	extensions.auth.type	パーサーロジックによって `MACHINE` に設定されます。
	login_type_label.key	パーサーロジックによって `Login type` に設定されます。
	metadata.event_type	`ip` や `user` などの特定のフィールドの有無によって決まり、それに応じて `NETWORK_CONNECTION` または `USER_LOGIN` に設定されます。
	metadata.log_type	パーサーロジックによって `DIGI_MODEMS` に設定されます。
	metadata.product_event_type	ログメッセージの `product_type` フィールドから抽出されます。
	metadata.product_name	パーサーロジックによって `DIGI_MODEMS` に設定されます。
	metadata.vendor_name	パーサーロジックによって `DIGI_MODEMS` に設定されます。
	security_result.action	メッセージに `Login OK` または `Login failure` が含まれているかどうかによって決まり、それぞれ `ALLOW` または `BLOCK` に設定されます。
ユーザー	target.user.userid	grok パターンを使用して `content` フィールドから抽出されます。

変更ログ

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

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

Digi Modems のログを収集する

始める前に

Google SecOps の取り込み認証ファイルを取得する

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

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

Windows のインストール

Linux のインストール

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

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

構成ファイルを探す

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

構成パラメータ

構成ファイルを保存する

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

Digi Modem で syslog サーバーを構成する

サポートされている Digi モデムのサンプルログ

UDM マッピング テーブル

変更ログ

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

UDM マッピングテーブル