איסוף יומני פעילות משתמש ב-Workday
במאמר הזה מוסבר איך להטמיע יומני פעילות משתמשים ב-Workday ב-Google Security Operations באמצעות Cloud Storage V2.
Workday היא פלטפורמה מבוססת-ענן לניהול הון אנושי (HCM) ולניהול פיננסי, שיוצרת יומני ביקורת של פעילות משתמשים, אימות ואבטחה. API בארכיטקטורת REST של רישום פעילות משתמש מספק גישה פרוגרמטית ליומני פעילות אלה.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מכונה של Google SecOps
- פרויקט ב- Google Cloud שבו מופעל {storage_api}
- הרשאות ליצירה ולניהול של קטגוריות של Cloud Storage
- הרשאות לניהול כללי מדיניות של ניהול זהויות והרשאות גישה (IAM) בקטגוריות של Cloud Storage
- הרשאות ליצירת שירותי Cloud Run, נושאי Pub/Sub ומשימות ב-Cloud Scheduler
- גישה מורחבת ל-Workday עם הרשאות של אדמין אבטחה או הרשאות שוות ערך
- רישום פעילות המשתמשים מופעל בדייר שלכם ב-Workday
יצירת קטגוריה של Cloud Storage
- נכנסים לGoogle Cloud מסוף.
- בוחרים את הפרויקט או יוצרים פרויקט חדש.
- בתפריט הניווט, נכנסים ל-Cloud Storage > Buckets.
- לוחצים על Create bucket.
ממלאים את פרטי ההגדרה הבאים:
הגדרה ערך Name your bucket מזינים שם ייחודי ברמה גלובלית (לדוגמה, workday-activity-logs)סוג המיקום בוחרים לפי הצרכים (אזור, שני אזורים, מספר אזורים) Location בוחרים את המיקום (לדוגמה, us-central1)סוג אחסון (storage class) רגיל (מומלץ ליומנים שהגישה אליהם תכופה) בקרת גישה אחידה (מומלץ) כלי הגנה אופציונלי: הפעלת ניהול גרסאות של אובייקטים או מדיניות שמירת נתונים לוחצים על יצירה.
איסוף פרטי הכניסה ל-Workday API
הפעלת רישום פעילות המשתמשים ביומן
- נכנסים לדייר ב-Workday כאדמין אבטחה.
- בשורת החיפוש של Workday, מחפשים את המשימה Edit Tenant Setup - System ופותחים אותה.
- בקטע אבטחה, מסמנים את התיבה הפעלת רישום פעילות משתמשים.
- לוחצים על OK (אישור) כדי לשמור את השינויים.
יצירת משתמש במערכת משולבת (ISU)
- בסרגל החיפוש של Workday, מחפשים את האפשרות Create Integration System User (יצירת משתמש במערכת השילוב).
- מזינים שם משתמש (לדוגמה,
ISU_SIEM_Export) וסיסמה חזקה. - מבטלים את הסימון בתיבה דרישה לסיסמה חדשה בכניסה הבאה.
- לוחצים על OK.
- מחפשים את Create Security Group ויוצרים Integration System Security Group (Unconstrained).
- מוסיפים את ה-ISU (
ISU_SIEM_Export) לקבוצת האבטחה הזו. - מחפשים את View Domain (הצגת דומיין) ומאתרים את הדומיין User Activity Logging (רישום פעילות משתמשים ביומן). נותנים גישת Get לקבוצת האבטחה של ה-ISU בדומיין הזה.
- מחפשים את האפשרות Activate Pending Security Policy Changes (הפעלת השינויים במדיניות האבטחה) ומפעילים את השינויים.
רישום לקוח API ל-OAuth
- בסרגל החיפוש של Workday, מחפשים את Register API Client for Integrations.
- מזינים שם לקוח (לדוגמה,
SIEM_OAuth_Client). - בוחרים באפשרות טוקני רענון שאינם פגים.
- מוסיפים את ההיקף: מערכת (או את ההיקף שנדרש ל-User Activity Logging API).
- לוחצים על OK.
- מעתיקים את הפרטים הבאים ושומרים אותם במיקום מאובטח:
- מזהה לקוח: המזהה של לקוח ה-API.
- Client Secret: סוד הלקוח של ה-API.
- מחפשים את האפשרות Manage Refresh Tokens for Integrations (ניהול טוקנים לרענון של שילובים).
- בוחרים את החשבון של ה-ISU (
ISU_SIEM_Export). - יוצרים טוקן רענון חדש ללקוח ה-API.
- מעתיקים ושומרים את טוקן הרענון.
איך מוצאים את כתובת ה-URL של הדייר
נקודת הקצה ל-API מבוססת על הדייר ב-Workday. הפורמט הוא:
| רכיב | ערך |
|---|---|
| נקודת הקצה של הטוקן | https://HOST/ccx/oauth2/TENANT/token |
| Activity Logging API | https://HOST/ccx/api/privacy/v1/TENANT/activityLogging |
אימות ההרשאות
כדי לוודא של-ISU יש את ההרשאות הנדרשות:
- נכנסים ל-Workday כאדמין אבטחה.
- מחפשים את View Integration System User ובוחרים את ה-ISU (
ISU_SIEM_Export). - מוודאים שהמשתמש חבר בקבוצת האבטחה עם גישת Get לדומיין User Activity Logging.
- אם אין גישה, מעדכנים את קבוצת האבטחה ומפעילים את השינויים במדיניות האבטחה.
בדיקת הגישה ל-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.
יצירת חשבון השירות
- במסוף GCP, נכנסים לדף IAM & Admin > Service Accounts.
- לוחצים על Create Service Account.
- מזינים את פרטי ההגדרה הבאים:
- שם חשבון השירות: מזינים
workday-activity-collector-sa. - Service account description: מזינים
Service account for Cloud Run function to collect Workday User Activity logs.
- שם חשבון השירות: מזינים
- לוחצים על יצירה והמשך.
- בקטע Grant this service account access to project, מוסיפים את התפקידים הבאים:
- לוחצים על בחירת תפקיד.
- מחפשים את התפקיד Storage Object Admin ובוחרים אותו.
- לוחצים על + הוספת תפקיד.
- מחפשים את התפקיד Cloud Run Invoker ובוחרים בו.
- לוחצים על + הוספת תפקיד.
- מחפשים את התפקיד Cloud Functions Invoker ובוחרים אותו.
- לוחצים על Continue.
- לוחצים על סיום.
התפקידים האלה נדרשים כדי:
- אדמין של אובייקטים באחסון: כתיבת יומנים בקטגוריה של Cloud Storage וניהול קובצי תמונת מצב
- Cloud Run Invoker: מאפשר ל-Pub/Sub להפעיל את הפונקציה
- מפעיל פונקציות של Cloud Functions: מאפשר להפעיל פונקציות
הקצאת הרשאות IAM בקטגוריה של Cloud Storage
נותנים לחשבון השירות הרשאות כתיבה בקטגוריה של Cloud Storage:
- נכנסים לדף Cloud Storage > Buckets.
- לוחצים על שם הקטגוריה (לדוגמה,
workday-activity-logs). - עוברים לכרטיסייה Permissions.
- לוחצים על הענקת גישה.
- מזינים את פרטי ההגדרה הבאים:
- הוספת חשבונות משתמשים: מזינים את כתובת האימייל של חשבון השירות (לדוגמה,
workday-activity-collector-sa@your-project.iam.gserviceaccount.com). - הקצאת תפקידים: בוחרים באפשרות אדמין של אובייקטים באחסון.
- הוספת חשבונות משתמשים: מזינים את כתובת האימייל של חשבון השירות (לדוגמה,
- לוחצים על Save.
יוצרים נושא Pub/Sub
יוצרים את נושא Pub/Sub שאליו Cloud Scheduler יפרסם ואליו פונקציית Cloud Run תירשם.
- במסוף GCP, נכנסים לדף Pub/Sub > Topics.
- לוחצים על Create topic.
- מזינים את פרטי ההגדרה הבאים:
- מזהה הנושא: מזינים את הערך
workday-activity-trigger. - משאירים את ההגדרות האחרות כברירת מחדל.
- מזהה הנושא: מזינים את הערך
- לוחצים על יצירה.
יצירת פונקציית Cloud Run לאיסוף יומנים
הודעות Pub/Sub מ-Cloud Scheduler יפעילו את פונקציית Cloud Run כדי לאחזר יומני פעילות משתמש מ-Workday User Activity Logging API ולכתוב אותם ב-Cloud Storage.
- במסוף GCP, נכנסים ל-Cloud Run.
- לוחצים על כתיבת פונקציה.
בקטע Configure, מזינים את פרטי ההגדרה הבאים:
הגדרה ערך שם השירות workday-activity-collectorאזור בוחרים את האזור שתואם לקטגוריה של Cloud Storage (לדוגמה, us-central1)זמן ריצה בוחרים באפשרות Python 3.12 או גרסה עדכנית יותר. בקטע Trigger, לוחצים על Add trigger ובוחרים באפשרות Pub/Sub trigger.
בחלונית Eventarc trigger, מזינים את פרטי ההגדרה הבאים:
- שם הטריגר: משאירים את השם שנוצר או מזינים שם לטריגר.
- סוג הטריגר: בוחרים באפשרות מקורות של Google.
- Event provider: בוחרים באפשרות Pub/Sub.
- סוג האירוע: בוחרים באפשרות google.cloud.pubsub.topic.v1.messagePublished.
- Select a Cloud Pub/Sub topic: בוחרים את הנושא
workday-activity-trigger. - Region: בוחרים את אותו אזור כמו של הפונקציה.
- חשבון שירות: בוחרים את חשבון השירות
workday-activity-collector-sa.
לוחצים על Save trigger.
בקטע אימות:
- לוחצים על דרישת אימות.
- בוחרים באפשרות ניהול זהויות והרשאות גישה (IAM).
עוברים לקטע Containers, Networking, Security ומרחיבים אותו.
עוברים לכרטיסייה אבטחה:
- חשבון שירות: בוחרים את חשבון השירות
workday-activity-collector-sa.
- חשבון שירות: בוחרים את חשבון השירות
עוברים לכרטיסייה מאגרי תגים:
- לוחצים על Variables & Secrets.
- לוחצים על + Add variable לכל משתנה סביבה:
שם משתנה ערך לדוגמה תיאור GCS_BUCKETworkday-activity-logsשם הקטגוריה של Cloud Storage GCS_PREFIXworkdayקידומת לקובצי יומן STATE_KEYworkday-state.jsonנתיב המצב, מחוץ לקידומת היומן WORKDAY_HOSTyour-workday-hostשם המארח של Workday WORKDAY_TENANTyour-tenantשם הדייר ב-Workday CLIENT_IDyour-client-idמזהה לקוח ב-OAuth CLIENT_SECRETyour-client-secretסוד לקוח OAuth REFRESH_TOKENyour-refresh-tokenטוקן רענון של OAuth MAX_RECORDS10000מספר הרשומות המקסימלי לכל הרצה PAGE_SIZE100רשומות בכל דף LOOKBACK_HOURS24תקופת המבט לאחור הראשונית בכרטיסייה Variables & Secrets, עוברים אל Requests:
- Request timeout: מזינים
600שניות (10 דקות).
- Request timeout: מזינים
עוברים לכרטיסייה הגדרות בקטע מאגרים:
- בקטע Resources:
- זיכרון: בוחרים באפשרות 512 MiB או יותר.
- מעבד (CPU): בוחרים באפשרות 1.
- בקטע Resources:
בקטע Revision scaling:
- מספר מינימלי של מכונות: מזינים
0. - Maximum number of instances: מזינים
100(או משנים בהתאם לעומס הצפוי).
- מספר מינימלי של מכונות: מזינים
לוחצים על יצירה.
ממתינים ליצירת השירות (דקה או שתיים).
אחרי שיוצרים את השירות, עורך הקוד המוטבע נפתח באופן אוטומטי.
הוספת קוד הפונקציה
- מזינים main בשדה Function entry point.
בעורך הקוד, יוצרים שני קבצים:
הקובץ הראשון – 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
לוחצים על Deploy כדי לשמור ולפרוס את הפונקציה.
מחכים שהפריסה תסתיים (2-3 דקות).
יצירת משימה ב-Cloud Scheduler
Cloud Scheduler מפרסם הודעות בנושא Pub/Sub במרווחי זמן קבועים, ומפעיל את פונקציית Cloud Run.
- במסוף GCP, נכנסים ל-Cloud Scheduler.
- לוחצים על Create Job.
ממלאים את פרטי ההגדרה הבאים:
הגדרה ערך שם workday-activity-collector-hourlyאזור בוחרים את אותו אזור כמו של פונקציית Cloud Run. תדירות 0 * * * *(כל שעה, בשעה עגולה)אזור זמן בחירת אזור זמן (מומלץ לבחור ב-UTC) סוג היעד Pub/Sub נושא בוחרים את הנושא workday-activity-triggerגוף ההודעה {}(אובייקט JSON ריק)לוחצים על יצירה.
אפשרויות לתדירות התזמון
בוחרים את התדירות בהתאם לנפח היומן ולדרישות לגבי זמן האחזור:
| תדירות | ביטוי Cron | תרחיש לדוגמה |
|---|---|---|
| כל 5 דקות | */5 * * * * |
נפח גבוה, זמן אחזור נמוך |
| כל 15 דקות | */15 * * * * |
נפח חיפושים בינוני |
| כל שעה | 0 * * * * |
רגיל (מומלץ) |
| כל 6 שעות | 0 */6 * * * |
נפח נמוך, עיבוד ברצף (batch processing) |
| יומי | 0 0 * * * |
איסוף נתונים היסטוריים |
בדיקת השילוב
- במסוף Cloud Scheduler, מוצאים את המשימה (
workday-activity-collector-hourly). - לוחצים על הפעלה ידנית כדי להפעיל את המשימה באופן ידני.
- מחכים כמה שניות ועוברים אל Cloud Run > Services > workday-activity-collector > Logs.
מוודאים שהפונקציה בוצעה בהצלחה. חפשו את:
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בודקים את הקטגוריה של Cloud Storage (
workday-activity-logs) כדי לוודא שהיומנים נכתבו.
אם מופיעות שגיאות ביומנים:
- HTTP 401: בודקים את פרטי הכניסה של OAuth במשתני הסביבה
- HTTP 403: צריך לוודא של-ISU יש את ההרשאות הנדרשות לדומיין של רישום פעילות המשתמשים ביומן
- HTTP 429: הגבלת קצב של יצירת בקשות – הפונקציה תנסה שוב באופן אוטומטי עם השהיה (backoff)
- לא הצלחנו לקבל טוקן גישה: צריך לוודא שהערכים של
WORKDAY_HOST,WORKDAY_TENANT,CLIENT_ID,CLIENT_SECRETו-REFRESH_TOKENנכונים
הגדרת פיד ב-Google SecOps כדי להטמיע יומני פעילות משתמשים ב-Workday
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
Workday User Activity Logs). - בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
- בוחרים באפשרות Workday User Activity בתור Log type.
לוחצים על Get Service Account (קבלת חשבון שירות). תוצג כתובת אימייל ייחודית של חשבון שירות, לדוגמה:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comמעתיקים את כתובת האימייל הזו. תצטרכו להשתמש בו בשלב הבא.
לוחצים על הבא.
מציינים ערכים לפרמטרים הבאים של הקלט:
כתובת ה-URL של קטגוריית האחסון: מזינים את ה-URI של קטגוריית Cloud Storage עם נתיב הקידומת:
gs://workday-activity-logs/workday/- מחליפים את:
-
workday-activity-logs: השם של הקטגוריה ב-Cloud Storage. -
workday: קידומת או נתיב אופציונליים שבהם נשמרים היומנים (משאירים ריק עבור root).
-
- מחליפים את:
אפשרות מחיקת המקור: בוחרים את אפשרות המחיקה המועדפת:
- אף פעם לא למחוק קבצים: אף פעם לא למחוק קבצים מהמקור (מומלץ לבדיקה).
- Delete transferred files and empty directories: מחיקת קבצים וספריות ריקות מהמקור אחרי שהאחזור הושלם בהצלחה.
גיל הקובץ המקסימלי: כולל קבצים ששונו במספר הימים האחרונים (ברירת המחדל היא 180 ימים).
מרחב השמות של הנכס: מרחב השמות של הנכס.
תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.
לוחצים על הבא.
בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.
מתן הרשאות IAM לחשבון השירות של Google SecOps
לחשבון השירות של Google SecOps נדרשים שני תפקידים בקטגוריה של Cloud Storage: צפייה באובייקט אחסון כדי לקרוא את אובייקטי היומן, ותפקיד ברמת הקטגוריה כדי לקרוא את המטא-נתונים של הקטגוריה.
- נכנסים לדף Cloud Storage > Buckets.
- לוחצים על שם הקטגוריה (
workday-activity-logs). - עוברים לכרטיסייה Permissions.
- לוחצים על הענקת גישה.
- מזינים את פרטי ההגדרה הבאים:
- הוספת חשבונות משתמשים: מדביקים את כתובת האימייל של חשבון השירות של Google SecOps.
- הקצאת תפקידים: בוחרים את שני התפקידים הבאים:
- צפייה באובייקטים של אחסון: קריאת אובייקטים של יומנים.
- קריאה בקטגוריה באחסון מדור קודם: קריאת המטא-נתונים של הקטגוריה. אם בחרתם באפשרות המחיקה Delete transferred files and empty directories, בחרו במקום זאת באפשרות Storage Legacy Bucket Writer, שגם מעניקה את הרשאת המחיקה.
לוחצים על Save.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
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.