F5 BIG-IP ASM のログを収集する
このドキュメントでは、Bindplane を使用して F5 BIG-IP Application Security Manager(ASM)ログを Google Security Operations に取り込む方法について説明します。パーサーは、さまざまなログ形式(syslog、CSV、CEF など)を処理し、UDM に正規化します。Grok パターンと Key-Value 抽出を使用してフィールドを解析し、XML フィルタリングを使用して違反の詳細を解析し、条件付きロジックを使用してイベントの分類と重大度のマッピングを行い、抽出されたフィールドを UDM スキーマにマージします。
始める前に
- Google Security Operations インスタンスがあることを確認します。
- Windows 2016 以降、または
systemdを使用する Linux ホストを使用していることを確認します。 - プロキシの背後で実行している場合は、ファイアウォール ポートが開いていることを確認します。
- F5 BIG-IP ASM への特権アクセス権があることを確認します。
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 へのインストール
- 管理者として コマンド プロンプトまたは 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 の場合は/opt/observiq-otel-collector/ディレクトリ、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: 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 # Adjust the path to the credentials file you downloaded in Step 1 creds: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: chronicle.googleapis.com # Add optional ingestion labels for better organization ingestion_labels: log_type: F5_ASM raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels自社のインフラストラクチャでの必要性に応じて、ポートと 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を取り込み認証ファイルのパスに設定します。インスタンスが米国以外にある場合は、malachiteingestion-pa.googleapis.comをリージョン エンドポイント(例:europe-malachiteingestion-pa.googleapis.com)に置き換えます。exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds: '/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: F5_ASM raw_log_field: body
Bindplane エージェントを再起動して変更を適用する
Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。
sudo systemctl restart bindplane-agentWindows で Bindplane エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。
net stop BindPlaneAgent && net start BindPlaneAgent
F5 BIG-IP ASM でリモート ロギングを構成する
- ASM コンソールのウェブ UI にログインします。
- [Security] > [Event Logs] > [Logging Profiles] に移動します。
- [作成] をクリックします。
次の構成情報を提供してください。
- プロファイル名: プロファイルの一意の名前を入力します。
- [アプリケーション セキュリティ] を選択します。
- [アプリケーション セキュリティ] タブで、[Advanced] を選択します(追加の構成が必要な場合)。
- Storage Destination: [Remote Storage] を選択します。
- Logging Format: Common Event Format(CEF)を選択します。
- [ローカル ストレージ] を消去します。
- プロトコル: [UDP] または [TCP] を選択します(Bindplane エージェントの構成に応じて)。
- サーバー アドレス: Bindplane エージェントの IP アドレスを入力します。
- ポート: デフォルトで
514が選択されています。Bindplane エージェントの構成に応じてポート設定を更新します。 - [追加] をクリックします。
- [ロギングを保証する] を選択します。
- [検出された異常を報告する] を選択します。
- ファシリティ:
LOG_LOCAL6を選択します(必要に応じて、ログに記録されたトラフィックのファシリティ カテゴリを選択できます。有効な値はLOG_LOCAL0~LOG_LOCAL7です)。
[Finished] をクリックします。
ロギング プロファイルをセキュリティ ポリシーに関連付ける
- [Local Traffic] > [Virtual Servers] をクリックします。
- セキュリティ ポリシーで使用されている仮想サーバーの名前をクリックします。
- [セキュリティ] メニューから [ポリシー] を選択します。
- [アプリケーション セキュリティ ポリシー] の設定が [有効] になっており、[ポリシー] が目的のセキュリティ ポリシーに設定されていることを確認します。
- [ログプロファイル] の設定が [有効] に設定されていることを確認します。
- [Available] リストから、セキュリティ ポリシーに使用するプロファイルを選択し、[Selected] リストに移動します。
- [更新] をクリックします。
UDM マッピング テーブル
| ログフィールド | UDM マッピング | ロジック |
|---|---|---|
act |
security_result.action |
act が blocked の場合は、BLOCK にマッピングされます。act が passed または legal の場合は、ALLOW にマッピングされます。act に alerted が含まれている場合は、QUARANTINE にマッピングされます。それ以外の場合、Splunk 形式のデフォルトは ALLOW です。 |
app |
network.application_protocol |
未加工ログに存在する場合は、HTTPS に直接マッピングされます。 |
attack_type |
security_result.category_details、metadata.description |
他のフィールドと組み合わせて使用して、security_result.category を決定します。他に説明がない場合は、これがイベントの説明になります。Splunk 形式のログの場合、violations が空の場合にカテゴリと概要を決定するために使用されます。 |
client_ip |
principal.ip、principal.asset.ip |
プリンシパル IP に直接マッピングされます。 |
cn1 |
network.http.response_code |
HTTP レスポンス コードに直接マッピングされます。 |
cn2 |
security_result.severity_details |
セキュリティ結果の重大度の詳細に直接マッピングされます。response_code と組み合わせて、イベントがアラートかどうかを判断するために使用されます。 |
column1 |
principal.ip、principal.asset.ip |
特定の CSV 形式のログのプリンシパル IP にマッピングされます。 |
column2 |
target.port |
特定の CSV 形式のログのターゲット ポートにマッピングされます。 |
column3 |
target.ip、target.asset.ip |
特定の CSV 形式のログのターゲット IP にマッピングされます。 |
column4 |
security_result.severity |
特定の CSV 形式のログのセキュリティ結果の重大度にマッピングされます。値 Information、Informational、0、4 は INFORMATIONAL にマッピングされます。Warning、1、3 は MEDIUM にマッピングされます。Error、2 は ERROR にマッピングされます。Critical、CRITICAL、critical は CRITICAL にマッピングされます。 |
column7 |
security_result.detection_fields、network.http.response_code |
XML データが含まれます。request-violations 内の viol_name が抽出され、キー Request Violation Name_index を持つ検出フィールドとして追加されます。response_violations 内の viol_name が抽出され、キー Response Violation Name_index を持つ検出フィールドとして追加されます。response_violations 内の response_code は network.http.response_code にマッピングされます。 |
column8 |
security_result.rule_name |
特定の CSV 形式のログのセキュリティ結果ルール名にマッピングされます。 |
cs1 |
security_result.rule_name |
セキュリティ結果のルール名に直接マッピングされます。 |
cs2 |
security_result.summary |
セキュリティ結果の概要に直接マッピングされます。 |
cs5 |
principal.ip、principal.asset.ip、additional.fields |
cs5 に JNDI LDAP URL が含まれている場合、キー JNDI_LDAP_URL を持つ追加フィールドとして追加されます。それ以外の場合、カンマ区切りの IP が含まれていると、principal_ip と異なる IP が追加のプリンシパル IP として追加されます。 |
cs6 |
principal.location.country_or_region |
プリンシパルの場所の国または地域に直接マッピングされます。 |
data |
network.session_id、network.sent_bytes、network.tls.version |
存在する場合は、JSON として解析され、sessionid、bits(sent_bytes にマッピング)、version が抽出されます。 |
date_time |
metadata.event_timestamp |
解析して正しい形式に変換した後、イベント タイムスタンプに直接マッピングされます。 |
dest_ip |
target.ip、target.asset.ip |
ターゲット IP に直接マッピングされます。 |
dest_port |
target.port |
ターゲット ポートに直接マッピングされます。 |
dhost |
target.hostname |
ターゲット ホスト名に直接マッピングされます。 |
dpt |
target.port |
ターゲット ポートに直接マッピングされます。 |
dst |
target.ip |
ターゲット IP に直接マッピングされます。 |
dvc |
intermediary.ip |
intermediary IP に直接マッピングされます。 |
dvchost |
target.hostname、intermediary.hostname |
ターゲット ホスト名と中間ホスト名に直接マッピングされます。 |
errdefs_msgno |
additional.fields |
キー errdefs_msgno の追加フィールドとして追加されます。 |
externalId |
additional.fields |
キー Support_Id の追加フィールドとして追加されます。 |
f5_host |
target.hostname、intermediary.hostname |
ターゲット ホスト名と中間ホスト名に直接マッピングされます。 |
geo_info |
principal.location.country_or_region、security_result.detection_fields |
主なロケーションの国または地域にマッピングされます。キー geo_info を持つ検出フィールドとしても追加されます。 |
host |
target.hostname |
ターゲット ホスト名に直接マッピングされます。 |
ids |
additional.fields |
サポート ID のカンマ区切りのリストとして解析されます。各 ID は、キー supportid を持つリスト値の追加フィールドに追加されます。 |
ip_addr_intelli |
security_result.detection_fields |
キー ip_addr_intelli を持つ検出フィールドとして追加されます。 |
ip_client |
principal.ip |
プリンシパル IP に直接マッピングされます。 |
ip_route_domain |
principal.ip、principal.asset.ip |
IP 部分が抽出され、プリンシパル IP にマッピングされます。 |
irule |
security_result.rule_name |
セキュリティ結果のルール名に直接マッピングされます。 |
irule-version |
security_result.rule_version |
セキュリティ結果のルール バージョンに直接マッピングされます。 |
level |
security_result.severity、security_result.severity_details |
セキュリティ結果の重大度を判断するために使用されます。error または warning は HIGH にマッピングされます。notice は MEDIUM にマッピングされます。information または info は LOW にマッピングされます。未加工の値は severity_details にもマッピングされます。 |
logtime |
metadata.event_timestamp |
解析後にイベント タイムスタンプに直接マッピングされます。 |
management_ip_address、management_ip_address_2 |
intermediary.ip |
intermediary IP に直接マッピングされます。 |
method |
network.http.method |
HTTP メソッドに直接マッピングされます。 |
msg |
security_result.summary、metadata.description |
一部のログ形式のセキュリティ結果の概要に直接マッピングされます。他に説明がない場合は、これがイベントの説明になります。 |
policy_name |
security_result.about.resource.name、security_result.rule_name |
セキュリティ結果のリソース名またはルール名に直接マッピングされます。 |
process |
target.application |
ターゲット アプリケーションに直接マッピングされます。 |
process_id |
principal.process.pid |
プリンシパル プロセス ID に直接マッピングされます。 |
protocol |
network.application_protocol、network.ip_protocol、app_protocol |
ログ形式に応じて、アプリケーション プロトコルまたは IP プロトコルに直接マッピングされます。 |
proxy_id |
security_result.rule_id |
セキュリティ結果のルール ID に直接マッピングされます。 |
query_string |
additional.fields |
キー query_string の追加フィールドとして追加されます。 |
referrer |
network.http.referral_url |
HTTP 参照 URL に直接マッピングされます。 |
req_method |
network.http.method |
HTTP メソッドに直接マッピングされます。 |
req_status |
security_result.action、security_result.action_details、security_result.detection_fields |
blocked の場合は、security_result.action を BLOCK にマッピングします。passed または legal の場合は、ALLOW にマッピングされます。alerted が含まれている場合は、QUARANTINE にマッピングされます。未加工の値は action_details にもマッピングされ、キー req_status を持つ検出フィールドとして追加されます。 |
request |
target.url |
ターゲット URL に直接マッピングされます。 |
requestMethod |
network.http.method |
HTTP メソッドに直接マッピングされます。 |
resp |
security_result.detection_fields |
キー resp を持つ検出フィールドとして追加されます。 |
resp_code |
network.http.response_code |
HTTP レスポンス コードに直接マッピングされます。 |
response |
security_result.summary |
セキュリティ結果の概要に直接マッピングされます。 |
response_code |
network.http.response_code |
HTTP レスポンス コードに直接マッピングされます。 |
route_domain |
additional.fields |
キー route_domain の追加フィールドとして追加されます。 |
rt |
metadata.event_timestamp |
解析後にイベント タイムスタンプに直接マッピングされます。 |
sev |
security_result.severity、security_result.severity_details |
セキュリティ結果の重大度を判断するために使用されます。ERROR は ERROR にマッピングされます。未加工の値は severity_details にもマッピングされます。 |
severity |
security_result.severity、security_result.severity_details |
セキュリティ結果の重大度を判断するために使用されます。Informational は LOW に、Error または warning は HIGH に、critical は CRITICAL に、notice は MEDIUM に、information または info は LOW にマッピングされます。未加工の値は severity_details にもマッピングされます。 |
sig_ids |
security_result.rule_id |
セキュリティ結果のルール ID に直接マッピングされます。 |
sig_names |
security_result.rule_name |
セキュリティ結果のルール名に直接マッピングされます。 |
snat_ip |
principal.nat_ip |
プリンシパル NAT IP に直接マッピングされます。 |
snat_port |
principal.nat_port |
プリンシパル NAT ポートに直接マッピングされます。 |
src |
principal.ip、principal.asset.ip |
プリンシパル IP に直接マッピングされます。 |
spt |
principal.port |
principal port に直接マッピングされます。 |
sub_violates |
security_result.about.resource.attribute.labels |
キー Sub Violations のラベルとして、セキュリティ結果リソース属性に追加されます。 |
sub_violations |
security_result.about.resource.attribute.labels |
キー Sub Violations のラベルとして、セキュリティ結果リソース属性に追加されます。 |
summary |
security_result.summary |
セキュリティ結果の概要に直接マッピングされます。 |
support_id |
metadata.product_log_id |
support_id - という接頭辞が付き、プロダクトログ ID にマッピングされます。 |
suid |
network.session_id |
ネットワーク セッション ID に直接マッピングされます。 |
suser |
principal.user.userid |
プリンシパル ユーザー ID に直接マッピングされます。 |
timestamp |
metadata.event_timestamp |
解析して正しい形式に変換した後、イベント タイムスタンプに直接マッピングされます。 |
unit_host |
principal.hostname、principal.asset.hostname |
プリンシパル ホスト名に直接マッピングされます。 |
uri |
principal.url |
プリンシパル URL に直接マッピングされます。 |
user_id |
principal.user.userid |
プリンシパル ユーザー ID に直接マッピングされます。 |
user_name |
principal.user.user_display_name |
プリンシパル ユーザーの表示名に直接マッピングされます。 |
username |
principal.user.userid |
プリンシパル ユーザー ID に直接マッピングされます。 |
useragent |
network.http.user_agent、network.http.parsed_user_agent |
HTTP ユーザー エージェントに直接マッピングされます。解析され、解析されたユーザー エージェントにマッピングされます。 |
virtualserver |
network.tls.client.server_name |
TLS クライアント サーバー名に直接マッピングされます。 |
violate_details |
security_result.detection_fields、network.http.response_code |
XML データが含まれます。request-violations 内の viol_name が抽出され、キー Request Violation Name_index を持つ検出フィールドとして追加されます。response_violations 内の viol_name が抽出され、キー Response Violation Name_index を持つ検出フィールドとして追加されます。response_violations 内の response_code は network.http.response_code にマッピングされます。 |
violate_rate |
security_result.detection_fields |
キー violate_rate を持つ検出フィールドとして追加されます。 |
violation_rating |
security_result.about.resource.attribute.labels |
キー Violations Rating のラベルとして、セキュリティ結果リソース属性に追加されます。 |
violations |
security_result.description |
セキュリティ結果の説明に直接マッピングされます。Splunk 形式のログの場合、サマリーが存在するかどうかを判断するために使用されます。 |
virus_name |
security_result.threat_name |
セキュリティ結果の脅威名に直接マッピングされます。 |
vs_name |
network.tls.client.server_name |
TLS クライアント サーバー名に直接マッピングされます。 |
websocket_direction |
network.direction |
clientToServer の場合は、INBOUND にマッピングされます。ServerToclient の場合は、OUTBOUND にマッピングされます。 |
websocket_message_type |
security_result.detection_fields |
キー WebsocketMessageType を持つ検出フィールドとして追加されます。 |
x_fwd_hdr_val |
principal.ip、principal.asset.ip |
プリンシパル IP に直接マッピングされます。 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。