收集 NetApp 控制台 (原稱 BlueXP) 稽核記錄

支援的國家/地區：

本文說明如何使用 Google Cloud Storage V2，將 NetApp Console (舊稱 BlueXP) 稽核記錄擷取至 Google Security Operations。

NetApp Console 是統一的控制層，可管理內部部署和雲端環境中的混合多雲儲存空間和資料服務。稽核服務會記錄主控台服務執行的作業，包括原始 IP 位址、工作區、使用的主控台代理程式，以及其他有助於鑑識分析和符合法規要求的遙測資料。

事前準備

請確認您已完成下列事前準備事項：

  • Google SecOps 執行個體
  • 已啟用 Cloud Storage、Cloud Run、Pub/Sub 和 Cloud Scheduler API 的 GCP 專案
  • 建立及管理 GCS bucket 的權限
  • 管理 Google Cloud Storage 值區 IAM 政策的權限
  • 建立 Cloud Run 服務、Pub/Sub 主題和 Cloud Scheduler 工作的權限
  • 具備建立服務帳戶權限的 NetApp 控制台管理存取權
  • 您的 NetApp 控制台帳戶 ID

設定 NetApp 控制台 API 存取權

如要讓 Google SecOps 擷取稽核記錄，您必須建立具備適當權限的服務帳戶，並產生 API 憑證。

取得帳戶 ID

  1. 使用瀏覽器前往 NetApp 控制台。
  2. 使用 NetApp 控制台憑證或 NetApp 支援網站憑證登入。
  3. 按一下頁面頂端的「帳戶」下拉式選單。
  4. 按一下所選帳戶的「管理帳戶」。

  5. 在「總覽」部分，複製「帳戶 ID」值。

建立服務帳戶

  1. 在 NetApp 控制台中，依序前往「Administration」>「Identity and access」。
  2. 選取「成員」。
  3. 選取「新增成員」。
  4. 在「成員類型」中，選取「服務帳戶」。
  5. 輸入服務帳戶的名稱 (例如 Google SecOps Integration)。

  6. 如要使用用戶端密鑰驗證，請取消勾選「使用私密金鑰 JWT 驗證」。

  7. 在「Select an organization, folder, or project」(選取組織、資料夾或專案) 部分，選取您的組織。

  8. 在「類別」部分，選取「機構」。

  9. 在「角色」部分，選取「機構檢視者」。

  10. 按一下「新增」。

記錄 API 憑證

建立服務帳戶後，對話方塊會顯示您的憑證：

  • 用戶端 ID：您的專屬用戶端 ID (例如 TvPPs4SeM5smEElsGmdDUznljhN3YY8s)
  • 用戶端密鑰：您的 API 密鑰
  1. 下載或複製「用戶端 ID」和「用戶端密鑰」，並儲存在安全地點。
  2. 按一下 [關閉]。

驗證權限

如要確認服務帳戶是否具備必要權限，請按照下列步驟操作：

  1. 登入 NetApp Console。
  2. 前往「管理」> 身分和存取權。
  3. 選取「成員」。
  4. 找出您建立的服務帳戶，並確認該帳戶具備「機構檢視者」角色。
  5. 如果未指派角色，請按一下服務帳戶名稱，然後將角色更新為「機構檢視者」。

測試 API 存取權

  • 請先測試憑證，再繼續進行整合：

    # Replace with your actual credentials
CLIENT_ID="your-client-id"
CLIENT_SECRET="your-client-secret"
ACCOUNT_ID="your-account-id"

# Obtain access token
TOKEN=$(curl -s -X POST "https://netapp-cloud-account.auth0.com/oauth/token" \
    -H "Content-Type: application/json" \
    -d '{
        "grant_type": "client_credentials",
        "client_id": "'"${CLIENT_ID}"'",
        "client_secret": "'"${CLIENT_SECRET}"'",
        "audience": "https://api.cloud.netapp.com"
    }' | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")

# Test audit API access
curl -s -H "Authorization: Bearer ${TOKEN}" \
    "https://cloudmanager.cloud.netapp.com/audit/${ACCOUNT_ID}?offset=0" \
    | python3 -m json.tool

成功的回應會傳回 JSON 物件，其中包含指定帳戶的稽核記錄。

建立 Google Cloud Storage bucket

  1. 前往 Google Cloud 控制台。
  2. 選取專案或建立新專案。
  3. 在導覽選單中，依序前往「Cloud Storage」>「Bucket」。
  4. 按一下「建立值區」。

  5. 請提供下列設定詳細資料：

    設定 值
    為 bucket 命名 輸入全域不重複的名稱 (例如 netapp-bluexp-audit-logs)
    位置類型 根據需求選擇 (區域、雙區域、多區域)
    位置 選取位置 (例如 us-central1)
    儲存空間級別 標準 (建議用於經常存取的記錄)
    存取控管 統一 (建議)
    保護工具 選用：啟用物件版本管理或資料保留政策

  6. 點選「建立」。

為 Cloud Run 函式建立服務帳戶

  1. 在 GCP 控制台中，依序前往「IAM & Admin」(IAM 與管理) >「Service Accounts」(服務帳戶)。
  2. 按一下「Create Service Account」(建立服務帳戶)。
  3. 請提供下列設定詳細資料：
    • 服務帳戶名稱：輸入 netapp-bluexp-collector-sa
    • 服務帳戶說明：輸入 Service account for Cloud Run function to collect NetApp Console audit logs
  4. 按一下「建立並繼續」。
  5. 在「將專案存取權授予這個服務帳戶」部分，新增下列角色：
    1. 按一下「選擇角色」。
    2. 搜尋並選取「Storage 物件管理員」。
    3. 點選「+ 新增其他角色」。
    4. 搜尋並選取「Cloud Run Invoker」。
    5. 點選「+ 新增其他角色」。
    6. 搜尋並選取「Cloud Functions Invoker」(Cloud Functions 叫用者)。
  6. 按一下「繼續」。
  7. 按一下 [完成]。

授予 GCS 值區的 IAM 權限

  1. 依序前往「Cloud Storage」>「Buckets」。
  2. 按一下 bucket 名稱 (netapp-bluexp-audit-logs)。
  3. 前往「權限」分頁標籤。
  4. 按一下「授予存取權」。
  5. 請提供下列設定詳細資料：
    • 新增主體：輸入服務帳戶電子郵件地址 (netapp-bluexp-collector-sa@PROJECT_ID.iam.gserviceaccount.com)
    • 指派角色：選取「Storage 物件管理員」
  6. 按一下 [儲存]。

建立 Pub/Sub 主題

  1. 在 GCP Console 中，前往「Pub/Sub」>「Topics」(主題)。
  2. 按一下「建立主題」。
  3. 請提供下列設定詳細資料：
    • 主題 ID：輸入 netapp-bluexp-audit-trigger
    • 其他設定保留預設值
  4. 點選「建立」。

建立 Cloud Run 函式來收集記錄

Cloud Run 函式會由 Cloud Scheduler 的 Pub/Sub 訊息觸發，從 NetApp Console Audit API 擷取稽核記錄，並將記錄寫入 GCS。

  1. 前往 GCP Console 的「Cloud Run」。
  2. 按一下「Create service」(建立服務)。
  3. 選取「函式」 (使用內嵌編輯器建立函式)。

  4. 在「設定」部分，提供下列設定詳細資料：

    設定 值
    服務名稱 netapp-bluexp-collector
    區域 選取與 GCS bucket 相符的區域 (例如 us-central1)
    執行階段 選取 Python 3.12 以上版本

  5. 在「Trigger (optional)」(觸發條件 (選用)) 專區：

    1. 按一下「+ 新增觸發條件」。
    2. 選取「Cloud Pub/Sub」。
    3. 在「Select a Cloud Pub/Sub topic」(選取 Cloud Pub/Sub 主題) 中，選擇 netapp-bluexp-audit-trigger。
    4. 按一下 [儲存]。

  6. 在「Authentication」(驗證) 部分：

    1. 選取「需要驗證」。
    2. 檢查 Identity and Access Management (IAM)。

  7. 向下捲動並展開「容器」、「網路」和「安全性」。

  8. 前往「安全性」分頁：

    • 服務帳戶：選取 netapp-bluexp-collector-sa

  9. 前往「容器」分頁：

    1. 按一下「變數與密鑰」。
    2. 針對每個環境變數，按一下「+ 新增變數」：
    變數名稱 範例值 說明
    GCS_BUCKET netapp-bluexp-audit-logs GCS bucket 名稱
    GCS_PREFIX netapp-bluexp-audit 記錄檔的前置字串
    STATE_KEY netapp-bluexp-audit/state.json 狀態檔案路徑
    NETAPP_CLIENT_ID your-client-id NetApp Console 服務帳戶用戶端 ID
    NETAPP_CLIENT_SECRET your-client-secret NetApp Console 服務帳戶用戶端密鑰
    NETAPP_ACCOUNT_ID account-AbCdEfGh NetApp 控制台帳戶 ID
    MAX_RECORDS 5000 每次執行的記錄數上限
    LOOKBACK_HOURS 24 初始回溯期

  10. 在「變數與密鑰」部分，向下捲動至「要求」：

    • 要求逾時：輸入 600 秒 (10 分鐘)

  11. 前往「設定」分頁：

    • 在「資源」部分：
      • 記憶體：選取 512 MiB 以上
      • CPU：選取 1

  12. 在「修訂版本資源調度」部分：

    • 執行個體數量下限：輸入 0
    • 執行個體數量上限：輸入 100

  13. 點選「建立」。

  14. 等待服務建立完成 (1 到 2 分鐘)。

  15. 服務建立完成後，系統會自動開啟內嵌程式碼編輯器。

新增函式程式碼

  1. 在「進入點」欄位中輸入「main」。

  2. 在內嵌程式碼編輯器中建立兩個檔案：

    • main.py:
    import functions_framework
from google.cloud import storage
import json
import os
import urllib3
from datetime import datetime, timezone, timedelta
import time

http = urllib3.PoolManager(
  timeout=urllib3.Timeout(connect=5.0, read=30.0),
  retries=False,
)

storage_client = storage.Client()

GCS_BUCKET = os.environ.get('GCS_BUCKET')
GCS_PREFIX = os.environ.get('GCS_PREFIX', 'netapp-bluexp-audit')
STATE_KEY = os.environ.get('STATE_KEY', 'netapp-bluexp-audit/state.json')
NETAPP_CLIENT_ID = os.environ.get('NETAPP_CLIENT_ID')
NETAPP_CLIENT_SECRET = os.environ.get('NETAPP_CLIENT_SECRET')
NETAPP_ACCOUNT_ID = os.environ.get('NETAPP_ACCOUNT_ID')
MAX_RECORDS = int(os.environ.get('MAX_RECORDS', '5000'))
LOOKBACK_HOURS = int(os.environ.get('LOOKBACK_HOURS', '24'))

TOKEN_URL = 'https://netapp-cloud-account.auth0.com/oauth/token'
API_BASE = 'https://cloudmanager.cloud.netapp.com'
AUDIENCE = 'https://api.cloud.netapp.com'

def to_unix_millis(dt):
  if dt.tzinfo is None:
    dt = dt.replace(tzinfo=timezone.utc)
  dt = dt.astimezone(timezone.utc)
  return int(dt.timestamp() * 1000)

def parse_datetime(value):
  if value.endswith('Z'):
    value = value[:-1] + '+00:00'
  return datetime.fromisoformat(value)

def get_access_token():
  body = json.dumps({
    'grant_type': 'client_credentials',
    'client_id': NETAPP_CLIENT_ID,
    'client_secret': NETAPP_CLIENT_SECRET,
    'audience': AUDIENCE,
  }).encode('utf-8')

  response = http.request(
    'POST', TOKEN_URL,
    body=body,
    headers={'Content-Type': 'application/json'}
  )

  if response.status != 200:
    raise Exception(
      f"Token request failed: {response.status} - "
      f"{response.data.decode('utf-8')}"
    )

  data = json.loads(response.data.decode('utf-8'))
  token = data.get('access_token')
  if not token:
    raise Exception('No access_token in token response')

  print('Successfully obtained NetApp Console access token')
  return token

@functions_framework.cloud_event
def main(cloud_event):
  if not all([GCS_BUCKET, NETAPP_CLIENT_ID, NETAPP_CLIENT_SECRET, NETAPP_ACCOUNT_ID]):
    print('Error: Missing required environment variables')
    return

  try:
    bucket = storage_client.bucket(GCS_BUCKET)
    state = load_state(bucket)
    now = datetime.now(timezone.utc)

    if isinstance(state, dict) and state.get('last_event_time'):
      try:
        last_val = state['last_event_time']
        if last_val.endswith('Z'):
          last_val = last_val[:-1] + '+00:00'
        last_time = datetime.fromisoformat(last_val)
        last_time = last_time - timedelta(minutes=2)
      except Exception as e:
        print(f'Warning: Could not parse last_event_time: {e}')
        last_time = now - timedelta(hours=LOOKBACK_HOURS)
    else:
      last_time = now - timedelta(hours=LOOKBACK_HOURS)

    print(f'Fetching audit logs from {last_time.isoformat()} to {now.isoformat()}')

    token = get_access_token()

    records, newest_time = fetch_audit_logs(token, last_time, now)

    if not records:
      print('No new audit records found.')
      save_state(bucket, now.isoformat())
      return

    timestamp = now.strftime('%Y%m%d_%H%M%S')
    object_key = f'{GCS_PREFIX}/netapp_bluexp_audit_{timestamp}.ndjson'
    blob = bucket.blob(object_key)

    ndjson = '\n'.join(
      [json.dumps(r, ensure_ascii=False, default=str) for r in records]
    ) + '\n'
    blob.upload_from_string(ndjson, content_type='application/x-ndjson')

    print(f'Wrote {len(records)} records to gs://{GCS_BUCKET}/{object_key}')

    save_state(bucket, newest_time if newest_time else now.isoformat())

    print(f'Successfully processed {len(records)} audit records')

  except Exception as e:
    print(f'Error processing audit logs: {str(e)}')
    raise

def fetch_audit_logs(token, start_time, end_time):
  endpoint = f'{API_BASE}/audit/{NETAPP_ACCOUNT_ID}'

  headers = {
    'Authorization': f'Bearer {token}',
    'Accept': 'application/json',
    'User-Agent': 'GoogleSecOps-NetAppBlueXPCollector/1.0',
  }

  start_millis = to_unix_millis(start_time)
  end_millis = to_unix_millis(end_time)

  records = []
  newest_time = None
  offset = 0
  page_num = 0
  backoff = 1.0

  while True:
    page_num += 1

    if len(records) >= MAX_RECORDS:
      print(f'Reached max_records limit ({MAX_RECORDS})')
      break

    url = (
      f'{endpoint}'
      f'?fromLastModified={start_millis}'
      f'&toLastModified={end_millis}'
      f'&offset={offset}'
    )

    try:
      response = http.request('GET', url, headers=headers)

      if response.status == 429:
        retry_after = int(response.headers.get('Retry-After', str(int(backoff))))
        print(f'Rate limited (429). Retrying after {retry_after}s...')
        time.sleep(retry_after)
        backoff = min(backoff * 2, 30.0)
        continue

      backoff = 1.0

      if response.status != 200:
        print(f'HTTP Error: {response.status}')
        response_text = response.data.decode('utf-8')
        print(f'Response body: {response_text}')
        return [], None

      data = json.loads(response.data.decode('utf-8'))

      page_results = data.get('auditEntries', [])

      if not page_results:
        print('No more results (empty page)')
        break

      print(f'Page {page_num}: Retrieved {len(page_results)} audit records')
      records.extend(page_results)

      for entry in page_results:
        try:
          last_modified = entry.get('lastModified')
          if last_modified:
            entry_dt = datetime.fromtimestamp(
              last_modified / 1000, tz=timezone.utc
            )
            entry_time = entry_dt.isoformat()
            if newest_time is None or parse_datetime(entry_time) > parse_datetime(newest_time):
              newest_time = entry_time
        except Exception as e:
          print(f'Warning: Could not parse entry time: {e}')

      count = data.get('count', len(page_results))
      if count < 100:
        print(f'Reached last page (count={count})')
        break

      offset += count

    except Exception as e:
      print(f'Error fetching audit logs: {e}')
      return [], None

  print(f'Retrieved {len(records)} total audit records from {page_num} pages')
  return records, newest_time

def load_state(bucket):
  try:
    blob = bucket.blob(STATE_KEY)
    if blob.exists():
      return json.loads(blob.download_as_text())
  except Exception as e:
    print(f'Warning: Could not load state: {e}')
  return {}

def save_state(bucket, last_event_time_iso):
  try:
    state = {
      'last_event_time': last_event_time_iso,
      'last_run': datetime.now(timezone.utc).isoformat(),
    }
    blob = bucket.blob(STATE_KEY)
    blob.upload_from_string(
      json.dumps(state, indent=2),
      content_type='application/json'
    )
    print(f'Saved state: last_event_time={last_event_time_iso}')
  except Exception as e:
    print(f'Warning: Could not save state: {e}')
    • requirements.txt:
    functions-framework==3.*
google-cloud-storage==2.*
urllib3>=2.0.0

  3. 點選「部署」即可儲存並部署函式。

  4. 等待部署作業完成 (2 到 3 分鐘)。

建立 Cloud Scheduler 工作

Cloud Scheduler 會定期將訊息發布至 Pub/Sub 主題，觸發 Cloud Run 函式。

  1. 前往 GCP 主控台的「Cloud Scheduler」。
  2. 點選「建立工作」。

  3. 請提供下列設定詳細資料：

    設定 值
    名稱 netapp-bluexp-collector-hourly
    區域 選取與 Cloud Run 函式相同的區域
    頻率 0 * * * * (每小時整點)
    時區 選取時區 (建議使用世界標準時間)
    目標類型 Pub/Sub
    主題 選取「netapp-bluexp-audit-trigger」
    郵件內文 {} (空白 JSON 物件)

  4. 點選「建立」。

排程頻率選項

根據記錄檔量和延遲時間要求選擇頻率：

頻率 Cron 運算式 用途
每 5 分鐘 */5 * * * * 大量、低延遲
每 15 分鐘 */15 * * * * 中等
每小時 0 * * * * 標準 (建議)
每 6 小時 0 */6 * * * 少量、批次處理
每日 0 0 * * * 歷來資料集合

測試整合項目

  1. 在 Cloud Scheduler 控制台中，找出您的工作 (netapp-bluexp-collector-hourly)。
  2. 按一下「強制執行」即可手動觸發工作。
  3. 稍等幾秒鐘。
  4. 前往「Cloud Run」>「Services」。
  5. 按一下 netapp-bluexp-collector。
  6. 按一下 [Logs] (記錄) 分頁標籤。

  7. 確認函式是否已順利執行。請注意以下事項：

    Fetching audit logs from YYYY-MM-DDTHH:MM:SS+00:00 to YYYY-MM-DDTHH:MM:SS+00:00
Successfully obtained NetApp Console access token
Page 1: Retrieved X audit records
Wrote X records to gs://netapp-bluexp-audit-logs/netapp-bluexp-audit/netapp_bluexp_audit_YYYYMMDD_HHMMSS.ndjson
Successfully processed X audit records

  8. 依序前往「Cloud Storage」>「Buckets」。

  9. 按一下 netapp-bluexp-audit-logs。

  10. 前往 netapp-bluexp-audit/ 資料夾。

  11. 確認是否已建立新的 .ndjson 檔案，且檔案名稱包含目前的時間戳記。

如果記錄中顯示錯誤：

  • HTTP 401：確認 NETAPP_CLIENT_ID 和 NETAPP_CLIENT_SECRET 環境變數是否正確
  • HTTP 403：確認服務帳戶在 NetApp 控制台中具有機構檢視者角色
  • HTTP 429：頻率限制，函式會自動重試，並採用指數輪詢間隔
  • 缺少環境變數：確認 Cloud Run 函式設定中已設定所有必要變數

擷取 Google SecOps 服務帳戶

  1. 依序前往「SIEM 設定」>「動態饋給」。
  2. 按一下「新增動態消息」。
  3. 按一下「設定單一動態饋給」。
  4. 在「動態饋給名稱」欄位中輸入動態饋給名稱 (例如 NetApp Console Audit Logs)。
  5. 選取「Google Cloud Storage V2」做為「來源類型」。
  6. 選取「NetApp Console (前身為 BlueXP)」做為「記錄類型」。

  7. 按一下「取得服務帳戶」，系統會顯示專屬服務帳戶電子郵件地址，例如：

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com

  8. 複製這個電子郵件地址，以便在下一步中使用。

  9. 點選「下一步」。

  10. 指定下列輸入參數的值：

    • 儲存空間 bucket URL：輸入 GCS bucket URI，並加上前置路徑：

      gs://netapp-bluexp-audit-logs/netapp-bluexp-audit/

    • 來源刪除選項：根據偏好設定選取刪除選項：

      • 永不：移轉後一律不刪除任何檔案 (建議用於測試)。
      • 刪除已轉移的檔案：成功轉移檔案後刪除檔案。

      • 刪除已轉移的檔案和空白目錄：成功轉移後刪除檔案和空白目錄。

    • 檔案存在時間上限：包含在過去天數內修改的檔案 (預設為 180 天)

    • 資產命名空間：資產命名空間

    • 擷取標籤：要套用至這個動態饋給事件的標籤

  11. 點選「下一步」。

  12. 在「Finalize」(完成) 畫面中檢查新的動態饋給設定，然後按一下「Submit」(提交)。

將 IAM 權限授予 Google SecOps 服務帳戶

  1. 依序前往「Cloud Storage」>「Buckets」。
  2. 按一下 netapp-bluexp-audit-logs。
  3. 前往「權限」分頁標籤。
  4. 按一下「授予存取權」。
  5. 請提供下列設定詳細資料：
    • 新增主體：貼上 Google SecOps 服務帳戶電子郵件地址
    • 指派角色：選取「Storage 物件檢視者」

  6. 按一下 [儲存]。

UDM 對應表

記錄欄位 UDM 對應 邏輯
endTime additional.fields 如果每個標籤都不為空，則會與標籤合併
responseData additional.fields
weHash additional.fields
wePublicId additional.fields
hasFailedRecord additional.fields
動作 additional.fields
服務 additional.fields
hasRecords additional.fields
workspaceId additional.fields
lastModified additional.fields
startTime additional.fields
agentName metadata.event_type 如果 agentName 不為空白，則設為 STATUS_UPDATE，否則設為 GENERIC_EVENT
agentId metadata.product_deployment_id 如果值不是空白，則直接複製
requestId metadata.product_log_id 如果值不是空白，則直接複製
網路 網路 如果不是空白，則直接重新命名
agentName principal.asset.hostname 如果值不是空白，則直接複製
fileName principal.file.names 如果不是空白，則會合併
agentName principal.hostname 如果值不是空白，則直接複製
accountId principal.resource.id 如果值不是空白，則直接複製
resourceName principal.resource.name 如果值不是空白，則直接複製
accountId principal.resource.product_object_id 如果 accountId 不是空白，則取自該值；否則，如果 resourceId 不是空白，則取自該值
resourceId principal.resource.product_object_id
principalId principal.user.userid 如果值不是空白，則直接複製
狀態 security_result.action 如果狀態 =~ (?i)SUCCESS，請設為 ALLOW；如果狀態為 FAILURE 或 UNSUCCESSFUL_ATTEMPT，請設為 BLOCK
狀態 security_result.action_details 如果值不是空白，則直接複製
目標 目標 如果不是空白，則直接重新命名

變更記錄

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

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