收集 Workday 用户活动日志

支持的平台:

本文档介绍了如何使用 Cloud Storage V2 将 Workday 用户活动日志注入到 Google Security Operations。

Workday 是一个基于云的人力资本管理 (HCM) 和财务平台,可生成用户活动、身份验证和安全审核日志。用户活动日志记录 REST API 提供对这些日志的程序化访问。

准备工作

请确保满足以下前提条件:

  • Google SecOps 实例
  • 启用了 {storage_api} 的 Google Cloud 项目
  • 创建和管理 Cloud Storage 存储桶的权限
  • 管理 Cloud Storage 存储桶的 Identity and Access Management (IAM) 政策的权限
  • 创建 Cloud Run 服务、Pub/Sub 主题和 Cloud Scheduler 作业的权限
  • 拥有安全管理员权限或同等权限的 Workday 特权访问权限
  • 您的 Workday 租户中已启用用户活动日志记录

创建 Cloud Storage 存储桶

  1. 前往 Google Cloud 控制台。
  2. 选择您的项目或创建一个新项目。
  3. 在导航菜单中,依次前往 Cloud Storage > 存储桶。
  4. 点击创建存储分区。
  5. 提供以下配置详细信息:

    设置 值
    为存储桶命名 输入一个全局唯一的名称(例如 workday-activity-logs)
    位置类型 根据您的需求进行选择(区域级、双区域级、多区域级)
    位置 选择位置(例如 us-central1)
    存储类别 标准(建议用于频繁访问的日志)
    访问权限控制 均匀(推荐)
    保护工具 可选:启用对象版本控制或保留政策
  6. 点击创建。

收集 Workday API 凭据

启用用户活动日志

  1. 以安全管理员身份登录 Workday 租户。
  2. 在 Workday 搜索栏中,搜索并打开修改租户设置 - 系统任务。
  3. 在安全性部分,选中启用用户活动日志记录复选框。
  4. 点击确定以保存更改。

创建集成系统用户 (ISU)

  1. 在 Workday 搜索栏中,搜索创建集成系统用户。
  2. 输入用户名(例如 ISU_SIEM_Export)和安全系数高的密码。
  3. 清除要求在下次登录时使用新密码复选框。
  4. 点击确定。
  5. 搜索创建安全群组,然后创建集成系统安全群组(不受约束)。
  6. 将 ISU (ISU_SIEM_Export) 添加到此安全组。
  7. 搜索查看网域,然后找到用户活动日志记录网域。向相应网域的 ISU 安全组授予 Get 访问权限。
  8. 搜索激活待处理的安全政策更改,然后激活更改。

注册 API 客户端以进行 OAuth

  1. 在 Workday 搜索栏中,搜索 Register API Client for Integrations。
  2. 输入客户端名称(例如 SIEM_OAuth_Client)。
  3. 选择永不过期的刷新令牌选项。
  4. 添加范围:System(或 User Activity Logging API 所需的范围)。
  5. 点击确定。
  6. 请复制以下详细信息并将其保存在安全的位置:
    • 客户端 ID:API 客户端标识符。
    • 客户端密钥:API 客户端密钥。
  7. 搜索管理集成的刷新令牌。
  8. 选择 ISU 账号 (ISU_SIEM_Export)。
  9. 为 API 客户端生成新的刷新令牌。
  10. 复制并保存刷新令牌。

确定租户网址

API 端点取决于您的 Workday 租户。格式为:

组件 值
令牌端点 https://HOST/ccx/oauth2/TENANT/token
Activity Logging API https://HOST/ccx/api/privacy/v1/TENANT/activityLogging

验证权限

如需验证 ISU 是否拥有所需的权限,请执行以下操作:

  1. 以安全管理员身份登录 Workday。
  2. 搜索查看集成系统用户,然后选择 ISU (ISU_SIEM_Export)。
  3. 验证用户是否是具有 Get 访问权限的安全组的成员,该安全组可访问 User Activity Logging 网域。
  4. 如果缺少访问权限,请更新安全组并激活待处理的安全政策更改。

测试 API 访问权限

  • 在继续进行集成之前,请测试您的凭据:

    ```bash
    # Replace with your actual credentials
    CLIENT_ID="your-client-id"
    CLIENT_SECRET="your-client-secret"
    REFRESH_TOKEN="your-refresh-token"
    HOST="your-workday-host"
    TENANT="your-tenant"
    
    # Get OAuth access token
    TOKEN=$(curl -s -X POST "https://${HOST}/ccx/oauth2/${TENANT}/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "grant_type=refresh_token&client_id=${CLIENT_ID}&client_secret=${CLIENT_SECRET}&refresh_token=${REFRESH_TOKEN}" \
        | jq -r '.access_token')
    
    # Test API access
    curl -v -H "Authorization: Bearer ${TOKEN}" \
        "https://${HOST}/ccx/api/privacy/v1/${TENANT}/activityLogging?from=2024-01-01T00:00:00Z&to=2024-01-01T01:00:00Z"
    ```
    

为 Cloud Run 函数创建服务账号

Cloud Run 函数需要一个服务账号,该账号具有写入 Cloud Storage 存储桶和被 Pub/Sub 调用的权限。

创建服务账号

  1. 在 GCP 控制台中,依次前往 IAM 和管理 > 服务账号。
  2. 点击创建服务账号。
  3. 提供以下配置详细信息:
    • 服务账号名称:输入 workday-activity-collector-sa。
    • 服务账号说明:输入 Service account for Cloud Run function to collect Workday User Activity logs。
  4. 点击创建并继续。
  5. 在向此服务账号授予对项目的访问权限部分,添加以下角色:
    1. 点击选择角色。
    2. 搜索并选择 Storage Object Admin。
    3. 点击 + 添加其他角色。
    4. 搜索并选择 Cloud Run Invoker。
    5. 点击 + 添加其他角色。
    6. 搜索并选择 Cloud Functions Invoker。
  6. 点击继续。
  7. 点击完成。

以下操作需要这些角色:

  • Storage Object Admin:将日志写入 Cloud Storage 存储桶并管理状态文件
  • Cloud Run Invoker:允许 Pub/Sub 调用函数
  • Cloud Functions Invoker:允许调用函数

授予对 Cloud Storage 存储桶的 IAM 权限

向服务账号授予 Cloud Storage 存储桶的写入权限,如下所示:

  1. 前往 Cloud Storage > 存储桶。
  2. 点击您的存储桶名称(例如 workday-activity-logs)。
  3. 前往权限标签页。
  4. 点击授予访问权限。
  5. 提供以下配置详细信息:
    • 添加主账号:输入服务账号电子邮件地址(例如 workday-activity-collector-sa@your-project.iam.gserviceaccount.com)。
    • 分配角色:选择 Storage Object Admin。
  6. 点击保存。

创建 Pub/Sub 主题

创建 Cloud Scheduler 将发布到的 Pub/Sub 主题,以及 Cloud Run 函数将订阅的主题。

  1. 在 GCP 控制台中,前往 Pub/Sub > 主题。
  2. 点击创建主题。
  3. 提供以下配置详细信息:
    • 主题 ID:输入 workday-activity-trigger。
    • 将其他设置保留为默认值。
  4. 点击创建。

创建 Cloud Run 函数以收集日志

Cloud Run 函数将由来自 Cloud Scheduler 的 Pub/Sub 消息触发,以从 Workday User Activity Logging API 中提取日志并将其写入 Cloud Storage。

  1. 在 GCP 控制台中,前往 Cloud Run。
  2. 点击编写函数。
  3. 在配置部分中,提供以下配置详细信息:

    设置 值
    Service 名称 workday-activity-collector
    区域 选择与您的 Cloud Storage 存储桶匹配的区域(例如 us-central1)
    运行时 选择 Python 3.12 或更高版本
  4. 在触发器部分中,点击添加触发器,然后选择 Pub/Sub 触发器。

  5. 在 Eventarc 触发器窗格中,提供以下配置详细信息:

    • 触发器名称:保留生成的名称,或输入触发器的名称。
    • 触发器类型:选择 Google 来源。
    • 事件提供方:选择 Pub/Sub。
    • 事件类型:选择 google.cloud.pubsub.topic.v1.messagePublished。
    • 选择 Cloud Pub/Sub 主题:选择主题 workday-activity-trigger。
    • 区域:选择与函数相同的区域。
    • 服务账号:选择服务账号 workday-activity-collector-sa。
  6. 点击保存触发器。

  7. 在身份验证部分中:

    1. 选择需要进行身份验证。
    2. 选择 Identity and Access Management (IAM)。
  8. 找到并展开容器、网络、安全性。

  9. 前往安全标签页:

    • 服务账号:选择服务账号 workday-activity-collector-sa。
  10. 前往容器标签页:

    1. 点击变量和密钥。
    2. 为每个环境变量点击 + 添加变量:
    变量名称 示例值 说明
    GCS_BUCKET workday-activity-logs Cloud Storage 存储桶名称
    GCS_PREFIX workday 日志文件的前缀
    STATE_KEY workday-state.json 状态路径,位于日志前缀之外
    WORKDAY_HOST your-workday-host Workday 主机名
    WORKDAY_TENANT your-tenant Workday 租户名称
    CLIENT_ID your-client-id OAuth 客户端 ID
    CLIENT_SECRET your-client-secret OAuth 客户端密钥
    REFRESH_TOKEN your-refresh-token OAuth 刷新令牌
    MAX_RECORDS 10000 每次运行的记录数上限
    PAGE_SIZE 100 每页记录数
    LOOKBACK_HOURS 24 初始回溯期
  11. 在变量和 Secret 标签页中,前往请求:

    • 请求超时:输入 600 秒(10 分钟)。
  12. 前往容器中的设置标签页:

    • 在资源部分中:
      • 内存:选择 512 MiB 或更高值。
      • CPU:选择 1。
  13. 在修订版本伸缩部分中:

    • 实例数下限:输入 0。
    • 实例数上限:输入 100(或根据预期负载进行调整)。
  14. 点击创建。

  15. 等待服务创建完成(1-2 分钟)。

  16. 创建服务后,系统会自动打开内嵌代码编辑器。

添加函数代码

  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
      import hashlib
      
      # Initialize HTTP client with timeouts
      http = urllib3.PoolManager(
          timeout=urllib3.Timeout(connect=5.0, read=30.0),
          retries=False,
      )
      
      # Initialize Storage client
      storage_client = storage.Client()
      
      # Environment variables
      GCS_BUCKET = os.environ.get('GCS_BUCKET')
      GCS_PREFIX = os.environ.get('GCS_PREFIX', 'workday')
      STATE_KEY = os.environ.get('STATE_KEY', 'workday-state.json')
      WORKDAY_HOST = os.environ.get('WORKDAY_HOST', '')
      WORKDAY_TENANT = os.environ.get('WORKDAY_TENANT', '')
      CLIENT_ID = os.environ.get('CLIENT_ID', '')
      CLIENT_SECRET = os.environ.get('CLIENT_SECRET', '')
      REFRESH_TOKEN = os.environ.get('REFRESH_TOKEN', '')
      MAX_RECORDS = int(os.environ.get('MAX_RECORDS', '10000'))
      PAGE_SIZE = int(os.environ.get('PAGE_SIZE', '100'))
      LOOKBACK_HOURS = int(os.environ.get('LOOKBACK_HOURS', '24'))
      
      def parse_datetime(value: str) -> datetime:
          """Parse ISO datetime string to datetime object."""
          if value.endswith("Z"):
              value = value[:-1] + "+00:00"
          return datetime.fromisoformat(value)
      
      # Activity Logging entries carry no per-event identifier (taskId and
      # sessionId are reused), so the content hash is the identity.
      ID_FIELDS = ()
      
      def event_keys(event):
          """Return every identity this event can be recognised by."""
          keys = {'sha256:' + hashlib.sha256(
              json.dumps(event, sort_keys=True, ensure_ascii=False).encode('utf-8')
          ).hexdigest()}
          for field in ID_FIELDS:
              value = event.get(field)
              if value:
                  keys.add(f'{field}:{value}')
          return keys
      
      def get_token():
          """Get OAuth 2.0 access token using refresh token flow."""
          token_url = f"https://{WORKDAY_HOST}/ccx/oauth2/{WORKDAY_TENANT}/token"
      
          body = f"grant_type=refresh_token&client_id={CLIENT_ID}&client_secret={CLIENT_SECRET}&refresh_token={REFRESH_TOKEN}"
      
          headers = {
              'Content-Type': 'application/x-www-form-urlencoded',
              'Accept': 'application/json'
          }
      
          backoff = 1.0
          max_retries = 3
      
          for attempt in range(max_retries):
              response = http.request('POST', token_url, body=body.encode('utf-8'), headers=headers)
      
              if response.status == 429:
                  retry_after = int(response.headers.get('Retry-After', str(int(backoff))))
                  print(f"Rate limited (429) on token request. Retrying after {retry_after}s...")
                  time.sleep(retry_after)
                  backoff = min(backoff * 2, 30.0)
                  continue
      
              if response.status != 200:
                  raise RuntimeError(f"Failed to get access token: {response.status} - {response.data.decode('utf-8')}")
      
              data = json.loads(response.data.decode('utf-8'))
              return data['access_token']
      
          raise RuntimeError(f"Failed to get token after {max_retries} retries due to rate limiting")
      
      @functions_framework.cloud_event
      def main(cloud_event):
          """
          Cloud Run function triggered by Pub/Sub to fetch Workday User Activity logs and write to GCS.
      
          Args:
              cloud_event: CloudEvent object containing Pub/Sub message
          """
      
          if not all([GCS_BUCKET, WORKDAY_HOST, WORKDAY_TENANT, CLIENT_ID, CLIENT_SECRET, REFRESH_TOKEN]):
              print('Error: Missing required environment variables')
              return
      
          try:
              bucket = storage_client.bucket(GCS_BUCKET)
      
              # Load state
              state = load_state(bucket, STATE_KEY)
              seen_keys = load_seen(bucket, STATE_KEY)
      
              # Determine time window
              now = datetime.now(timezone.utc)
              last_time = None
      
              if isinstance(state, dict) and state.get("last_event_time"):
                  try:
                      last_time = parse_datetime(state["last_event_time"])
                      last_time = last_time - timedelta(minutes=2)
                  except Exception as e:
                      print(f"Warning: Could not parse last_event_time: {e}")
      
              if last_time is None:
                  last_time = now - timedelta(hours=LOOKBACK_HOURS)
      
              print(f"Fetching logs from {last_time.isoformat()} to {now.isoformat()}")
      
              # Get access token
              token = get_token()
      
              # Fetch logs
              records, newest_event_time = fetch_logs(
                  token=token,
                  start_time=last_time,
                  end_time=now,
                  page_size=PAGE_SIZE,
                  max_records=MAX_RECORDS,
              )
      
              # Drop the events the overlap window re-read from the previous run
              fresh = [r for r in records if not (event_keys(r) & seen_keys)]
              all_keys = set()
              for record in records:
                  all_keys |= event_keys(record)
      
              if not fresh:
                  print("No new log records found.")
                  return
      
              # Write to GCS as NDJSON
              timestamp = now.strftime('%Y%m%d_%H%M%S')
              object_key = f"{GCS_PREFIX}/logs_{timestamp}.ndjson"
              blob = bucket.blob(object_key)
      
              ndjson = '\n'.join([json.dumps(record, ensure_ascii=False) for record in fresh]) + '\n'
              blob.upload_from_string(ndjson, content_type='application/x-ndjson')
      
              print(f"Wrote {len(fresh)} records to gs://{GCS_BUCKET}/{object_key}")
      
              # Remember every fetched record so the next overlap window skips it
              save_seen(bucket, STATE_KEY, all_keys)
      
              if newest_event_time:
                  save_state(bucket, STATE_KEY, newest_event_time)
              else:
                  save_state(bucket, STATE_KEY, now.isoformat())
      
              print(f"Successfully processed {len(fresh)} records")
      
          except Exception as e:
              print(f'Error processing logs: {str(e)}')
              raise
      
      def load_state(bucket, key):
          """Load state from GCS."""
          try:
              blob = bucket.blob(key)
              if blob.exists():
                  state_data = blob.download_as_text()
                  return json.loads(state_data)
          except Exception as e:
              print(f"Warning: Could not load state: {e}")
              raise
      
          return {}
      
      def save_state(bucket, key, last_event_time_iso: str):
          """Save the last event timestamp to GCS state file."""
          try:
              state = {'last_event_time': last_event_time_iso}
              blob = bucket.blob(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}")
              raise
      
      def load_seen(bucket, key):
          """Load the event keys written by the previous run (sidecar object)."""
          try:
              blob = bucket.blob(key + '.seen')
              if blob.exists():
                  return set(json.loads(blob.download_as_text()))
          except Exception as e:
              print(f"Warning: Could not load seen keys: {e}")
              raise
      
          return set()
      
      def save_seen(bucket, key, keys):
          """Save the event keys of this run to the sidecar object."""
          try:
              blob = bucket.blob(key + '.seen')
              blob.upload_from_string(
                  json.dumps(sorted(keys)),
                  content_type='application/json'
              )
              print(f"Saved {len(keys)} event keys for deduplication")
          except Exception as e:
              print(f"Warning: Could not save seen keys: {e}")
              raise
      
      def fetch_logs(token: str, start_time: datetime, end_time: datetime, page_size: int, max_records: int):
          """
          Fetch user activity logs from Workday Activity Logging API with pagination and rate limiting.
      
          Args:
              token: OAuth 2.0 access token
              start_time: Start time for log query
              end_time: End time for log query
              page_size: Number of records per page
              max_records: Maximum total records to fetch
      
          Returns:
              Tuple of (records list, newest_event_time ISO string)
          """
          base_url = f"https://{WORKDAY_HOST}/ccx/api/privacy/v1/{WORKDAY_TENANT}/activityLogging"
      
          headers = {
              'Authorization': f'Bearer {token}',
              'Accept': 'application/json',
              'User-Agent': 'GoogleSecOps-WorkdayCollector/1.0'
          }
      
          records = []
          newest_time = None
          page_num = 0
          backoff = 1.0
          offset = 0
      
          from_iso = start_time.strftime('%Y-%m-%dT%H:%M:%SZ')
          to_iso = end_time.strftime('%Y-%m-%dT%H:%M:%SZ')
      
          while True:
              page_num += 1
      
              if len(records) >= max_records:
                  print(f"Reached max_records limit ({max_records})")
                  break
      
              current_limit = min(page_size, max_records - len(records))
              url = f"{base_url}?from={from_iso}&to={to_iso}&limit={current_limit}&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('data', [])
      
                  if not page_results:
                      print(f"No more results (empty page)")
                      break
      
                  print(f"Page {page_num}: Retrieved {len(page_results)} events")
                  records.extend(page_results)
      
                  # Track newest event time
                  for event in page_results:
                      try:
                          event_time = event.get('requestTime') or event.get('systemAccount', {}).get('signOnDateTime')
                          if event_time:
                              if newest_time is None or parse_datetime(event_time) > parse_datetime(newest_time):
                                  newest_time = event_time
                      except Exception as e:
                          print(f"Warning: Could not parse event time: {e}")
      
                  # Check pagination
                  total = data.get('total', 0)
                  if offset + len(page_results) >= total:
                      print(f"Reached end of results (offset={offset + len(page_results)}, total={total})")
                      break
      
                  offset += len(page_results)
      
              except Exception as e:
                  print(f"Error fetching logs: {e}")
                  return [], None
      
          print(f"Retrieved {len(records)} total records from {page_num} pages")
          return records, newest_time
      

    • 第二个文件: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. 提供以下配置详细信息:

    设置 值
    名称 workday-activity-collector-hourly
    区域 选择与 Cloud Run 函数相同的区域
    频率 0 * * * *(每小时整点)
    时区 选择时区(建议选择世界协调时间 [UTC])
    目标类型 Pub/Sub
    主题 选择主题 workday-activity-trigger
    消息正文 {}(空 JSON 对象)
  4. 点击创建。

时间表频率选项

根据日志量和延迟时间要求选择频次:

频率 Cron 表达式 使用场景
每隔 5 分钟 */5 * * * * 大容量、低延迟
每隔 15 分钟 */15 * * * * 搜索量中等
每小时 0 * * * * 标准(推荐)
每 6 小时 0 */6 * * * 低量批处理
每天 0 0 * * * 历史数据收集

测试集成

  1. 在 Cloud Scheduler 控制台中,找到您的作业 (workday-activity-collector-hourly)。
  2. 点击强制运行以手动触发。
  3. 等待几秒钟,然后前往 Cloud Run > 服务 > workday-activity-collector > 日志。
  4. 验证函数是否已成功执行。查找:

    Fetching logs from YYYY-MM-DDTHH:MM:SS+00:00 to YYYY-MM-DDTHH:MM:SS+00:00
    Page 1: Retrieved X events
    Wrote X records to gs://workday-activity-logs/workday/logs_YYYYMMDD_HHMMSS.ndjson
    Successfully processed X records
    
  5. 检查 Cloud Storage 存储桶 (workday-activity-logs),确认日志是否已写入。

如果您在日志中看到错误,请执行以下操作:

  • HTTP 401:检查环境变量中的 OAuth 凭据
  • HTTP 403:验证 ISU 是否拥有用户活动日志记录网域所需的权限
  • HTTP 429:速率限制 - 函数将自动重试并进行退避
  • 未能获取访问令牌:验证 WORKDAY_HOST、WORKDAY_TENANT、CLIENT_ID、CLIENT_SECRET 和 REFRESH_TOKEN 是否正确

在 Google SecOps 中配置 Feed 以注入 Workday 用户活动日志

  1. 前往 SIEM 设置 > Feed。
  2. 点击添加新 Feed。
  3. 点击配置单个 Feed。
  4. 在 Feed 名称字段中,输入 Feed 的名称(例如 Workday User Activity Logs)。
  5. 选择 Google Cloud Storage V2 作为来源类型。
  6. 选择 Workday 用户活动作为日志类型。
  7. 点击获取服务账号。系统会显示一个唯一的服务账号电子邮件地址,例如:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. 复制此电子邮件地址。您将在下一步中用到它。

  9. 点击下一步。

  10. 为以下输入参数指定值:

    • 存储桶网址:输入带有前缀路径的 Cloud Storage 存储桶 URI:

      gs://workday-activity-logs/workday/
      
      • 替换:
        • workday-activity-logs:您的 Cloud Storage 存储桶名称。
        • workday:存储日志的可选前缀或路径(留空表示根目录)。
    • 来源删除选项:根据您的偏好选择删除选项:

      • 永不删除文件:永不从源中删除文件(建议用于测试)。
      • 删除已转移的文件和空目录:在成功完成提取后,从来源位置删除文件和空目录。
    • 文件存在时间上限:包含在过去指定天数内修改过的文件(默认值为 180 天)。

    • 资源命名空间:资源命名空间。

    • 注入标签:要应用于此 Feed 中事件的标签。

  11. 点击下一步。

  12. 在最终确定界面中查看新的 Feed 配置,然后点击提交。

向 Google SecOps 服务账号授予 IAM 权限

Google SecOps 服务账号需要对您的 Cloud Storage 存储桶拥有两个角色:用于读取日志对象的 Storage Object Viewer,以及用于读取存储桶元数据的存储桶级角色。

  1. 前往 Cloud Storage > 存储桶。
  2. 点击您的存储桶名称 (workday-activity-logs)。
  3. 前往权限标签页。
  4. 点击授予访问权限。
  5. 提供以下配置详细信息:
    • 添加主账号:粘贴 Google SecOps 服务账号电子邮件地址。
    • 分配角色:选择以下两个角色:
      • Storage Object Viewer:读取日志对象。
      • Storage Legacy Bucket Reader:读取存储桶元数据。如果您选择了删除已转移的文件和空目录删除选项,请改为选择存储旧版存储桶写入者,该角色也会授予删除权限。
  6. 点击保存。

UDM 映射表

日志字段 UDM 映射 逻辑
Account_Locked__Disabled_or_Expired_label additional.fields 已合并
Authentication_Type_label additional.fields 已合并
Created_Moment_label additional.fields 已合并
Current_OMS_Version_label additional.fields 已合并
Device_is_Trusted_label additional.fields 已合并
Elapsed_Time__Minutes_label additional.fields 已合并
Failed_Sign_On_label additional.fields 已合并
Hire_Date_for_Signon_Worker_label additional.fields 已合并
Job_Family_for_Signon_Worker_label additional.fields 已合并
Operating_System_label additional.fields 已合并
Pay_Rate_type_label additional.fields 已合并
Request_Originator_label additional.fields 已合并
SAML_Identity_Provider_label additional.fields 已合并
Sign-on_Time_label additional.fields 已合并
Signoff_Time_label additional.fields 已合并
Signon_Day_of_the_Week_label additional.fields 已合并
Signon_Hour_of_Day_label additional.fields 已合并
Tenant_Access_Read_Only_label additional.fields 已合并
UI_Client_Type_label additional.fields 已合并
Worker_Active_for_Signon_Worker_label additional.fields 已合并
Worker_Type_for_Signon_Worker_label additional.fields 已合并
awaiting_details_label additional.fields 已合并
data_label additional.fields 已合并
evp_nme_label additional.fields 已合并
evpminus_label additional.fields 已合并
signon_ip_address_label additional.fields 已合并
@requestTime metadata.event_timestamp 解析为 ISO8601
Sign-on_Time metadata.event_timestamp 解析为 yyyy-MM-ddTHH:mm:ssZZ
event_type metadata.event_type 直接映射
status_code metadata.product_event_type 直接映射
tenant metadata.product_event_type 直接映射
taskId metadata.product_log_id 直接映射
User_Agent network.http.parsed_user_agent 已重命名/已映射
Browser_Type network.http.user_agent 直接映射
User_Agent network.http.user_agent 直接映射
userAgent network.http.user_agent 直接映射
Session_ID network.session_id 直接映射
sessionId network.session_id 直接映射
Client_TLS_Version network.tls.version 已重命名/已映射
Worker principal.asset.hostname 直接映射
ip principal.asset.ip 已合并
ipaddress principal.asset.ip 已合并
Worker principal.hostname 直接映射
manager_name principal.hostname 直接映射
ip principal.ip 已合并
ipaddress principal.ip 已合并
Signon_Worker_label principal.user.attribute.labels 已合并
Supervisory_Organization_of_Signon_Worker_label principal.user.attribute.labels 已合并
System_Account_label principal.user.attribute.labels 已合并
Workday_Account_Sign_On_label principal.user.attribute.labels 已合并
user_credentials_label principal.user.attribute.labels 已合并
User_Name principal.user.email_addresses 已合并
Role principal.user.user_display_name 直接映射
manager_id principal.user.userid 直接映射
Active_Session_label security_result.detection_fields 已合并
Authentication_Failure_Message_label security_result.detection_fields 已合并
Forgotten_Password_Reset_Request_label security_result.detection_fields 已合并
Invalid_Credentials_label security_result.detection_fields 已合并
Is_Device_Managed_label security_result.detection_fields 已合并
MFA_Exempt_label security_result.detection_fields 已合并
Password_Changed_label security_result.detection_fields 已合并
Position_label security_result.detection_fields 已合并
taskDisplayName security_result.summary 直接映射
hostname target.hostname 直接映射
CITY_NME target.location.city 直接映射
Location target.location.city 直接映射
COUNTRY_NME target.location.country_or_region 直接映射
Location_Country_for_Signon_Worker target.location.country_or_region 直接映射
Location_State target.location.state 直接映射
STATE_NME target.location.state 直接映射
Exempt_labels target.resource.attribute.labels 已合并
browser_type_label target.resource.attribute.labels 已合并
class_of_instance_label target.resource.attribute.labels 已合并
device target.resource.resource_subtype 直接映射
device1 target.resource.resource_subtype 直接映射
device target.resource.type 已映射:(?i)(Desktop/Laptop/Mobile/Phone) → DEVICE
device1 target.resource.type 已映射:(?i)(Desktop/Laptop/Mobile/Phone) → DEVICE
BUSINESSGROUP_NME target.user.department 已合并
email_name target.user.email_addresses 已合并
EMPLOYEE_ID target.user.employee_id 直接映射
Employee_ID target.user.employee_id 直接映射
FIRST_NME target.user.first_name 直接映射
EMPLOYEE_TYPE target.user.group_identifiers 已合并
LAST_NME target.user.last_name 直接映射
JOBTITLE_NME target.user.title 直接映射
title target.user.title 直接映射
target.id target.user.userid 直接映射
不适用 metadata.product_name 常量:WORKDAY_USER_ACTIVITY
不适用 metadata.vendor_name 常量:WORKDAY_USER_ACTIVITY
不适用 target.resource.type 常量:DEVICE

更新日志

查看相应解析器的更新日志

需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。