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

גרסת המנתח: 6.0

נתמך ב:

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

Cisco TelePresence System (CTS)‎ מתייחס לנקודות קצה מדור קודם של חומרה לשיחות ועידה בווידאו, כולל מערכות מסדרות CTS 500, ‏ CTS 1000, ‏ CTS 1100, ‏ CTS 1300, ‏ CTS 3000, ‏ CTS 3200 ו-TX. המערכות האלה לחדרי ועידה בווידאו מספקות יכולות של שיחות ועידה בווידאו באיכות גבוהה, והן מנוהלות באמצעות Cisco Unified Communications Manager ‏(CUCM). המערכות יוצרות הודעות syslog לפעולות של המערכת, לפעילויות של שיחות ולפתרון בעיות.

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

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

  • מכונה של Google SecOps
  • ‫Windows Server 2016 ואילך, או מארח Linux עם systemd
  • קישוריות רשת בין סוכן Bindplane לבין Cisco TelePresence System
  • אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
  • הרשאת אדמין ב-Cisco Unified Communications Manager‏ (CUCM)
  • הרשאת אדמין לממשק הניהול של Cisco TelePresence System
  • קישוריות רשת מ-codec של CTS לסוכן Bindplane ביציאת UDP‏ 514 (או ביציאה שהוגדרה)

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

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

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

    receivers:
        udplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/cisco_cts:
            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_CTS
            raw_log_field: body
    
    service:
        pipelines:
            logs/cts_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/cisco_cts
    
  2. מחליפים את ה-placeholders הבאים:

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

      • המקלט משתמש ב-udplog ל-UDP syslog (תקן למכשירי CTS)
      • listen_address מוגדר ל-0.0.0.0:514 כדי להאזין בכל הממשקים ביציאת UDP‏ 514
      • במערכות Linux שפועלות ללא הרשאות ברמת הבסיס, צריך לשנות את היציאה ל-1514 ומעלה
    • הגדרת הייצוא:

      • ‫creds_file_path: הנתיב המלא לקובץ המפתח של חשבון השירות בפורמט JSON (אפשרות 1):
        • Linux: /opt/observiq-otel-collector/ingestion-auth.json
        • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
      • ‫customer_id: מחליפים את YOUR_CUSTOMER_ID ב-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.
      • log_type: צריך להגדיר לערך CISCO_CTS (נדרשת התאמה מדויקת)

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

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

    exporters:
        chronicle/cisco_cts:
            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_CTS
            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 CTS

העברת syslog של Cisco TelePresence System (CTS) מוגדרת דרך Cisco Unified Communications Manager (CUCM). צריך להגדיר את כתובת ה-Syslog החיצונית בפריסת ההגדרות הספציפיות למוצר בכל מכשיר CTS.

הגדרת כתובת syslog חיצונית ב-CUCM

  1. נכנסים לממשק Cisco Unified Communications Manager Administration באמצעות דפדפן אינטרנט.
  2. עוברים אל מכשיר > טלפון.
  3. משתמשים בפונקציית החיפוש כדי לאתר את מכשיר Cisco TelePresence System.
  4. לוחצים על שם המכשיר כדי לפתוח את החלון Phone Configuration (הגדרת הטלפון).
  5. גוללים למטה לקטע Product Specific Configuration Layout (פריסת הגדרות ספציפיות למוצר).
  6. מאתרים את השדה כתובת SYSLOG חיצונית.
  7. בשדה כתובת SYSLOG חיצונית, מזינים את כתובת שרת ה-syslog באחד מהפורמטים הבאים:

    • כתובת IP בלבד: 192.168.1.100 (משתמשת ביציאה 514 שמוגדרת כברירת מחדל)
    • כתובת IP עם יציאה: 192.168.1.100:514
    • שם מארח בלבד: bindplane-server.example.com (משתמש ביציאת ברירת המחדל 514)
    • שם המארח עם היציאה: bindplane-server.example.com:1514
  8. כדי לשמור את ההגדרות, לוחצים על שמירה בתחתית הדף.

  9. לוחצים על Apply Config כדי להחיל את השינויים במכשיר.

  10. לוחצים על Reset (איפוס) או על Restart (הפעלה מחדש) כדי להפעיל מחדש את מכשיר ה-CTS ולהפעיל את העברת ה-syslog.

אימות ההגדרות של syslog במכשיר CTS

  1. פותחים דפדפן אינטרנט ועוברים לממשק הניהול של CTS בכתובת https://<CTS-IP-ADDRESS>.
  2. מתחברים באמצעות שם המשתמש והסיסמה של מנהל המערכת ב-SSH שהוגדרו ב-CUCM.
  3. עוברים אל הגדרות > הגדרות רשת.
  4. מוודאים שבשדה Syslog Address מוצגת כתובת ה-IP או שם המארח של סוכן Bindplane.

הגדרת syslog לכמה מכשירי CTS

אם יש לכם כמה מכשירי CTS, חזרו על שלבי ההגדרה בכל מכשיר:

  1. ב-CUCM, עוברים אל Device > Phone.
  2. מחפשים ובוחרים כל מכשיר CTS.
  3. מגדירים את השדה External SYSLOG Address בקטע Product Specific Configuration Layout.
  4. שומרים את ההגדרות ומחילים אותן על כל מכשיר.
  5. מפעילים מחדש כל מכשיר כדי להפעיל את העברת ה-syslog.

איך מוודאים שהודעות syslog מתקבלות

  1. בודקים את יומני הסוכן של Bindplane כדי לוודא שהודעות syslog מתקבלות:

    • Linux:

      sudo journalctl -u observiq-otel-collector -f | grep -i cisco
      
    • ‫Windows:

      type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log" | findstr /i cisco
      
  2. נכנסים למסוף Google SecOps.

  3. עוברים אל חיפוש ומריצים שאילתת חיפוש של יומני CTS מהזמן האחרון:

    metadata.log_type = "CISCO_CTS"
    
  4. מוודאים שהיומנים מופיעים בתוצאות החיפוש עם חותמות זמן עדכניות.

פורמט ההודעה של Syslog

מערכת Cisco TelePresence שולחת הודעות syslog בפורמט RFC 3164 (BSD syslog). ההודעות כוללות:

  • הודעות ביומן של מפעיל המערכת (sysop) לגבי פעילויות של שיחות, אירועי וידאו/אודיו ופעולות של המערכת
  • קוד מתקן: משתנה לפי סוג ההודעה
  • יציאת ברירת המחדל: UDP 514
  • אחסון הודעות: עד 20 קובצי יומן מתחלפים במכשיר CTS

פתרון בעיות בהעברת syslog

אם הודעות syslog לא מתקבלות:

  1. בודקים את החיבור לרשת מה-codec של CTS לסוכן Bindplane:

    ping <BINDPLANE_AGENT_IP>
    
  2. מוודאים שהכללים של חומת האש מאפשרים תעבורת UDP ביציאה 514 (או ביציאה שהוגדרה) מכתובות ה-IP של CTS לסוכן Bindplane.

  3. מוודאים שכתובת ה-SYSLOG החיצונית מוגדרת בצורה נכונה בפריסת ההגדרות הספציפיות למוצר ב-CUCM.

  4. מוודאים שמכשיר ה-CTS הופעל מחדש אחרי שהגדרתם את ה-syslog.

  5. בודקים את היומנים של ממשק הניהול של CTS ב-פתרון בעיות > קובצי יומן כדי לראות אם יש שגיאות שקשורות ל-syslog.

  6. מוודאים שסוכן Bindplane מאזין ליציאה הנכונה:

    • Linux:

      sudo netstat -ulnp | grep 514
      
    • ‫Windows:

      netstat -an | findstr :514
      

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
‫AuditDetails, ‏ data2 security_result.description הערך מ-AuditDetails אם הוא לא ריק, אחרת data2
ClientAddress, LoginFrom principal.ip הערך מ-ClientAddress אם הוא לא ריק והוא לא כתובת IP, אחרת LoginFrom
EventType metadata.product_event_type הערך הועתק ישירות
logType metadata.description הערך הועתק ישירות
severity security_result.severity ההגדרה היא INFORMATIONAL אם רמת החומרה היא [6,7], LOW אם היא 5, MEDIUM אם היא 4, ERROR אם היא 3, HIGH אם היא 2, אחרת היא CRITICAL
logType, EventStatus security_result.action צריך להגדיר את הערך ALLOW אם logType == AuthenticationSucceeded או EventStatus == Success
EventType, ‏ logType metadata.event_type ההגדרה היא USER_RESOURCE_ACCESS אם EventType == UserAccess;‏ USER_LOGIN אם EventType == UserLogging או אם logType תואם ל-LOGIN;‏ USER_RESOURCE_UPDATE_CONTENT אם EventType הוא אחד מהבאים: [UserRoleMembershipUpdate, GeneralConfigurationUpdate]; אחרת, ההגדרה היא GENERIC_EVENT
AppID principal.application הערך הועתק ישירות
NodeID target.hostname הערך הועתק ישירות
process_id principal.process.pid הערך הועתק ישירות
ResourceAccessed target.resource.name הערך הועתק ישירות
UserID principal.user.userid הערך הועתק ישירות
metadata.product_name צריך להגדיר את הערך "CISCO_CTS"
metadata.vendor_name צריך להגדיר את הערך "CISCO"

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