איסוף יומנים של Cisco Catalyst Center (לשעבר DNA Center)

גרסת המנתח: 2.0

נתמך ב:

במסמך הזה מוסבר איך להטמיע יומנים של Cisco Catalyst Center (לשעבר DNA Center) ב-Google Security Operations באמצעות שתי גישות שונות. בוחרים את האפשרות שהכי מתאימה לסביבה ולדרישות שלכם.

‫Cisco Catalyst Center היא פלטפורמה מרכזית לניהול רשתות ולאוטומציה של רשתות IoT, רשתות של סניפים ורשתות של קמפוסים ארגוניים. הוא מספק רשתות מבוססות-כוונה, ניהול מדיניות, הקצאת מכשירים, ניתוח אבטחה וזיהוי בעיות מבוסס-AI בתשתית קווית ואלחוטית. ‫Catalyst Center יוצר אירועים שקשורים לתקינות הרשת, לשינויים בסטטוס המכשיר, להפרות מדיניות אבטחה ולבעיות אבטחה.

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

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

  • מופע של Google SecOps.
  • גישה עם הרשאות למסוף הניהול של Cisco Catalyst Center.
  • אפשרות 1: Windows Server 2016 ואילך, או מארח Linux עם systemd לסוכן Bindplane.
  • אפשרות 2: קישוריות רשת בין Cisco Catalyst Center לבין נקודת הקצה של ה-webhook ב-Google SecOps.

אפשרות 1 – שילוב של Syslog באמצעות סוכן Bindplane

באפשרות הזו, מתבצעת העברה של syslog מ-Cisco Catalyst Center לסוכן Bindplane, שמעביר יומנים מובְנים ל-Google SecOps.

קבלת פרטי כניסה ל-Google SecOps בשביל סוכן Bindplane

כדי לאמת את סוכן Bindplane ב-Google SecOps, בוחרים באחת מהשיטות הבאות:

  • פריסות חדשות: משתמשים ב-Chronicle API (אפשרות 1).
  • פריסות קודמות: ממשיכים להשתמש בקובץ האימות להטמעת נתונים (אפשרות 2) עד שה-Ingestion API יופסק ב-20 ביולי 2027.
  1. נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט ב- Google Cloud שמקושר למכונה של Google SecOps.
  2. נכנסים לדף IAM & Admin > Service Accounts.
  3. לוחצים על Create service account.
  4. מזינים את פרטי ההגדרה הבאים:
    • Service account name: מזינים שם לחשבון (לדוגמה, bindplane-ingest).
    • Service account description: מזינים תיאור (לדוגמה, Bindplane agent log ingestion).
  5. לוחצים על Create and continue.
  6. בקטע Grant this service account access to project, לוחצים על Select a role ובוחרים באפשרות Chronicle Editor.
  7. לוחצים על המשך ואז על סיום.
  8. לוחצים על חשבון השירות שיצרתם ועוברים לכרטיסייה Keys.
  9. לוחצים על Add key > Create new key.
  10. בוחרים באפשרות JSON ולוחצים על Create. קובץ המפתח יורד למחשב.
  11. שומרים את קובץ המפתח בתור ingestion-auth.json בספריית Bindplane collector (/opt/observiq-otel-collector/ingestion-auth.json ב-Linux או C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json ב-Windows), או מעדכנים את creds_file_path ב-config.yaml כך שיתאים לנתיב שבו שמרתם אותו.
  12. עוברים אל IAM & Admin > Settings ומעתיקים את הערך של Project number. תצטרכו אותו כדי להגדיר את הייצוא.

אפשרות 2: הורדה של קובץ האימות להטמעת נתונים (גרסה קודמת)

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל הגדרות > ניהול נתונים > סוכני איסוף. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > סוכני איסוף.
  3. מורידים את קובץ האימות להטמעת נתונים.
  4. שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן הסוכן של Bindplane.

איך מקבלים את מספר הלקוח ב-Google SecOps

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל הגדרות > ניהול > פרופיל. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פרופיל.
  3. מעתיקים את מספר הלקוח מהקטע פרטי הארגון ושומרים אותו.

התקנת הסוכן של Bindplane

מתקינים את הסוכן של Bindplane במערכת ההפעלה Windows או Linux לפי ההוראות הבאות.

התקנת חלונות

  1. פותחים את שורת הפקודה או את PowerShell כאדמין.
  2. מריצים את הפקודה הבאה:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. מחכים שההתקנה תסתיים.

  4. כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:

    sc query observiq-otel-collector
    

השירות אמור להופיע כ-RUNNING.

התקנה ב-Linux

  1. פותחים טרמינל עם הרשאות root או sudo.
  2. מריצים את הפקודה הבאה:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. מחכים שההתקנה תסתיים.

  4. כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:

    sudo systemctl status observiq-otel-collector
    

השירות אמור להופיע כפעיל (פועל).

מקורות מידע נוספים בנושא התקנה

במדריך להתקנת הסוכן של Bindplane מפורטות אפשרויות התקנה נוספות ופתרונות לבעיות.

הגדרת סוכן Bindplane להטמעת syslog ושליחה אל Google SecOps

מאתרים את קובץ התצורה

  • מאתרים את קובץ התצורה במערכת ההפעלה:

    • Linux:
    sudo nano /opt/observiq-otel-collector/config.yaml
    
    • Windows:
    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

עריכת קובץ התצורה

  • מחליפים את כל התוכן של config.yaml בהגדרות הבאות:

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/cisco_catalyst_center:
        protocol: https
        # Region of your instance, for example us, europe, asia-southeast1
        location: <LOCATION>
        # Project number of the Google Cloud project linked to the instance
        project: '<PROJECT_NUMBER>'
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: chronicle.googleapis.com
        log_type: CISCO_DNAC
        raw_log_field: body
    
    service:
      pipelines:
        logs/cisco_catalyst_center_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/cisco_catalyst_center
    

פרמטרים להגדרה

מחליפים את ה-placeholders הבאים:

  • הגדרת המקלט:

    • ‫listen_address: כתובת ה-IP והיציאה להאזנה. כדי להאזין בכל הממשקים, צריך להשתמש ב-0.0.0.0. אם צריך, מחליפים את היציאה (לדוגמה, 1514 ל-Linux ללא הרשאות בסיס).
  • הגדרת הייצוא:

    • ‫creds_file_path: הנתיב המלא לקובץ המפתח של חשבון השירות בפורמט JSON (אפשרות 1):
      • Linux: /opt/observiq-otel-collector/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • ‫YOUR_CUSTOMER_ID: מספר הלקוח ב-Google SecOps.
    • ‫location: מחליפים את <LOCATION> באזור של המכונה של Google SecOps (לדוגמה, us,‏ europe או asia-southeast1). המייצא מוסיף את הערך הזה בתחילת chronicle.googleapis.com. לרשימה המלאה, ראו נקודות קצה אזוריות.
    • ‫project: מחליפים את <PROJECT_NUMBER> במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.
    • ‫endpoint: משאירים את הערך chronicle.googleapis.com.

מייצא API להטמעה מדור קודם

  • אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק exporters בקוד הבא. מגדירים את creds_file_path לנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים את malachiteingestion-pa.googleapis.com בנקודת הקצה האזורית (לדוגמה, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/cisco_catalyst_center:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CISCO_DNAC
        raw_log_field: body
    

שמירת קובץ התצורה

  • אחרי שמסיימים לערוך, שומרים את הקובץ:
    • Linux: לוחצים על Ctrl+O, אחר כך על Enter ואז על Ctrl+X
    • Windows: לוחצים על קובץ > שמירה

מפעילים מחדש את הסוכן של Bindplane כדי להחיל את השינויים.

כדי להפעיל מחדש את סוכן Bindplane ב-Linux:

  1. מריצים את הפקודה הבאה:

    sudo systemctl restart observiq-otel-collector
    
  2. מוודאים שהשירות פועל:

    sudo systemctl status observiq-otel-collector
    
  3. בודקים אם יש שגיאות ביומנים:

    sudo journalctl -u observiq-otel-collector -f
    

כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows:

  1. בוחרים אחת מהאפשרויות האלה:

    • שורת הפקודה או PowerShell כאדמין:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • מסוף השירותים:
      1. לוחצים על Win+R, מקלידים services.msc ולוחצים על Enter.
      2. מאתרים את observIQ OpenTelemetry Collector.
      3. לוחצים לחיצה ימנית ובוחרים באפשרות הפעלה מחדש.
  2. מוודאים שהשירות פועל:

    sc query observiq-otel-collector
    
  3. בודקים אם יש שגיאות ביומנים:

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    

הגדרת העברת syslog ב-Cisco Catalyst Center

  1. נכנסים ל-Cisco Catalyst Center.
  2. עוברים אל System > Settings > External Services > Destinations > Syslog (מערכת > הגדרות > שירותים חיצוניים > יעדים > Syslog).
  3. לוחצים על סמל ההוספה (+) כדי ליצור יעד חדש של syslog.
  4. מזינים את פרטי ההגדרה הבאים:
    • שם: מזינים שם תיאורי (לדוגמה, Google SecOps-Bindplane).
    • תיאור: מזינים תיאור קצר (לדוגמה, Syslog forwarding to Google SecOps via Bindplane).
    • ‫Hostname/IP Address: מזינים את כתובת ה-IP של המארח של סוכן Bindplane.
    • יציאה: מזינים 514 (או את היציאה שהוגדרה בסוכן Bindplane).
    • Protocol: בוחרים באפשרות UDP או TCP, בהתאם להגדרות של Bindplane.
  5. לוחצים על Save.

אפשרות 2 – שילוב של תגובה לפעולה מאתר אחר (webhook)

באפשרות הזו, יכולות ה-webhook המקוריות של Cisco Catalyst Center משמשות להעברת אירועי JSON מובְנים ישירות אל Google SecOps בזמן אמת.

יצירת פיד של webhook ב-Google SecOps

יצירת הפיד

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. בדף הבא, לוחצים על הגדרת פיד יחיד.
  4. בשדה שם הפיד, מזינים שם לפיד (לדוגמה, Cisco Catalyst Center Webhook).
  5. בוחרים באפשרות Webhook בתור סוג המקור.
  6. בוחרים באפשרות Cisco Catalyst Center בתור Log type.
  7. לוחצים על הבא.
  8. מציינים ערכים לפרמטרים הבאים של הקלט:
    • תו מפריד לפיצול (אופציונלי): מזינים \n לאירועים שמופרדים בשורה חדשה.
    • מרחב השמות של הנכס: מרחב השמות של הנכס.
    • תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.
  9. לוחצים על הבא.
  10. בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.

יצירה ושמירה של מפתח סודי

אחרי שיוצרים את הפיד, צריך ליצור מפתח סודי לאימות:

  1. בדף הפרטים של הפיד, לוחצים על יצירת מפתח סודי.
  2. תיפתח תיבת דו-שיח עם המפתח הסודי.
  3. מעתיקים ושומרים את המפתח הסודי באופן מאובטח.

איך מקבלים את כתובת ה-URL של נקודת הקצה של הפיד

  1. עוברים לכרטיסייה פרטים של הפיד.
  2. בקטע Endpoint Information, מעתיקים את Feed endpoint URL.
  3. שומרים את כתובת ה-URL הזו לשלבים הבאים.
  4. לוחצים על סיום.

יצירת מפתח API של Google Cloud

כדי לבצע אימות ב-Google SecOps, צריך מפתח API. יוצרים מפתח API מוגבל במסוף Google Cloud.

יצירת מפתח ה-API

  1. נכנסים לדף Credentials במסוף Google Cloud.
  2. בוחרים את הפרויקט (הפרויקט שמשויך למכונה של Google SecOps).
  3. לוחצים על Create credentials > מפתח API.
  4. מפתח ה-API נוצר ומוצג בתיבת דו-שיח.
  5. לוחצים על Edit API key כדי להגביל את מפתח ה-API.

הגבלת מפתח ה-API

  1. בדף ההגדרות של מפתח ה-API:
    • שם: מזינים שם תיאורי (לדוגמה, Chronicle Webhook API Key).
  2. בקטע API restrictions:
    1. בוחרים באפשרות Restrict key.
    2. בתפריט הנפתח Select APIs, מחפשים את Chronicle API ובוחרים אותו.
  3. לוחצים על Save.
  4. מעתיקים את הערך של מפתח ה-API מהשדה API key שבחלק העליון של הדף.
  5. שומרים את מפתח ה-API בצורה מאובטחת.

הגדרת יעד ה-webhook ב-Cisco Catalyst Center

  1. נכנסים ל-Cisco Catalyst Center.
  2. עוברים אל System > Settings > External Services > Destinations > Webhook (מערכת > הגדרות > שירותים חיצוניים > יעדים > Webhook).
  3. לוחצים על סמל ההוספה (+) כדי ליצור יעד חדש ל-webhook.
  4. מזינים את פרטי ההגדרה הבאים:
    • שם: מזינים שם תיאורי (לדוגמה, Google SecOps-Webhook).
    • תיאור: מזינים תיאור קצר (לדוגמה, Webhook to Google SecOps).
    • כתובת URL: מדביקים את כתובת ה-URL של נקודת הקצה של ה-webhook ב-Google SecOps.
    • Method (שיטה): בוחרים באפשרות POST.
    • אימות: בוחרים באפשרות ללא אימות.
    • אישור מהימן: בוחרים באפשרות כן.
    • כותרות: לוחצים על הוספת כותרת ומוסיפים את הכותרות הבאות:
      • שם: Content-Type, ערך: application/json
      • ‫Name:‏ X-goog-api-key, Value: מפתח ה-API של Google Cloud
      • שם: X-Webhook-Access-Key, ערך: המפתח הסודי של הפיד ב-Google SecOps
  5. לוחצים על Save.

הרשמה של אירועים להתראות של תגובה לפעולה מאתר אחר (Webhook)

  1. ב-Cisco Catalyst Center, עוברים אל Platform > Developer Toolkit > Event Notifications.
  2. בכרטיסייה התראות, לוחצים על יצירת התראה חדשה.
  3. בשלב 1 (בחירת אתר ואירועים), בוחרים את האתרים והאירועים שרוצים לעקוב אחריהם:
    • אירועים ברשת: אין גישה למכשיר, הממשק לא פועל, שינויים בהגדרות.
    • אירועי אבטחה: הפרות של מדיניות האבטחה, כשלים באימות.
    • אירועי מערכת: אירועים בפלטפורמה, עדכוני תוכנה, תחזוקה.
    • אירועי אבטחה: פגיעה בביצועים, בעיות בקישוריות.
  4. לוחצים על הבא.
  5. בשלב 2 (בחירת ערוצים), בוחרים באפשרות REST כערוץ ההתראות.
  6. בתפריט הנפתח Endpoint, בוחרים את היעד של ה-webhook שיצרתם בקטע הקודם (לדוגמה, Google SecOps-Webhook).
  7. לוחצים על הבא.
  8. בשלב 3 (סיכום), בודקים את הגדרת ההתראה.
  9. מזינים שם למינוי (לדוגמה, Google SecOps Events).
  10. לוחצים על סיום.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
category security_result.severity_details הערך של category מהיומן הגולמי ממופה לשדה security_result.severity_details.
ciscoDnaEventLink target.url הערך של ciscoDnaEventLink מהיומן הגולמי ממופה לשדה target.url.
date_time metadata.event_timestamp השדה חולץ מהודעת היומן הגולמית באמצעות תבנית grok והומר לפורמט של חותמת זמן.
details.Assurance_Issue_Category security_result.about.resource.attribute.labels[].value הערך של details.Assurance_Issue_Category מהיומן הגולמי ממופה עם המפתח Assurance_Issue_Category.
details.Assurance_Issue_Details security_result.summary הערך של details.Assurance_Issue_Details מהיומן הגולמי ממופה לשדה security_result.summary.
details.Assurance_Issue_Name security_result.about.resource.attribute.labels[].value הערך של details.Assurance_Issue_Name מהיומן הגולמי ממופה עם המפתח Assurance_Issue_Name.
details.Assurance_Issue_Priority security_result.about.resource.attribute.labels[].value הערך של details.Assurance_Issue_Priority מהיומן הגולמי ממופה עם המפתח Assurance_Issue_Priority.
details.Assurance_Issue_Status security_result.about.resource.attribute.labels[].value הערך של details.Assurance_Issue_Status מהיומן הגולמי ממופה עם המפתח "Assurance_Issue_Status".
details.Device target.ip, target.hostname אם הערך הוא כתובת IP, הוא ממופה ל-target.ip. אחרת, הוא ממופה ל-target.hostname.
dnacIp target.ip הערך של dnacIp מהיומן הגולמי ממופה ל-target.ip אם זו כתובת IP חוקית.
domain additional.fields[].value.string_value הערך של domain מהיומן הגולמי מתווסף כצמד מפתח/ערך ל-additional.fields עם המפתח "domain".
eventId metadata.product_event_type הערך של eventId מהיומן הגולמי ממופה לשדה metadata.product_event_type.
instanceId target.resource.product_object_id הערך של instanceId מהיומן הגולמי ממופה לשדה target.resource.product_object_id.
name target.resource.attribute.labels[].value הערך של name מהיומן הגולמי ממופה עם המפתח "name".
namespace target.namespace הערך של namespace מהיומן הגולמי ממופה לשדה target.namespace.
network.deviceId target.asset.asset_id הערך של network.deviceId מהיומן הגולמי מקבל את הקידומת "deviceId:‎" וממופה אל target.asset.asset_id.
note additional.fields[].value.string_value הערך של note מהיומן הגולמי מתווסף כצמד מפתח/ערך אל additional.fields עם המפתח "note".
severity security_result.severity משמש לקביעת הערך של security_result.severity,‏ is_alert ו-is_significant.
source target.resource.attribute.labels[].value הערך של source מהיומן הגולמי ממופה עם המפתח "source".
src_ip principal.ip חולץ מהודעת היומן הגולמית באמצעות תבנית grok ומופה ל-principal.ip.
subDomain additional.fields[].value.string_value הערך של subDomain מהיומן הגולמי מתווסף כצמד מפתח/ערך אל additional.fields עם המפתח "subDomain".
tntId target.resource.attribute.labels[].value הערך של tntId מהיומן הגולמי ממופה עם המפתח "tntId".
type target.resource.attribute.labels[].value הערך של type מהיומן הגולמי ממופה עם המפתח "type".
userId target.user.userid הערך של userId מהיומן הגולמי ממופה לשדה target.user.userid.
version metadata.product_version הערך של version מהיומן הגולמי ממופה לשדה metadata.product_version.
לא רלוונטי metadata.event_type ההגדרה נקבעת לפי הנוכחות והערכים של השדות has_principal,‏ has_target ו-userId. ערכים אפשריים: NETWORK_CONNECTION, ‏ USER_UNCATEGORIZED, ‏ STATUS_UPDATE, ‏ GENERIC_EVENT.
לא רלוונטי is_alert הערך True מוגדר אם רמת החומרה היא 0 או 1, אחרת מוגדר הערך False.
לא רלוונטי is_significant הערך True מוגדר אם רמת החומרה היא 0 או 1, אחרת מוגדר הערך False.
correlationId event.idm.read_only_udm.additional.fields מופה מיומן השינויים
isSimulated event.idm.read_only_udm.additional.fields מופה מיומן השינויים
startTime event.idm.read_only_udm.extensions.vulns.vulnerabilities.scan_start_time מופה מיומן השינויים
details.wlcIp event.idm.read_only_udm.intermediary.ip מופה מיומן השינויים
details.detectingApName event.idm.read_only_udm.observer.hostname מופה מיומן השינויים
details.detectingApLocation event.idm.read_only_udm.observer.location.name מופה מיומן השינויים
details.detectingApMacAddress event.idm.read_only_udm.observer.mac מופה מיומן השינויים
network.siteId event.idm.read_only_udm.observer.resource.attribute.labels מופה מיומן השינויים
src_ip event.idm.read_only_udm.principal.hostname מופה מיומן השינויים
details event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
details.threatType event.idm.read_only_udm.security_result.threat_name מופה מיומן השינויים
tenantId event.idm.read_only_udm.target.resource.attribute.labels מופה מיומן השינויים

יומן שינויים

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

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