VMware Tanzu のログを収集する
このドキュメントでは、Bindplane を使用して VMware Tanzu ログを Google Security Operations に取り込む方法について説明します。パーサーは、JSON または SYSLOG+JSON 形式のメッセージから監査ログを抽出します。ログデータを解析し、フィールドを UDM 形式に正規化して、ユーザーの詳細、リソース情報、ネットワーク アクティビティ、セキュリティ結果などのメタデータでイベントを拡充します。単一の JSON オブジェクトと syslog メッセージ内に埋め込まれた JSON の両方を処理します。
始める前に
次の前提条件を満たしていることを確認してください。
- Google SecOps インスタンス
- Windows 2016 以降、または
systemd
を使用する Linux ホスト - プロキシの背後で実行している場合は、ファイアウォール ポートが開いていることを確認する
- VMware Tanzu への特権アクセス
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 log_type: 'VMWARE_TANZU' raw_log_field: body ingestion_labels: 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 エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。
net stop BindPlaneAgent && net start BindPlaneAgent
VMware Tanzu の Syslog を構成する
- Tanzu Operations Manager ウェブ UI にログインします。
- [ユーザー名] を選択し、[設定] をクリックします。
- [Syslog] を選択します。
- [はい] をクリックして、システムログをリモート サーバーに送信します。
- 次の構成の詳細を入力します。
- アドレス: Bindplane エージェントの IP アドレスを入力します。
- ポート: Bindplane エージェントのポート番号を入力します。
- トランスポート プロトコル: 実際の Bindplane エージェントの構成に応じて、[UDP] または [TCP] を選択します。
- [保存] をクリックします。
UDM マッピング テーブル
ログフィールド | UDM マッピング | ロジック |
---|---|---|
annotations.authorization.k8s.io/decision |
security_result.action |
アノテーション authorization.k8s.io/decision が存在する場合、その値は大文字に変換されます。大文字の値が「ALLOW」の場合、UDM フィールドは ALLOW に設定されます。それ以外の場合は BLOCK に設定されます。 |
annotations.authorization.k8s.io/reason |
security_result.description |
アノテーション authorization.k8s.io/reason が存在する場合、その値(二重引用符を削除したもの)が使用されます。 |
apiVersion |
metadata.product_version |
直接マッピングされます。 |
auditID |
metadata.product_log_id |
直接マッピングされます。 |
kind |
metadata.product_event_type |
直接マッピングされます。 |
objectRef.name |
target.resource.name |
直接マッピングされます。 |
objectRef.namespace |
target.resource.attribute.labels.key 、target.resource.attribute.labels.value |
key は「namespace」に設定され、value は objectRef.namespace から取得されます。 |
objectRef.resource |
target.resource.resource_subtype |
直接マッピングされます。 |
objectRef.resourceVersion |
target.resource.attribute.labels.key 、target.resource.attribute.labels.value |
key は「resourceVersion」に設定され、value は objectRef.resourceVersion から取得されます。 |
objectRef.uid |
target.resource.product_object_id |
直接マッピングされます。 |
requestReceivedTimestamp / timestamp |
metadata.event_timestamp |
パーサーは、まず requestReceivedTimestamp の解析を試みます。存在しない場合は、syslog 接頭辞から抽出された timestamp フィールドを使用します。 |
requestURI |
target.url |
直接マッピングされます。 |
responseStatus.code |
network.http.response_code |
整数に変換された後、直接マッピングされます。 |
sourceIPs |
principal.ip |
sourceIPs 配列内のすべての IP アドレスが principal.ip 配列に追加されます。 |
stage |
metadata.description |
直接マッピングされます。 |
stageTimestamp |
metadata.collected_timestamp |
直接マッピングされます。 |
user.groups |
principal.user.group_identifiers |
user.groups 配列内のすべてのグループが principal.user.group_identifiers 配列に追加されます。 |
user.uid |
principal.user.userid |
直接マッピングされます。 |
user.username |
principal.user.user_display_name |
直接マッピングされます。 |
verb |
network.http.method |
大文字に変換された後、直接マッピングされます。verb フィールドによって決定されます。verb が「CREATE」の場合、イベントタイプは USER_RESOURCE_CREATION です。verb が「PATCH」または「UPDATE」の場合、イベントタイプは USER_RESOURCE_UPDATE_CONTENT です。verb が「DELETE」の場合、イベントタイプは USER_RESOURCE_DELETION です。それ以外の場合、verb が空でなければ、イベントタイプは USER_RESOURCE_ACCESS です。上記の条件のいずれも満たされない場合、イベントタイプは GENERIC_EVENT に設定されます。「VMWARE_TANZU」にハードコードされています。「VMWARE」にハードコードされます。「VMWARE_TANZU」にハードコードされています。「CLUSTER」にハードコードされています。 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。