איסוף יומנים של Cisco Secure Endpoint

גרסת המנתח: 6.0

נתמך ב:

במסמך הזה מוסבר איך להטמיע יומנים של Cisco Secure Endpoint ב-Google Security Operations באמצעות Google Cloud Storage. ‫Cisco Secure Endpoint (לשעבר AMP for Endpoints) הוא פתרון אבטחה מבוסס-ענן לנקודות קצה, שמספק מניעה, זיהוי ותגובה מתקדמים לאיומים בנקודות קצה. המנתח ממיר יומנים גולמיים בפורמט JSON לפורמט מובנה שתואם ל-UDM, מחלץ שדות מאובייקטים של JSON בתצוגת עץ, ממפה אותם לסכימת ה-UDM, מזהה קטגוריות של אירועים, מקצה רמות חומרה ויוצר פלט אירועים מאוחד, ומסמן התראות אבטחה כשמתקיימים תנאים ספציפיים.

לפני שמתחילים

ודאו שיש לכם את הדרישות המוקדמות הבאות:

  • מכונה של Google SecOps
  • פרויקט ב-GCP שבו מופעל Cloud Storage API
  • הרשאות ליצירה ולניהול של קטגוריות ב-GCS
  • הרשאות לניהול מדיניות IAM בקטגוריות של GCS
  • הרשאות ליצירת שירותי Cloud Run, נושאי Pub/Sub ומשימות ב-Cloud Scheduler
  • גישה מורשית למסוף Cisco Secure Endpoint עם הרשאות אדמין

איסוף פרטי הכניסה ל-Cisco Secure Endpoint API

  1. נכנסים למסוף Cisco Secure Endpoint.
  2. עוברים אל חשבונות > הגדרות הארגון.
  3. בקטע Features, לוחצים על Configure API Credentials כדי ליצור את מזהה הלקוח ואת מפתח ה-API.
  4. לוחצים על New API Credential (פרטי כניסה חדשים ל-API).
  5. מזינים את פרטי ההגדרה הבאים:
    • שם האפליקציה: מזינים שם (לדוגמה, Chronicle SecOps Integration).
    • היקף: בוחרים באפשרות לקריאה בלבד כדי לבצע סקר אירועים בסיסי.
  6. לוחצים על יצירה.
  7. מעתיקים ושומרים במקום מאובטח את הפרטים הבאים:

    • מזהה לקוח API
    • מפתח API
  8. מגדירים את כתובת ה-URL הבסיסית של ה-API בהתאם לאזור:

    אזור כתובת ה-URL הבסיסית של ה-API
    צפון אמריקה https://api.amp.cisco.com
    אירופה https://api.eu.amp.cisco.com
    אסיה והאוקיינוס השקט, יפן וסין https://api.apjc.amp.cisco.com

אימות ההרשאות

כדי לוודא שלחשבון יש את ההרשאות הנדרשות:

  1. נכנסים למסוף Cisco Secure Endpoint.
  2. עוברים אל חשבונות > הגדרות הארגון.
  3. אם האפשרות Configure API Credentials (הגדרת פרטי כניסה ל-API) מופיעה בקטע Features (תכונות), יש לכם את ההרשאות הנדרשות.
  4. אם האפשרות הזו לא מופיעה, פנו לאדמין כדי לקבל הרשאות גישה של אדמין.

בדיקת הגישה ל-API

  • לפני שממשיכים בתהליך השילוב, בודקים את פרטי הכניסה:

    # Replace with your actual credentials
    AMP_CLIENT_ID="your-client-id"
    AMP_API_KEY="your-api-key"
    API_BASE="https://api.amp.cisco.com"
    
    # Test API access
    curl -v -u "${AMP_CLIENT_ID}:${AMP_API_KEY}" "${API_BASE}/v1/events?limit=1"
    

תגובה מוצלחת מחזירה את קוד הסטטוס HTTP 200 עם גוף JSON שמכיל מערך של אובייקטים של אירועים.

יצירת קטגוריה של Google Cloud Storage

  1. נכנסים למסוף Google Cloud.
  2. בוחרים את הפרויקט או יוצרים פרויקט חדש.
  3. בתפריט הניווט, נכנסים ל-Cloud Storage > Buckets.
  4. לוחצים על Create bucket.
  5. ממלאים את פרטי ההגדרה הבאים:

    הגדרה ערך
    Name your bucket מזינים שם ייחודי ברמה גלובלית (לדוגמה, cisco-amp-logs)
    סוג המיקום בוחרים לפי הצרכים (אזור, שני אזורים, מספר אזורים)
    Location בוחרים את המיקום (לדוגמה, us-central1)
    סוג אחסון (storage class) רגיל (מומלץ ליומנים שהגישה אליהם תכופה)
    בקרת גישה אחידה (מומלץ)
    כלי הגנה אופציונלי: הפעלת ניהול גרסאות של אובייקטים או מדיניות שמירת נתונים
  6. לוחצים על יצירה.

יצירת חשבון שירות לפונקציית Cloud Run

לפונקציית Cloud Run נדרש חשבון שירות עם הרשאות כתיבה בקטגוריית GCS, וצריך להפעיל אותה באמצעות Pub/Sub.

יצירת חשבון שירות

  1. במסוף GCP, נכנסים לדף IAM & Admin > Service Accounts.
  2. לוחצים על Create Service Account.
  3. מזינים את פרטי ההגדרה הבאים:
    • שם חשבון השירות: מזינים cisco-amp-collector-sa.
    • Service account description: מזינים Service account for Cloud Run function to collect Cisco Secure Endpoint logs.
  4. לוחצים על יצירה והמשך.
  5. בקטע Grant this service account access to project, מוסיפים את התפקידים הבאים:
    1. לוחצים על בחירת תפקיד.
    2. מחפשים את התפקיד Storage Object Admin ובוחרים אותו.
    3. לוחצים על + הוספת תפקיד.
    4. מחפשים את התפקיד Cloud Run Invoker ובוחרים בו.
    5. לוחצים על + הוספת תפקיד.
    6. מחפשים את התפקיד Cloud Functions Invoker ובוחרים אותו.
  6. לוחצים על Continue.
  7. לוחצים על סיום.

התפקידים האלה נדרשים כדי:

  • אדמין של אובייקט אחסון: כתיבת יומנים לקטגוריית GCS וניהול קובצי תמונת מצב
  • Cloud Run Invoker: מאפשר ל-Pub/Sub להפעיל את הפונקציה
  • מפעיל פונקציות של Cloud Functions: מאפשר להפעיל פונקציות

הענקת הרשאות IAM בקטגוריית GCS

נותנים לחשבון השירות (cisco-amp-collector-sa) הרשאות כתיבה בקטגוריה של GCS:

  1. נכנסים לדף Cloud Storage > Buckets.
  2. לוחצים על שם הקטגוריה.
  3. עוברים לכרטיסייה Permissions.
  4. לוחצים על הענקת גישה.
  5. מזינים את פרטי ההגדרה הבאים:
    • הוספת חשבונות משתמשים: מזינים את כתובת האימייל של חשבון השירות (לדוגמה, cisco-amp-collector-sa@PROJECT_ID.iam.gserviceaccount.com).
    • הקצאת תפקידים: בוחרים באפשרות אדמין של אובייקטים באחסון.
  6. לוחצים על Save.

יצירת נושא Pub/Sub

יוצרים נושא Pub/Sub ש-Cloud Scheduler יפרסם בו ופונקציית Cloud Run תירשם אליו.

  1. במסוף GCP, נכנסים לדף Pub/Sub > Topics.
  2. לוחצים על Create topic.
  3. מזינים את פרטי ההגדרה הבאים:
    • מזהה הנושא: מזינים את הערך cisco-amp-events-trigger.
    • משאירים את ההגדרות האחרות כברירת מחדל.
  4. לוחצים על יצירה.

יצירת פונקציית Cloud Run לאיסוף יומנים

הודעות Pub/Sub מ-Cloud Scheduler יפעילו את פונקציית Cloud Run כדי לאחזר יומנים מ-Cisco Secure Endpoint API ולכתוב אותם ב-GCS.

  1. במסוף GCP, נכנסים ל-Cloud Run.
  2. לוחצים על Create service.
  3. בוחרים באפשרות Function (שימוש בעורך ישיר כדי ליצור פונקציה).
  4. בקטע Configure, מזינים את פרטי ההגדרה הבאים:

    הגדרה ערך
    שם השירות cisco-amp-events-collector
    אזור בוחרים את האזור שתואם לקטגוריית ה-GCS (לדוגמה, us-central1)
    זמן ריצה בוחרים באפשרות Python 3.12 או גרסה עדכנית יותר.
  5. בקטע טריגר (אופציונלי):

    1. לוחצים על + הוספת טריגר.
    2. בוחרים באפשרות Cloud Pub/Sub.
    3. בקטע Select a Cloud Pub/Sub topic, בוחרים את הנושא ב-Pub/Sub‏ (cisco-amp-events-trigger).
    4. לוחצים על Save.
  6. בקטע אימות:

    1. לוחצים על דרישת אימות.
    2. בודקים את ניהול הזהויות והרשאות הגישה (IAM).
  7. גוללים למטה ומרחיבים את הקטע Containers, Networking, Security.

  8. עוברים לכרטיסייה אבטחה:

    • ‫Service account: בוחרים את חשבון השירות (cisco-amp-collector-sa).
  9. עוברים לכרטיסייה מאגרי תגים:

    1. לוחצים על Variables & Secrets.
    2. לוחצים על ‎+ Add variable לכל משתנה סביבה:
    שם משתנה ערך לדוגמה תיאור
    GCS_BUCKET cisco-amp-logs שם הקטגוריה ב-GCS
    GCS_PREFIX cisco-amp-events/ קידומת לקובצי יומן
    STATE_KEY cisco-amp-events/state.json נתיב קובץ תמונת המצב
    API_BASE https://api.amp.cisco.com כתובת ה-URL הבסיסית של ה-API
    AMP_CLIENT_ID your-client-id מזהה לקוח API
    AMP_API_KEY your-api-key מפתח API
    PAGE_SIZE 500 רשומות בכל דף
    MAX_PAGES 10 מספר הדפים המקסימלי לאחזור
  10. בקטע Variables & Secrets, גוללים למטה אל Requests:

    • ‫Request timeout: מזינים 600 שניות (10 דקות).
  11. עוברים לכרטיסייה הגדרות:

    • בקטע Resources:
      • זיכרון: בוחרים באפשרות ‎512 MiB או יותר.
      • מעבד (CPU): בוחרים באפשרות 1.
  12. בקטע Revision scaling:

    • מספר מינימלי של מכונות: מזינים 0.
    • Maximum number of instances: מזינים 100 (או משנים בהתאם לעומס הצפוי).
  13. לוחצים על יצירה.

  14. ממתינים ליצירת השירות (דקה או שתיים).

  15. אחרי שיוצרים את השירות, עורך הקוד המוטבע נפתח באופן אוטומטי.

הוספת קוד פונקציה

  1. בשדה Entry point, מזינים 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 base64
    
    # 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', 'cisco-amp-events/')
    STATE_KEY = os.environ.get('STATE_KEY', 'cisco-amp-events/state.json')
    API_BASE = os.environ.get('API_BASE')
    AMP_CLIENT_ID = os.environ.get('AMP_CLIENT_ID')
    AMP_API_KEY = os.environ.get('AMP_API_KEY')
    PAGE_SIZE = int(os.environ.get('PAGE_SIZE', '500'))
    MAX_PAGES = int(os.environ.get('MAX_PAGES', '10'))
    
    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)
    
    @functions_framework.cloud_event
    def main(cloud_event):
        """
        Cloud Run function triggered by Pub/Sub to fetch Cisco Secure Endpoint events and write to GCS.
    
        Args:
            cloud_event: CloudEvent object containing Pub/Sub message
        """
    
        if not all([GCS_BUCKET, API_BASE, AMP_CLIENT_ID, AMP_API_KEY]):
            print('Error: Missing required environment variables')
            return
    
        try:
            # Get GCS bucket
            bucket = storage_client.bucket(GCS_BUCKET)
    
            # Load state
            state = load_state(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"])
                    # Overlap by 2 minutes to catch any delayed events
                    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(days=1)
    
            print(f"Fetching logs from {last_time.isoformat()} to {now.isoformat()}")
    
            # Fetch logs
            records, newest_event_time = fetch_logs(
                api_base=API_BASE,
                client_id=AMP_CLIENT_ID,
                api_key=AMP_API_KEY,
                start_time=last_time,
                page_size=PAGE_SIZE,
                max_pages=MAX_PAGES,
            )
    
            if not records:
                print("No new log records found.")
                save_state(bucket, STATE_KEY, now.isoformat())
                return
    
            # Write to GCS as NDJSON
            timestamp = now.strftime('%Y%m%d_%H%M%S')
            object_key = f"{GCS_PREFIX}cisco_amp_events_{timestamp}.ndjson"
            blob = bucket.blob(object_key)
    
            ndjson = '\n'.join([json.dumps(record, ensure_ascii=False) for record 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}")
    
            # Update state with newest event time
            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(records)} 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}")
    
        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}")
    
    def fetch_logs(api_base: str, client_id: str, api_key: str, start_time: datetime, page_size: int, max_pages: int):
        """
        Fetch logs from Cisco Secure Endpoint v1 API with pagination and rate limiting.
    
        Args:
            api_base: API base URL
            client_id: API client ID
            api_key: API key
            start_time: Start time for log query
            page_size: Number of records per page
            max_pages: Maximum total pages to fetch
    
        Returns:
            Tuple of (records list, newest_event_time ISO string)
        """
        # Clean up base URL
        base_url = api_base.rstrip('/')
    
        endpoint = f"{base_url}/v1/events"
    
        # Create Basic Auth header
        auth_string = f"{client_id}:{api_key}"
        auth_bytes = auth_string.encode('utf-8')
        auth_b64 = base64.b64encode(auth_bytes).decode('utf-8')
    
        headers = {
            'Authorization': f'Basic {auth_b64}',
            'Accept': 'application/json',
            'Accept-Encoding': 'gzip',
            'User-Agent': 'GoogleSecOps-CiscoAMPCollector/1.0'
        }
    
        records = []
        newest_time = None
        page_num = 0
        backoff = 1.0
    
        # Build initial URL with start_date parameter
        start_date_str = start_time.isoformat()
        if not start_date_str.endswith('Z'):
            start_date_str = start_date_str + 'Z' if start_date_str.endswith('+00:00') is False else start_date_str.replace('+00:00', 'Z')
        next_url = f"{endpoint}?limit={page_size}&start_date={start_date_str}"
    
        while next_url and page_num < max_pages:
            page_num += 1
    
            try:
                response = http.request('GET', next_url, headers=headers)
    
                # Handle rate limiting with exponential backoff
                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[:256]}")
                    return [], None
    
                data = json.loads(response.data.decode('utf-8'))
    
                # Extract events from response
                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('date')
                        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 for next page URL in metadata
                next_url = data.get('metadata', {}).get('links', {}).get('next')
    
                if not next_url:
                    print("No more pages (no next URL)")
                    break
    
            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. לוחצים על Deploy כדי לשמור ולפרוס את הפונקציה.

  4. מחכים שהפריסה תסתיים (2-3 דקות).

יצירת משימה ב-Cloud Scheduler

‫Cloud Scheduler יפרסם הודעות בנושא Pub/Sub במרווחי זמן קבועים, ויפעיל את פונקציית Cloud Run.

  1. במסוף GCP, נכנסים ל-Cloud Scheduler.
  2. לוחצים על Create Job.
  3. ממלאים את פרטי ההגדרה הבאים:

    הגדרה ערך
    שם cisco-amp-events-collector-hourly
    אזור בוחרים את אותו אזור כמו של פונקציית Cloud Run.
    תדירות ‫0 * * * * (כל שעה, בשעה עגולה)
    אזור זמן בחירת אזור זמן (מומלץ לבחור ב-UTC)
    סוג היעד Pub/Sub
    נושא בוחרים את נושא Pub/Sub (cisco-amp-events-trigger)
    גוף ההודעה ‫{} (אובייקט JSON ריק)
  4. לוחצים על יצירה.

אפשרויות לתדירות התזמון

בוחרים את התדירות בהתאם לנפח היומן ולדרישות לגבי זמן האחזור:

תדירות ביטוי Cron תרחיש לדוגמה
כל 5 דקות */5 * * * * נפח גבוה, זמן אחזור נמוך
כל 15 דקות */15 * * * * נפח חיפושים בינוני
כל שעה 0 * * * * רגיל (מומלץ)
כל 6 שעות 0 */6 * * * נפח נמוך, עיבוד ברצף (batch processing)
יומי 0 0 * * * איסוף נתונים היסטוריים

בדיקת השילוב

  1. במסוף Cloud Scheduler, מוצאים את המשימה.
  2. לוחצים על Force run כדי להפעיל את המשימה באופן ידני.
  3. מחכים כמה שניות.
  4. נכנסים לדף Cloud Run > Services.
  5. לוחצים על שם הפונקציה (cisco-amp-events-collector).
  6. לוחצים על הכרטיסייה Logs.
  7. מוודאים שהפונקציה בוצעה בהצלחה. חפשו את:

    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://cisco-amp-logs/cisco-amp-events/cisco_amp_events_YYYYMMDD_HHMMSS.ndjson
    Successfully processed X records
    
  8. נכנסים לדף Cloud Storage > Buckets.

  9. לוחצים על שם הקטגוריה.

  10. עוברים לתיקיית הקידומת (cisco-amp-events/).

  11. מוודאים שנוצר קובץ .ndjson חדש עם חותמת הזמן הנוכחית.

אם מופיעות שגיאות ביומנים:

  • ‫HTTP 401: בודקים את פרטי הכניסה ל-API במשתני הסביבה
  • ‫HTTP 403: מוודאים שלחשבון יש את ההרשאות הנדרשות
  • ‫HTTP 429: הגבלת קצב של יצירת בקשות – הפונקציה תנסה שוב באופן אוטומטי עם השהיה (backoff)
  • חסרים משתני סביבה: צריך לוודא שכל המשתנים הנדרשים מוגדרים

אחזור של חשבון השירות של Google SecOps

מערכת Google SecOps משתמשת בחשבון שירות ייחודי כדי לקרוא נתונים מהקטגוריה שלכם ב-GCS. אתם צריכים לתת לחשבון השירות הזה גישה לקטגוריה שלכם.

הגדרת פיד ב-Google SecOps כדי להטמיע יומנים של Cisco Secure Endpoint

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. לוחצים על הגדרת פיד יחיד.
  4. בשדה שם הפיד, מזינים שם לפיד (לדוגמה, Cisco Secure Endpoint logs).
  5. בוחרים באפשרות Google Cloud Storage V2 בתור סוג המקור.
  6. בוחרים באפשרות Cisco AMP בתור סוג היומן.
  7. לוחצים על Get Service Account (קבלת חשבון שירות). תוצג כתובת אימייל ייחודית של חשבון שירות, לדוגמה:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. מעתיקים את כתובת האימייל הזו. תצטרכו אותו בשלב הבא.

  9. לוחצים על הבא.

  10. מציינים ערכים לפרמטרים הבאים של הקלט:

    • כתובת ה-URL של קטגוריית האחסון: מזינים את ה-URI של קטגוריית GCS עם נתיב הקידומת:

      gs://cisco-amp-logs/cisco-amp-events/
      
      • מחליפים את:
        • ‫cisco-amp-logs: השם של קטגוריית GCS.
        • ‫cisco-amp-events/: נתיב הקידומת או התיקייה שבהם נשמרים היומנים.
    • אפשרות מחיקת המקור: בוחרים את אפשרות המחיקה המועדפת:

      • Never: אף פעם לא למחוק קבצים אחרי העברות (מומלץ לבדיקה).
      • מחיקת קבצים שהועברו: מחיקת קבצים אחרי שהם הועברו בהצלחה.
      • מחיקת קבצים שהועברו וספריות ריקות: מחיקת קבצים וספריות ריקות אחרי שההעברה מסתיימת.
    • גיל הקובץ המקסימלי: כולל קבצים ששונו במספר הימים האחרונים. ברירת המחדל היא 180 ימים.

    • מרחב השמות של הנכס: מרחב השמות של הנכס.

    • תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.

  11. לוחצים על הבא.

  12. בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.

מתן הרשאות IAM לחשבון השירות של Google SecOps

לחשבון השירות של Google SecOps צריך להיות התפקיד צפייה באובייקט אחסון בקטגוריה של GCS.

  1. נכנסים לדף Cloud Storage > Buckets.
  2. לוחצים על שם הקטגוריה.
  3. עוברים לכרטיסייה Permissions.
  4. לוחצים על הענקת גישה.
  5. מזינים את פרטי ההגדרה הבאים:
    • הוספת חשבונות משתמשים: מדביקים את כתובת האימייל של חשבון השירות של Google SecOps.
    • הקצאת תפקידים: בוחרים באפשרות צפייה באובייקטים באחסון.
  6. לוחצים על Save.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
פעיל read_only_udm.principal.asset.active הערך של computer.active מהיומן הגולמי ממופה לשדה principal.asset.active.
connector_guid read_only_udm.principal.asset.uuid הערך של computer.connector_guid מהיומן הגולמי ממופה לשדה principal.asset.uuid.
תאריך read_only_udm.metadata.event_timestamp.seconds הערך של date מהיומן הגולמי מומר לחותמת זמן וממופה לשדה metadata.event_timestamp.seconds.
זיהוי read_only_udm.security_result.threat_name הערך של detection מהיומן הגולמי ממופה לשדה security_result.threat_name.
detection_id read_only_udm.security_result.detection_fields.value הערך של detection_id מהיומן הגולמי ממופה אל security_result.detection_fields עם המפתח "Detection ID".
error.error_code read_only_udm.security_result.detection_fields.value הערך של error.error_code מהיומן הגולמי ממופה אל security_result.detection_fields עם המפתח "קוד שגיאה".
error.description read_only_udm.security_result.detection_fields.value הערך של error.description מהיומן הגולמי ממופה אל security_result.detection_fields עם המפתח "Error Description".
event_type read_only_udm.metadata.product_event_type הערך של event_type מהיומן הגולמי ממופה לשדה metadata.product_event_type.
event_type_id read_only_udm.metadata.product_log_id הערך של event_type_id מהיומן הגולמי ממופה לשדה metadata.product_log_id.
external_ip read_only_udm.principal.asset.external_ip הערך של computer.external_ip מהיומן הגולמי ממופה לשדה principal.asset.external_ip.
file.disposition read_only_udm.security_result.description הערך של file.disposition מהיומן הגולמי ממופה לשדה security_result.description.
file.file_name read_only_udm.target.file.names הערך של file.file_name מהיומן הגולמי ממופה לשדה target.file.names.
file.file_path read_only_udm.target.file.full_path הערך של file.file_path מהיומן הגולמי ממופה לשדה target.file.full_path.
file.identity.md5 read_only_udm.target.file.md5 הערך של file.identity.md5 מהיומן הגולמי ממופה לשדה target.file.md5.
file.identity.sha1 read_only_udm.target.file.sha1 הערך של file.identity.sha1 מהיומן הגולמי ממופה לשדה target.file.sha1.
file.identity.sha256 read_only_udm.target.file.sha256 הערך של file.identity.sha256 מהיומן הגולמי ממופה לשדה target.file.sha256.
file.parent.disposition read_only_udm.target.resource.attribute.labels.value הערך של file.parent.disposition מהיומן הגולמי ממופה אל target.resource.attribute.labels עם המפתח "Parent Disposition".
file.parent.file_name read_only_udm.target.resource.attribute.labels.value הערך של file.parent.file_name מהיומן הגולמי ממופה אל target.resource.attribute.labels עם המפתח "Parent File Name".
file.parent.identity.md5 read_only_udm.target.resource.attribute.labels.value הערך של file.parent.identity.md5 מהיומן הגולמי ממופה אל target.resource.attribute.labels עם המפתח "Parent MD5".
file.parent.identity.sha1 read_only_udm.target.resource.attribute.labels.value הערך של file.parent.identity.sha1 מהיומן הגולמי ממופה אל target.resource.attribute.labels עם המפתח "Parent SHA1".
file.parent.identity.sha256 read_only_udm.target.resource.attribute.labels.value הערך של file.parent.identity.sha256 מהיומן הגולמי ממופה אל target.resource.attribute.labels עם המפתח "Parent SHA256".
file.parent.process_id read_only_udm.target.process.parent_process.pid הערך של file.parent.process_id מהיומן הגולמי ממופה לשדה target.process.parent_process.pid.
שם המארח read_only_udm.principal.asset.hostname הערך של computer.hostname מהיומן הגולמי ממופה לשדה principal.asset.hostname.
ip read_only_udm.principal.ip הערך של computer.network_addresses.ip מהיומן הגולמי ממופה לשדה principal.ip.
mac read_only_udm.principal.mac הערך של computer.network_addresses.mac מהיומן הגולמי ממופה לשדה principal.mac.
severity read_only_udm.security_result.severity הערך של severity מהיומן הגולמי קובע את הערך. אם הערך הוא "Medium", מגדירים אותו כ-"MEDIUM". אם רמת החומרה היא "גבוהה" או "קריטית", מגדירים אותה כ-"HIGH". אם הערך הוא "Low", מגדירים אותו כ-"LOW". אחרת, הערך הוא "UNKNOWN_SEVERITY".
חותמת זמן read_only_udm.metadata.event_timestamp.seconds הערך של timestamp מהיומן הגולמי מומר לחותמת זמן וממופה לשדה metadata.event_timestamp.seconds.
משתמש read_only_udm.target.user.user_display_name הערך של computer.user מהיומן הגולמי ממופה לשדה target.user.user_display_name.
vulnerabilities.cve read_only_udm.extensions.vulns.vulnerabilities.cve_id הערך של vulnerabilities.cve מהיומן הגולמי ממופה לשדה extensions.vulns.vulnerabilities.cve_id.
vulnerabilities.name read_only_udm.extensions.vulns.vulnerabilities.name הערך של vulnerabilities.name מהיומן הגולמי ממופה לשדה extensions.vulns.vulnerabilities.name.
vulnerabilities.score read_only_udm.extensions.vulns.vulnerabilities.cvss_base_score הערך של vulnerabilities.score מהיומן הגולמי מומר ל-float וממופה לשדה extensions.vulns.vulnerabilities.cvss_base_score.
vulnerabilities.url read_only_udm.extensions.vulns.vulnerabilities.vendor_knowledge_base_article_id הערך של vulnerabilities.url מהיומן הגולמי ממופה לשדה extensions.vulns.vulnerabilities.vendor_knowledge_base_article_id.
vulnerabilities.version read_only_udm.extensions.vulns.vulnerabilities.cvss_version הערך של vulnerabilities.version מהיומן הגולמי ממופה לשדה extensions.vulns.vulnerabilities.cvss_version.
לא רלוונטי read_only_udm.metadata.event_type צריך להגדיר את הערך "SCAN_FILE" אם הערך של event_type הוא אחד מהבאים: "Executed malware",‏ "Threat Detected",‏ "Potential Dropper Infection",‏ "Cloud Recall Detection",‏ "Malicious Activity Detection",‏ "Exploit Prevention",‏ "Multiple Infected Files",‏ "Cloud IOC",‏ "System Process Protection",‏ "Vulnerable Application Detected",‏ "Threat Quarantined",‏ "Execution Blocked",‏ "Cloud Recall Quarantine Successful",‏ "Cloud Recall Restore from Quarantine Failed",‏ "Cloud Recall Quarantine Attempt Failed",‏ "Quarantine Failure", או אם הערך של security_result.severity הוא "HIGH". אם גם has_principal וגם has_target מוגדרים כ-true, צריך להגדיר את הערך SCAN_UNCATEGORIZED. אחרת, מגדירים את הערך "GENERIC_EVENT".
לא רלוונטי read_only_udm.metadata.log_type מגדירים את הערך "CISCO_AMP".
לא רלוונטי read_only_udm.metadata.vendor_name מגדירים את הערך "CISCO_AMP".
לא רלוונטי read_only_udm.security_result.summary צריך להגדיר את הערך של event_type אם event_type הוא אחד מהבאים: "Threat Detected",‏ "Exploit Prevention",‏ "Executed malware",‏ "Potential Dropper Infection",‏ "Multiple Infected Files",‏ "Vulnerable Application Detected", או אם הערך של security_result.severity הוא "HIGH".
לא רלוונטי is_alert צריך להגדיר כ-true אם event_type הוא אחד מהבאים: "Threat Detected",‏ "Exploit Prevention",‏ "Executed malware",‏ "Potential Dropper Infection",‏ "Multiple Infected Files",‏ "Vulnerable Application Detected", או אם security_result.severity הוא "HIGH".
לא רלוונטי is_significant צריך להגדיר כ-true אם event_type הוא אחד מהבאים: "Threat Detected",‏ "Exploit Prevention",‏ "Executed malware",‏ "Potential Dropper Infection",‏ "Multiple Infected Files",‏ "Vulnerable Application Detected", או אם security_result.severity הוא "HIGH".
Compressed_sha256 additional.fields מופה מיומן השינויים
analysis_action", "analysis_score", "analysis_status", "verdict_num", and "verdict_from security_result.detection_fields מופה מיומן השינויים
category security_result.category_details מופה מיומן השינויים
file_type target.file.mime_type מופה מיומן השינויים
upload_reason metadata.description מופה מיומן השינויים
active_connections","from","is_slow","instance_id","malwareverdict" and ,"verdict_str additional.fields מופה מיומן השינויים
Time metadata.event_timestamp מופה מיומן השינויים
file_extension arget.resource.attribute.labels מופה מיומן השינויים
filemime target.file.mime_type מופה מיומן השינויים
filename target.file.full_path מופה מיומן השינויים
host principal.hostname מופה מיומן השינויים
length_file principal.resource.attribute.labels מופה מיומן השינויים
uploadreason security_result.description מופה מיומן השינויים
ssl_bytes network.sent_bytes מופה מיומן השינויים
socket_bytes network.received_bytes מופה מיומן השינויים
file.disposition", "error.error_code", and "error.description security_result.description מופה מיומן השינויים
file.parent.disposition", "file.parent.file_name", "file.parent.identity.md5", "file.parent.identity.sha1", and "file.parent.identity.sha256 target.resource.attribute.labels מופה מיומן השינויים

יומן שינויים

הצגת יומן השינויים של המנתח הזה

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.