איסוף יומני Cisco APIC

גרסת המנתח: 1.0

נתמך ב:

במסמך הזה מוסבר איך להטמיע יומני Cisco APIC ב-Google Security Operations באמצעות סוכן Bindplane.

מנתח הנתונים מחלץ שדות מיומנים בפורמט syslog של Cisco APIC. הוא משתמש ב-grok או ב-kv כדי לנתח את הודעת היומן, ואז ממפה את הערכים האלה למודל הנתונים המאוחד (UDM). הוא גם מגדיר ערכי מטא-נתונים שמוגדרים כברירת מחדל למקור האירוע ולסוג האירוע.

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

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

  • מכונה של Google SecOps
  • מארח עם Windows 2016 ואילך או Linux עם systemd
  • אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
  • גישה עם הרשאות למסוף הניהול של Cisco APIC

קבלת פרטי כניסה ל-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
    

התקנה ב-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
    

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

אפשרויות התקנה נוספות מפורטות במדריך ההתקנה.

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

  1. ניגשים לקובץ התצורה:
    • מאתרים את הקובץ config.yaml. בדרך כלל, הוא נמצא בספרייה /opt/observiq-otel-collector/ ב-Linux או בספריית ההתקנה ב-Windows.
    • פותחים את הקובץ באמצעות כלי לעריכת טקסט (לדוגמה, nano,‏ vi או פנקס הרשימות).
  2. עורכים את הקובץ config.yaml באופן הבא: yaml receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: 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 # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: YOUR_CUSTOMER_ID endpoint: chronicle.googleapis.com # Specify the log type that matches your Chronicle feed configuration # Commonly used: CISCO_ACI or CISCO_APIC depending on your setup log_type: 'CISCO_APIC' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
  • מחליפים את היציאה ואת כתובת ה-IP לפי הצורך בתשתית:
    • מחליפים את <LOCATION> באזור של המופע של Google SecOps (לדוגמה, us,‏ europe או asia-southeast1). המערכת מוסיפה את הערך הזה בתחילת chronicle.googleapis.com.
    • מחליפים את <PROJECT_NUMBER> במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.
    • מחליפים את YOUR_CUSTOMER_ID במספר הלקוח בפועל.
    • מעדכנים את /path/to/ingestion-authentication-file.json לנתיב הקובץ שבו נשמר קובץ המפתח של חשבון השירות (אפשרות 1) בשלב 1.
    • מוודאים שהערך של log_type תואם לסוג היומן שנבחר בהגדרת הפיד של Google SecOps.

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

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

    exporters:
      chronicle/chronicle_w_labels:
        compression: gzip
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: YOUR_CUSTOMER_ID
        endpoint: malachiteingestion-pa.googleapis.com
        # Specify the log type that matches your Chronicle feed configuration
        # Commonly used: CISCO_ACI or CISCO_APIC depending on your setup
        log_type: 'CISCO_APIC'
        raw_log_field: body
        ingestion_labels:
    

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

  1. כדי להפעיל מחדש את הסוכן של Bindplane ב-Linux, מריצים את הפקודה הבאה:

    sudo systemctl restart observiq-otel-collector
    
  2. כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows, אפשר להשתמש במסוף Services או להזין את הפקודה הבאה:

    net stop observiq-otel-collector && net start observiq-otel-collector
    

הגדרת העברת Syslog ב-Cisco APIC

הגדרת חוזי ניהול (פתרון בעיות)

אם הודעות syslog לא מגיעות ל-Google SecOps, צריך לבדוק את הגדרת הגישה לניהול:

  1. נכנסים למסוף Cisco APIC.
  2. עוברים אל Tenants > mgmt > Security Policies.
  3. בודקים שהחוזים של הניהול מאפשרים את יציאת UDP‏ 514:
    • לניהול מחוץ למסגרת (OOB) > צריך לוודא שהחוזה של ה-OOB מאפשר יציאת UDP‏ 514.
    • לניהול In-Band > מוודאים שהחוזה של INB מאפשר יציאת UDP‏ 514.
  4. אם צריך, יוצרים או משנים מסננים כדי לאפשר יציאת UDP‏ 514 ל-EPG הניהול שנבחר.

יצירת קבוצת יעדים למעקב אחרי Syslog

  1. עוברים אל Admin > External Data Collectors > Monitoring Destinations > Syslog.
  2. לוחצים על הסמל + כדי ליצור קבוצת יעדים לניטור Syslog.
  3. מזינים את פרטי ההגדרה הבאים:
    • שם: מזינים שם תיאורי (לדוגמה, Google SecOps-Syslog).
    • תיאור: מזינים תיאור (לדוגמה, Syslog destination for Google Security Operations).
    • Admin State (מצב אדמין): בוחרים באפשרות enabled (מופעל).
    • Format: בוחרים באפשרות aci (מומלץ) או באפשרות nxos.
  4. לוחצים על הבא.
  5. בקטע Create Syslog Remote Destination, מזינים את פרטי ההגדרה הבאים:
    • ‫Host Name/IP: מזינים את כתובת ה-IP של סוכן Bindplane.
    • שם: נותנים ליעד שם תיאורי.
    • מצב אדמין: בוחרים באפשרות מופעל.
    • חומרה: בוחרים באפשרות מידע (או ברמת החומרה הרצויה).
    • יציאה: מזינים 514 (או את היציאה שהוגדרה בסוכן Bindplane).
    • Management EPG: בוחרים את ה-EPG המתאים לניהול:
      • ‫default (Out-of-Band) לניהול OOB
      • ‫inb-default לניהול In-Band
    • מתקן העברה: בוחרים באפשרות local7 (או במתקן המועדף).
  6. לוחצים על OK.
  7. בודקים את ההגדרות ולוחצים על סיום.

הגדרת מקורות של syslog

מגדירים מקורות של syslog כדי לשלוח סוגים שונים של אירועים לקבוצת היעד:

הגדרת מקור Syslog של מדיניות Fabric

  1. עוברים אל Fabric > Fabric Policies > Monitoring Policies.
  2. מרחיבים את default ובוחרים באפשרות Callhome/SNMP/Syslog.
  3. לוחצים על הסמל + כדי ליצור מקור syslog.
  4. מזינים את פרטי ההגדרה הבאים:
    • שם המקור: מזינים שם (לדוגמה, fabric-syslog-source).
    • ‫Min Severity: בוחרים באפשרות information.
    • Include: בוחרים באפשרות Check All כדי לכלול יומני ביקורת, אירועים, תקלות ויומני סשנים.
    • קבוצת יעד: בוחרים את קבוצת היעד לניטור של syslog שיצרתם קודם.
  5. לוחצים על שליחה.

הגדרת מקור Syslog של מדיניות נפוצה

  1. עוברים אל Fabric > Fabric Policies > Monitoring Policies.
  2. מרחיבים את common ובוחרים באפשרות Callhome/SNMP/Syslog.
  3. לוחצים על + כדי ליצור מקור syslog.
  4. מזינים את פרטי ההגדרה הבאים:
    • שם המקור: מזינים שם (לדוגמה, common-syslog-source).
    • ‫Min Severity: בוחרים באפשרות information.
    • Include: בוחרים באפשרות Check All כדי לכלול יומני ביקורת, אירועים, תקלות ויומני סשנים.
    • קבוצת יעד: בוחרים את קבוצת היעד לניטור של syslog שיצרתם קודם.
  5. לוחצים על שליחה.

הגדרת מקור Syslog של מדיניות גישה

  1. עוברים אל Fabric > Access Policies > Monitoring Policies.
  2. מרחיבים את default ובוחרים באפשרות Callhome/SNMP/Syslog.
  3. לוחצים על הסמל + כדי ליצור מקור syslog.
  4. מזינים את פרטי ההגדרה הבאים:
    • שם המקור: מזינים שם (לדוגמה, access-syslog-source).
    • ‫Min Severity: בוחרים באפשרות information.
    • Include: בוחרים באפשרות Check All כדי לכלול יומני ביקורת, אירועים, תקלות ויומני סשנים.
    • קבוצת יעד: בוחרים את קבוצת היעד לניטור של syslog שיצרתם קודם.
  5. לוחצים על שליחה.

הגדרת מדיניות להודעות מערכת (אופציונלי)

  1. עוברים אל Fabric > Fabric Policies > Monitoring Policies.
  2. מרחיבים את common > System Message Policies.
  3. בוחרים באפשרות מדיניות להודעות Syslog של המערכת.
  4. בוחרים את המתקן שמוגדר כברירת מחדל.
  5. משנים את הערך של Severity ל-information.
  6. לוחצים על עדכון.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
fault_cause_label additional.fields ממוזג
ts metadata.event_timestamp נותח בתור ISO8601
event_type metadata.event_type מיפוי ישיר
lifecycle_state metadata.product_event_type מיפוי ישיר
host principal.asset.hostname מיפוי ישיר
prin_ip principal.asset.ip ממוזג
host principal.hostname מיפוי ישיר
prin_ip principal.ip ממוזג
mac principal.mac ממוזג
desc security_result.description מיפוי ישיר
severity_detail security_result.severity_details מיפוי ישיר
לא רלוונטי metadata.product_name קבוע: CISCO APIC
לא רלוונטי metadata.vendor_name קבוע: CISCO

יומן שינויים

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

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