收集 Amazon CloudFront 記錄
剖析器版本:10.0
本文說明如何設定 Google Security Operations 動態饋給,收集 Amazon CloudFront 記錄。
詳情請參閱「將資料擷取至 Google Security Operations 總覽」。
擷取標籤會識別剖析器,將原始記錄資料正規化為結構化 UDM 格式。本文資訊適用於具有 AWS_CLOUDFRONT 擷取標籤的剖析器。
事前準備
確認已建立 Amazon S3 bucket。詳情請參閱「建立第一個 S3 bucket」。
設定 Amazon CloudFront
- 登入 AWS 管理主控台。
- 存取 Amazon S3 控制台,並建立 Amazon S3 bucket。
- 按一下「開啟」,啟用記錄功能。
- 在「Bucket for logs」(記錄檔儲存貯體) 欄位中,指定 Amazon S3 儲存貯體名稱。
- 在「Log prefix」(記錄前置字串) 欄位中,指定選用的前置字串。
- 將記錄檔儲存在 Amazon S3 bucket 後,請建立 SQS 佇列,並附加至 Amazon S3 bucket。
找出連線端點
檢查 S3、SQS 和 KMS 的必要 Identity and Access Management 使用者和 KMS 金鑰政策。
請根據服務和區域,參閱下列 AWS 說明文件,找出連線端點:
- 如要瞭解任何記錄來源,請參閱「AWS Identity and Access Management 端點和配額」。
- 如要瞭解 S3 記錄來源,請參閱「Amazon Simple Storage Service 端點和配額」。
- 如要瞭解 SQS 記錄來源,請參閱「Amazon Simple Queue Service 端點和配額」。
設定動態饋給
在 Google SecOps 平台中,有兩個不同的進入點可以設定動態饋給:
- 「設定」>「資料管理」>「動態饋給」>「新增動態饋給」 (在僅限 SIEM 的平台上,依序點選「設定」>「動態饋給」>「新增動態饋給」)
- Content Hub > Content Packs > Get Started
如何設定 AWS CloudFront 動態饋給
- 按一下「Amazon Cloud Platform」套件。
- 找出 AWS CloudFront 記錄類型。
在下列欄位中指定值。
- 來源類型:Amazon SQS V2
- Queue Name:要讀取的 SQS 佇列名稱
- S3 URI:值區 URI。
s3://your-log-bucket-name/- 將
your-log-bucket-name替換為 S3 bucket 的實際名稱。
- 將
來源刪除選項:根據攝入偏好設定選取刪除選項。
檔案存在時間上限:包含過去幾天內修改過的檔案。預設值為 180 天。
SQS 佇列存取金鑰 ID:帳戶存取金鑰,由 20 個英數字元組成。
SQS 佇列私密存取金鑰:帳戶存取金鑰,由 40 個英數字元組成。
進階選項
- 動態饋給名稱:系統預先填入的值,用於識別動態饋給。
- 資產命名空間:與動態饋給相關聯的命名空間。
- 擷取標籤:套用至這個動態饋給所有事件的標籤。
點選「建立動態饋給」。
如要進一步瞭解如何為這個產品系列中的不同記錄類型設定多個動態饋給,請參閱「依產品設定動態饋給」。
欄位對應參考資料
這個剖析器會從 AWS CloudFront 記錄中擷取 SYSLOG 或 JSON 格式的欄位,並正規化為 UDM。這個剖析器會使用 grok 模式剖析訊息字串、處理各種資料轉換 (例如類型轉換、重新命名),並透過使用者代理程式剖析和應用程式通訊協定識別等額外背景資訊,豐富資料內容。
UDM 對應表
| 記錄欄位 | UDM 對應 | 邏輯 |
|---|---|---|
c-ip |
principal.ip |
直接對應。也對應到 principal.asset.ip。 |
c-port |
principal.port |
直接對應。 |
cs(Cookie) |
additional.fields[].key:「cookie」additional.fields[].value.string_value:直接對應。 |
如果 cs(Cookie) 存在,且 agent 不含「://」,則會依條件對應。 |
cs(Host) |
principal.hostname |
直接對應。也對應到 principal.asset.hostname。如果其他網址欄位無法使用,則用於建構 target.url。 |
cs(Referer) |
network.http.referral_url |
直接對應。 |
cs(User-Agent) |
network.http.user_agent |
直接對應。如果未包含「://」,也會對應至 network.http.parsed_user_agent 並剖析為其元件。 |
cs-bytes |
network.sent_bytes |
直接對應。已轉換為無正負號整數。 |
cs-method |
network.http.method |
直接對應。 |
cs-protocol |
network.application_protocol |
轉換為大寫後對應。如果值未辨識為標準應用程式通訊協定,且 cs-protocol-version 包含「HTTP」,則 network.application_protocol 會設為「HTTP」。 |
dport |
target.port |
直接對應。已轉換為整數。 |
edge_location |
principal.location.name |
直接對應。 |
fle-encrypted-fields |
additional.fields[].key:「fle-encrypted-fields」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
fle-status |
additional.fields[].key:「fle-status」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
host |
principal.hostname、principal.asset.hostname |
直接對應。 |
id |
principal.asset_id |
直接對應,前置字串為「id: 」。 |
ip |
target.ip、target.asset.ip |
直接對應。 |
log_id |
metadata.product_log_id |
直接對應。 |
resource |
additional.fields[].key:「resource」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
result_type |
additional.fields[].key:「result_type」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
sc-bytes |
network.received_bytes |
直接對應。已轉換為無正負號整數。 |
sc-content-len |
additional.fields[].key:「sc-content-len」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
sc-content-type |
additional.fields[].key:「sc-content-type」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
sc-status |
network.http.response_code |
直接對應。已轉換為整數。 |
ssl-cipher |
network.tls.cipher |
直接對應。 |
ssl-protocol |
network.tls.version |
直接對應。 |
timestamp |
metadata.event_timestamp |
剖析並對應 (如有)。支援多種格式。 |
ts |
metadata.event_timestamp |
剖析並對應 (如有)。必須採用 ISO8601 格式。 |
url |
target.url |
直接對應。 |
url_back_to_product |
metadata.url_back_to_product |
直接對應。 |
x-edge-detailed-result-type |
additional.fields[].key:「x-edge-detailed-result-type」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
x-edge-location |
additional.fields[].key:「x-edge-location」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
x-edge-request-id |
additional.fields[].key:「x-edge-request-id」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
x-edge-response-result-type |
additional.fields[].key:「x-edge-response-result-type」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
x-edge-result-type |
additional.fields[].key:「x-edge-result-type」additional.fields[].value.string_value:直接對應。 |
如有,則依條件對應。 |
x-forwarded-for |
target.ip、target.asset.ip |
直接對應。如果有多個 IP (以半形逗號分隔),則會分割並合併至各自的 UDM 欄位。 |
x-host-header |
target.hostname、target.asset.hostname |
直接對應。如果 ip 或 x-forwarded-for 和 http_verb 存在,請設為「NETWORK_HTTP」。否則請設為「GENERIC_EVENT」。硬式編碼為「AWS_CLOUDFRONT」。硬式編碼為「AWS CloudFront」。硬式編碼為「AMAZON」。記錄項目擷取至 Google Security Operations 的時間。 |
cs_cookie |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
time-taken |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
time-to-first-byte |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
cribl_pipe |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
cs-referer |
event.idm.read_only_udm.network.http.referer |
從變更記錄對應 |
cs-uri-query |
event.idm.read_only_udm.network.http.url_details.query |
從變更記錄對應 |
cs-user-agent |
event.idm.read_only_udm.network.http.user_agent |
從變更記錄對應 |
cs-uri-stem |
event.idm.read_only_udm.target.url |
從變更記錄對應 |
x-forwarded-for |
security_result.detection_fields |
從變更記錄對應 |
avgrequestTime |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
htmlType |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
responseTime |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
securityKey |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
bytes |
event.idm.read_only_udm.network.sent_bytes |
從變更記錄對應 |
srcport |
event.idm.read_only_udm.src.port |
從變更記錄對應 |
encryptionType |
event.idm.read_only_udm.security_result.about.resource.name |
從變更記錄對應 |
hostname |
event.idm.read_only_udm.principal.hostname |
從變更記錄對應 |
scrip |
event.idm.read_only_udm.src.ip |
從變更記錄對應 |
targetip |
event.idm.read_only_udm.target.ip |
從變更記錄對應 |
targetip |
event.idm.read_only_udm.target.asset.ip |
從變更記錄對應 |
tlsvVersion |
event.idm.read_only_udm.network.tls.version |
從變更記錄對應 |
CloudFront-Is-Desktop-Viewer |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
CloudFront-Is-Mobile-Viewer |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
CloudFront-Is-SmartTV-Viewer |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
CloudFront-Is-Tablet-Viewer |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
vDetails |
event.idm.read_only_udm.network.http.user_agent |
從變更記錄對應 |
x-envoy-expected-rq-timeout-ms |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
x-envoy-external-address |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
x-envoy-original-authority |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
x-f5-cdn-tls-ja3 |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
x-f5-cdn-tls-ja4 |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
x-forwarded-proto |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
xc-trusted-source |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
ipType |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
method |
event.idm.read_only_udm.network.http.method |
從變更記錄對應 |
x-request-id |
event.idm.read_only_udm.metadata.product_log_id |
從變更記錄對應 |
version |
event.idm.read_only_udm.metadata.product_log_id |
從變更記錄對應 |
requestCode |
event.idm.read_only_udm.network.http.response_code |
從變更記錄對應 |
ipAddress |
event.idm.read_only_udm.principal.ip |
從變更記錄對應 |
uri_query |
event.idm.read_only_udm.additional.fields |
從變更記錄對應 |
Bucket |
target.resource.name |
從變更記錄對應 |
accountID |
principal.user.userid |
從變更記錄對應 |
file |
target.file.full_path |
從變更記錄對應 |
region |
principal.location.country_or_region |
從變更記錄對應 |
msg |
metadata.description |
從變更記錄對應 |
service", "aggregation", "func", "requestID", "lpcltype", "lpclagg", "level" and "LoggingEnabled |
additional.fields |
從變更記錄對應 |
變更記錄
還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。