收集 Twingate VPN 記錄

支援的服務:

這個 Twingate 剖析器會從 Twingate VPN JSON 記錄擷取欄位、進行正規化,並對應至 Unified Data Model (UDM)。這項功能可處理各種事件類型,包括連線詳細資料、使用者資訊、資源存取權和中介轉送,並以供應商和產品資訊等中繼資料充實資料。

事前準備

請確認您符合下列必要條件:

  • Google SecOps 執行個體。
  • AWS IAM 和 S3 的特殊存取權。

設定 Amazon S3 儲存貯體

  1. 按照這份使用手冊建立 Amazon S3 bucket:建立 bucket
  2. 儲存 bucket 的「名稱」和「區域」,供日後參考。
  3. 按照這份使用手冊建立使用者:建立 IAM 使用者。

  4. 選取建立的使用者。

  5. 選取「安全憑證」分頁標籤。

  6. 在「Access Keys」部分,按一下「Create Access Key」。

  7. 在「用途」部分選取「第三方服務」。

  8. 點選「下一步」。

  9. 選用:新增說明標記。

  10. 按一下「Create access key」。

  11. 按一下「Download .csv file」,儲存「Access Key」和「Secret Access Key」,以供日後參考。

  12. 按一下「完成」。

  13. 選取「權限」分頁標籤。

  14. 在「權限政策」部分,按一下「新增權限」。

  15. 選取「新增權限」。

  16. 選取「直接附加政策」。

  17. 搜尋 AmazonS3FullAccess 政策。

  18. 選取政策。

  19. 點選「下一步」。

  20. 按一下「Add permissions」。

設定 Twingate 與 Amazon S3 同步

  1. 前往 Twingate 管理控制台。
  2. 依序前往「設定」>「報表」。
  3. 按一下「Sync to S3 Bucket」(同步至 S3 值區)。
  4. 設定 S3 同步:

    • Bucket Name:提供 S3 bucket 的名稱。

    • Access Key ID:輸入存取金鑰。

    • Secret Access Key:輸入 Secret Key。

  5. 按一下「Start Syncing」。

設定動態饋給

如要設定動態饋給,請按照下列步驟操作:

  1. 依序前往「設定」>「資料管理」>「動態饋給」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「動態饋給」。
  2. 按一下「新增動態饋給」。
  3. 在下一頁,點按「設定單一動態饋給」。
  4. 在「Feed name」(動態饋給名稱) 欄位中,輸入動態饋給名稱,例如 Twingate Logs。
  5. 在「來源類型」部分,選取「Amazon S3 V2」。
  6. 在「Log type」部分選取「Twingate」。
  7. 點選「下一步」。
  8. 指定下列輸入參數的值:

    • S3 URI:bucket URI。s3:/BUCKET_NAME 更改下列內容:
      • BUCKET_NAME:bucket 的名稱。
    • 來源刪除選項:根據偏好選取刪除選項。
  9. 點選「下一步」。

  10. 在「完成」畫面中檢查新的新聞動態消息設定,然後按一下「提交」。

欄位對應參考資料

這個剖析器會將 JSON 格式的原始 Twingate 記錄轉換為 UDM。系統會將資料正規化並擷取相關資訊,然後對應至相應的 UDM 欄位。

UDM 對應表

記錄欄位 UDM 對應 邏輯
connector.id read_only_udm.additional.fields[].key 設為「connector_id」。
connector.id read_only_udm.additional.fields[].value.string_value connector.id 的值。
connector.name read_only_udm.additional.fields[].key 設為「connector_name」。
connector.name read_only_udm.additional.fields[].value.string_value connector.name 的值。
connection.bytes_received read_only_udm.network.received_bytes connection.bytes_received 的值 (轉換為不帶正負號的整數)。
connection.bytes_transferred read_only_udm.network.sent_bytes connection.bytes_transferred 的值 (轉換為不帶正負號的整數)。
connection.client_ip read_only_udm.principal.asset.ip connection.client_ip 的值。
connection.client_ip read_only_udm.principal.ip connection.client_ip 的值。
connection.protocol read_only_udm.network.ip_protocol connection.protocol 的值 (轉換為大寫)。
device.id read_only_udm.principal.user.product_object_id device.id 的值。
event.id read_only_udm.metadata.event_id event.id 的值
event.time read_only_udm.metadata.event_timestamp.seconds 時間戳記的秒數部分,從 event.time 開始。
event.type read_only_udm.event.type event.type 的值。
event.version read_only_udm.metadata.product_version event.version 的值。
relays[].ip read_only_udm.intermediary.ip relays[].ip 的值。
relays[].name read_only_udm.intermediary.hostname relays[].name 的值。
relays[].port read_only_udm.intermediary.port relays[].port 的值 (轉換為整數)。
remote_network.id read_only_udm.network.session_id remote_network.id 的值。
remote_network.name read_only_udm.network.dhcp.sname remote_network.name 的值。
resource.address read_only_udm.principal.asset.hostname resource.address 的值。
resource.address read_only_udm.principal.hostname resource.address 的值。
resource.id read_only_udm.resource.product_object_id resource.id 的值。
resource.port read_only_udm.principal.port resource.port 的值 (轉換為整數)。
status read_only_udm.security_result.summary status 的值。
time read_only_udm.event.timestamp.seconds 時間戳記的秒數部分,從 time 開始。
user.email read_only_udm.principal.user.email_addresses user.email 的值。
user.id read_only_udm.principal.user.userid user.id 的值。

變更記錄

查看這個剖析器的變更記錄

還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。