BlueCat Edge DNS Resolver のログを収集する
このドキュメントでは、Bindplane を使用して BlueCat Edge DNS Resolver を Google Security Operations に取り込む方法について説明します。パーサーは、まず入力メッセージを JSON として解析しようとします。成功すると、さまざまなフィールドを抽出して Unified Data Model(UDM)スキーマに構造化します。特に DNS 関連の情報に重点を置いています。JSON の解析が失敗すると、grok や Key-Value ペアなどの代替解析方法を試して、関連データを抽出し、UDM スキーマにマッピングします。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Windows 2016 以降、または
systemd
を使用する Linux ホスト - プロキシの背後で実行されている場合、ファイアウォール ポートが開いている
- BlueCat DNS/DHCP への特権アクセス
Google SecOps の取り込み認証ファイルを取得する
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [コレクション エージェント] に移動します。
- Ingestion Authentication File をダウンロードします。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
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 では/etc/bindplane-agent/
ディレクトリに、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: 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 ingestion_labels: log_type: 'BLUECAT_EDGE' raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
- 自社のインフラストラクチャでの必要性に応じて、ポートと IP アドレスを置き換えます。
<customer_id>
は、実際の顧客 ID に置き換えます。/path/to/ingestion-authentication-file.json
の値を、Google SecOps の取り込み認証ファイルを取得するで認証ファイルを保存したパスに更新します。
Bindplane エージェントを再起動して変更を適用する
Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。
sudo systemctl restart bindplane-agent
Windows で Bindplane エージェントを再起動するには、サービス コンソールを使用するか、次のコマンドを入力します。
net stop BindPlaneAgent && net start BindPlaneAgent
BlueCat Edge DNS Resolver で Syslog を構成する
- BDDS ウェブ UI にログインします。
- [構成> サーバー] タブに移動します。
- BDDS の名前を選択して、サーバーの [詳細] タブを開きます。
- サーバー名メニュー > [サービス構成] をクリックします。
- [サービスタイプ> Syslog] をクリックします。
- 次の構成の詳細を指定します。
- [ISO 8601 タイムスタンプ] チェックボックスをオンにすると、ローカルに記録されたメッセージに ISO 8601 タイムスタンプ形式が使用されます。
- サーバー: Bindplane エージェントの IP アドレスを入力します。
- ポート: Bindplane エージェントのポート番号を入力します。
- レベル: [情報] を選択します。
- [RFC5 424 Syslog プロトコルを使用] チェックボックスをオンにして、Syslog メッセージに RFC5 424 Syslog プロトコルを使用します。
- [ISO 8601 Timestamp] チェックボックスをオンにすると、リモート syslog サーバーにリダイレクトされる syslog メッセージに ISO 8601 タイムスタンプ形式が使用されます。
- [サービスタイプ] で、[DNS]、[DHCP]、[その他のすべてのサービス] を選択します。
- トランスポート: [UDP] を選択します。
- [追加] をクリックします。
- [更新] をクリックします。
UDM マッピング テーブル
ログフィールド | UDM マッピング | ロジック |
---|---|---|
answer.domainName | network.dns.answers.name | DNS レスポンスの answer セクションのドメイン名。末尾の . が削除されます。 |
answer.recordTypeId | network.dns.answers.type | DNS レスポンスの answer セクションのレコード タイプ ID。符号なし整数に変換されます。 |
answer.ttl | network.dns.answers.ttl | DNS レスポンスの answer セクションの有効期間(TTL)値を符号なし整数に変換したもの。 |
customerId | target.user.userid | DNS リクエストを開始したユーザーを表すログの顧客 ID。 |
domain.domainName | network.dns.authority.data | DNS レスポンスの authority セクションまたは additional セクションのドメイン名。末尾の . が削除されます。 |
hostname | principal.hostname | ログが JSON 形式でない場合に、未加工ログの Host ヘッダーから抽出されたホスト名。 |
method | network.http.method | ログが JSON 形式でない場合に、未加工ログから抽出された HTTP メソッド。 |
parentDomain | principal.administrative_domain | クエリされた DNS 名の親ドメイン。末尾の . が削除されます。 |
ポート | principal.port | ログが JSON 形式でない場合にのみ、未加工ログの Host ヘッダーから抽出されたポート番号。整数に変換されます。 |
question.domainName | network.dns.questions.name | DNS リクエストの question セクションのドメイン名。末尾の . が削除されます。 |
question.questionTypeId | network.dns.questions.type | DNS リクエストの question セクションの質問タイプ ID。符号なし整数に変換されます。 |
responseData.header.aa | network.dns.authoritative | DNS レスポンスが権威的かどうか。responseData セクションから抽出されます。 |
responseData.header.id | network.dns.id | responseData セクションから抽出された DNS メッセージ ID。符号なし整数に変換されます。 |
responseData.header.opcode | network.dns.opcode | DNS メッセージ オペコード。responseData セクションから抽出され、符号なし整数に変換されます。 |
responseData.header.ra | network.dns.recursion_available | 再帰が利用可能かどうか。responseData セクションから抽出されます。 |
responseData.header.rcode | network.dns.response_code | responseData セクションから抽出され、符号なし整数に変換された DNS レスポンス コード。 |
responseData.header.rd | network.dns.recursion_desired | 再帰が選択されているかどうか。responseData セクションから抽出されます。 |
responseData.header.tc | network.dns.truncated | DNS メッセージが切り捨てられているかどうか。responseData セクションから抽出されます。 |
servicePointId | additional.fields.value.string_value | ログのサービス ポイント ID。 |
siteId | additional.fields.value.string_value | ログのサイト ID。 |
socketProtocol | network.ip_protocol | DNS リクエストに使用されるネットワーク プロトコル(TCP または UDP)。 |
sourceAddress | principal.ip | DNS クライアントの IP アドレス。 |
sourcePort | principal.port | DNS クライアントのポート番号を整数に変換したもの。 |
threat.indicators | security_result.category_details | 検出された脅威に関連付けられているインジケーター。 |
threat.type | security_result.threat_name | 検出された脅威の種類。 |
時間 | metadata.event_timestamp.seconds | DNS イベントのタイムスタンプ。time フィールドから抽出され、ミリ秒から秒に変換されます。 |
ユーザー エージェント | network.http.user_agent | ログが JSON 形式でない場合に、未加工ログから抽出されたユーザー エージェント文字列。 |
additional.fields.key | servicePointId 、siteId 、Content-Type 、Content-Length (未加工ログの内容によって異なります)。 |
|
metadata.event_type | イベントタイプ。DNS クエリが存在する場合は NETWORK_DNS に設定し、それ以外の場合は GENERIC_EVENT に設定します。 |
|
metadata.log_type | ログタイプ。常に BLUECAT_EDGE に設定されます。 |
|
network.application_protocol | アプリケーション プロトコル。DNS クエリが存在する場合は DNS に設定されます。それ以外の場合は、HTTP メソッドが抽出された場合は HTTP に設定され、それ以外の場合は空白のままになります。 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。