BlueCat DDI ログを収集する
パーサーのバージョン: 1.0
このドキュメントでは、Bindplane を使用して BlueCat DDI ログを Google Security Operations に取り込む方法について説明します。BlueCat DDI は、DNS、DHCP、IP アドレス管理(IPAM)を統合したソリューションで、コア ネットワーク サービスの一元管理と自動化を実現します。組織は、複雑なエンタープライズ環境全体で DNS ゾーン、DHCP スコープ、IP アドレスの割り当てを管理できます。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス。
- Windows 2016 以降、または systemd を使用する Linux ホスト。
- プロキシの背後で実行している場合は、Bindplane エージェントの要件に従ってファイアウォール ポートが開いていることを確認します。
- BlueCat Address Manager 管理コンソールへの特権アクセス。
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 の/observiq-otel-collector/ディレクトリまたは Windows のインストール ディレクトリにあります。- テキスト エディタ(
nano、vi、メモ帳など)を使用してファイルを開きます。
config.yamlファイルを次のように編集します。receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/bluecat_ddi: 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: '/path/to/ingestion-authentication-file.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: BLUECAT_DDI raw_log_field: body ingestion_labels: service: pipelines: logs/bluecat_ddi: receivers: - udplog exporters: - chronicle/bluecat_ddi
- 自社のインフラストラクチャでの必要性に応じて、ポートと 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/bluecat_ddi: compression: gzip creds_file_path: '/path/to/ingestion-authentication-file.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: BLUECAT_DDI raw_log_field: body ingestion_labels:
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"
BlueCat DDI syslog 転送を構成する
BlueCat Address Manager で syslog を構成する
- BlueCat Address Manager のウェブ インターフェースにログインします。
- [構成] プルダウン メニューから構成を選択します。
- [サーバー] タブを選択します。
- [Servers] で、構成する BDDS(BlueCat DNS/DHCP Server)の名前をクリックします。
- [Syslog] タブをクリックします。
- [Syslog] で [New] をクリックします。
- 次の構成情報を指定します。
- サーバー アドレス: Bindplane エージェント ホストの IP アドレスを入力します(例:
192.168.1.100)。 - ポート:
514(または構成済みの Bindplane エージェント ポート)を入力します。 - Transport: [UDP] を選択します。
- サーバー アドレス: Bindplane エージェント ホストの IP アドレスを入力します(例:
- [Add] をクリックして、syslog リダイレクト エントリを保存します。
- [Deploy] をクリックして、更新された構成を BDDS アプライアンスに push します。
CLI を使用して BlueCat DNS/DHCP サーバー(BDDS)で syslog を構成する
Address Manager ではなく、BDDS アプライアンスで直接 syslog 転送を構成する場合は、次の操作を行います。
- SSH 経由で BDDS アプライアンスに接続します。
- 管理者の認証情報でログインします。
syslog-ng 構成ファイルを編集します。
sudo vi /etc/syslog-ng/syslog-ng.conf次の宛先とログ ステートメントを追加します。
destination d_bindplane { udp("<BINDPLANE_IP>" port(514)); }; log { source(s_local); destination(d_bindplane); };<BINDPLANE_IP>は、Bindplane エージェント ホストの IP アドレスに置き換えます。ファイルを保存して、syslog-ng サービスを再起動します。
sudo systemctl restart syslog-ngBindplane エージェント ログをチェックして、ログが転送されていることを確認します。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
auth_mechanism |
extensions.auth.mechanism |
統合済み |
log_type |
extensions.auth.mechanism |
マッピング済み: systemd → auth_mechanism |
log_type |
extensions.auth.type |
マッピング済み: CRON → AUTHTYPE_UNSPECIFIED、audit → AUTHTYPE_UNSPECIFIED |
log_type |
intermediary |
マッピング済み: named → intermediary |
relay_ip |
intermediary.ip |
統合済み |
description |
metadata.description |
名前変更 / マッピング |
inner_message |
metadata.description |
直接マッピングされます。 |
kv.cat |
metadata.description |
直接マッピングされます。 |
msg |
metadata.description |
直接マッピングされます。 |
ts |
metadata.event_timestamp |
MMM d HH:mm:ss として解析 |
ts_date |
metadata.event_timestamp |
MMM d HH:mm:ss として解析 |
ts_timestamp |
metadata.event_timestamp |
yyyy-MM-dd HH:mm:ss として解析 |
has_principal |
metadata.event_type |
マッピング済み: true → NETWORK_CONNECTION |
log_type |
metadata.event_type |
マッピングされた値(合計 15 個、例: named → USER_UNCATEGORIZED、named → NETWORK_DNS、`dhcp... |
message |
metadata.event_type |
マッピング済み: session closed → USER_LOGOUT |
operation_type |
metadata.event_type |
マッピング済み: view → USER_UNCATEGORIZED |
csv.event_id |
metadata.product_event_type |
直接マッピングされます。 |
log_type |
network.application_protocol |
マッピング済み: named → DNS、dhcpd → DHCP |
client_mac |
network.dhcp.chaddr |
直接マッピングされます。 |
client_ip |
network.dhcp.ciaddr |
直接マッピングされます。 |
src_ip |
network.dhcp.ciaddr |
直接マッピングされます。 |
relay_ip |
network.dhcp.giaddr |
直接マッピングされます。 |
log_type |
network.dhcp.opcode |
マッピング済み: dhcpd → BOOTREQUEST、dhcpd → BOOTREPLY |
message_type |
network.dhcp.opcode |
マッピングされた値(合計 7 個、例: DHCPDISCOVER → BOOTREQUEST、"DHCPREQUEST", "BOOTREQUEST" ... |
src_ip |
network.dhcp.siaddr |
直接マッピングされます。 |
server_host |
network.dhcp.sname |
名前変更 / マッピング |
log_type |
network.dhcp.type |
マッピングされた値(合計 7 個、例: dhcpd → DISCOVER、dhcpd → REQUEST、dhcpd → OFFER) |
message_type |
network.dhcp.type |
マッピングされた値(合計 7 個、例: DHCPDISCOVER → DISCOVER、"DHCPREQUEST", "BOOTREQUEST" → `... |
src_ip |
network.dhcp.yiaddr |
直接マッピングされます。 |
log_type |
network.dns.answers |
マッピング済み: named → response |
response |
network.dns.answers |
統合済み |
log_type |
network.dns.questions |
マッピング済み: named → query |
query |
network.dns.questions |
統合済み |
question |
network.dns.questions |
統合済み |
ses |
network.session_id |
直接マッピングされます。 |
hostname |
principal.hostname |
直接マッピングされます。 |
server_host |
principal.hostname |
直接マッピングされます。 |
kv.src |
principal.ip |
統合済み |
log_type |
principal.ip |
マッピング済み: named → src_ip、dhcpd → src_ip、syslog-ng → src_ip |
src_ip |
principal.ip |
統合済み |
client_mac |
principal.mac |
統合済み |
log_type |
principal.mac |
マッピング済み: dhcpd → client_mac |
message_type |
principal.mac |
マッピング済み: DHCPDISCOVER → client_mac、"DHCPREQUEST", "BOOTREQUEST" → client_mac、`DHCPR... |
src_port |
principal.port |
名前変更 / マッピング |
acct |
principal.user.userid |
直接マッピングされます。 |
src_user |
principal.user.userid |
直接マッピングされます。 |
application |
target.application |
直接マッピングされます。 |
terminal |
target.application |
直接マッピングされます。 |
file_path |
target.file.full_path |
直接マッピングされます。 |
server_host |
target.hostname |
直接マッピングされます。 |
target_host |
target.hostname |
直接マッピングされます。 |
log_type |
target.ip |
マッピング済み: named → target_ip、dhcpd → target_ip、syslog-ng → target_ip |
server_ip |
target.ip |
統合済み |
target_ip |
target.ip |
統合済み |
client_mac |
target.mac |
統合済み |
log_type |
target.mac |
マッピング済み: dhcpd → client_mac |
message_type |
target.mac |
マッピング済み: "DHCPOFFER", "BOOTREPLY" → client_mac, DHCPACK → client_mac, DHCPNAK → `cl... |
tgt_port |
target.port |
名前変更 / マッピング |
cmd |
target.process.command_line |
直接マッピングされます。 |
exe |
target.process.command_line |
直接マッピングされます。 |
file_path |
target.process.file.full_path |
直接マッピングされます。 |
pid |
target.process.pid |
直接マッピングされます。 |
| なし | extensions.auth.type |
定数: AUTHTYPE_UNSPECIFIED |
| なし | metadata.event_type |
定数: USER_UNCATEGORIZED |
| なし | metadata.product_name |
定数: Bluecat DDI |
| なし | metadata.vendor_name |
定数: Bluecat Networks |
| なし | network.application_protocol |
定数: DNS |
| なし | network.dhcp.opcode |
定数: BOOTREQUEST |
| なし | network.dhcp.type |
定数: DISCOVER |
変更ログ
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。