איסוף יומני 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: יצירת חשבון שירות ל-Chronicle API (מומלץ)
- נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט ב- Google Cloud שמקושר למכונה של Google SecOps.
- נכנסים לדף IAM & Admin > Service Accounts.
- לוחצים על Create service account.
- מזינים את פרטי ההגדרה הבאים:
- Service account name: מזינים שם לחשבון (לדוגמה,
bindplane-ingest). - Service account description: מזינים תיאור (לדוגמה,
Bindplane agent log ingestion).
- Service account name: מזינים שם לחשבון (לדוגמה,
- לוחצים על Create and continue.
- בקטע Grant this service account access to project, לוחצים על Select a role ובוחרים באפשרות Chronicle Editor.
- לוחצים על המשך ואז על סיום.
- לוחצים על חשבון השירות שיצרתם ועוברים לכרטיסייה Keys.
- לוחצים על Add key > Create new key.
- בוחרים באפשרות JSON ולוחצים על Create. קובץ המפתח יורד למחשב.
- שומרים את קובץ המפתח בתור
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כך שיתאים לנתיב שבו שמרתם אותו. - עוברים אל IAM & Admin > Settings ומעתיקים את הערך של Project number. תצטרכו אותו כדי להגדיר את הייצוא.
אפשרות 2: הורדה של קובץ האימות להטמעת נתונים (גרסה קודמת)
- נכנסים למסוף Google SecOps.
- עוברים אל הגדרות > ניהול נתונים > סוכני איסוף. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > סוכני איסוף.
- מורידים את קובץ האימות להטמעת נתונים.
- שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן הסוכן של Bindplane.
איך מקבלים את מספר הלקוח ב-Google SecOps
- נכנסים למסוף Google SecOps.
- עוברים אל הגדרות > ניהול > פרופיל. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פרופיל.
מעתיקים את מספר הלקוח מהקטע פרטי הארגון ושומרים אותו.
התקנת הסוכן של Bindplane
מתקינים את הסוכן של Bindplane במערכת ההפעלה Windows או Linux לפי ההוראות הבאות.
התקנת חלונות
- פותחים את שורת הפקודה או את PowerShell כאדמין.
מריצים את הפקודה הבאה:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietמחכים שההתקנה תסתיים.
כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:
sc query observiq-otel-collectorהשירות אמור להופיע כ-RUNNING.
התקנה ב-Linux
- פותחים טרמינל עם הרשאות root או sudo.
מריצים את הפקודה הבאה:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shמחכים שההתקנה תסתיים.
כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:
sudo systemctl status observiq-otel-collectorהשירות אמור להופיע כפעיל (פועל).
מקורות מידע נוספים בנושא התקנה
במדריך להתקנת הסוכן של Bindplane מפורטות אפשרויות התקנה נוספות ופתרונות לבעיות.
הגדרת סוכן Bindplane כדי להטמיע את syslog ולשלוח ל-Google SecOps
מאתרים את קובץ התצורה
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
עריכת קובץ התצורה
מחליפים את כל התוכן של
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מחליפים את ה-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
- Linux:
-
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:
מריצים את הפקודה הבאה:
sudo systemctl restart observiq-otel-collectorמוודאים שהשירות פועל:
sudo systemctl status observiq-otel-collectorבודקים אם יש שגיאות ביומנים:
sudo journalctl -u observiq-otel-collector -f
כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows:
בוחרים אחת מהאפשרויות האלה:
שורת הפקודה או PowerShell כאדמין:
net stop observiq-otel-collector && net start observiq-otel-collectorמסוף השירותים:
- לוחצים על
Win+R, מקלידיםservices.mscולוחצים על Enter. - מאתרים את observIQ OpenTelemetry Collector.
- לוחצים לחיצה ימנית ובוחרים באפשרות הפעלה מחדש.
מוודאים שהשירות פועל:
sc query observiq-otel-collectorבודקים אם יש שגיאות ביומנים:
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
- נכנסים לממשק Cisco Unified Communications Manager Administration באמצעות דפדפן אינטרנט.
- עוברים אל מכשיר > טלפון.
- משתמשים בפונקציית החיפוש כדי לאתר את מכשיר Cisco TelePresence System.
- לוחצים על שם המכשיר כדי לפתוח את החלון Phone Configuration (הגדרת הטלפון).
- גוללים למטה לקטע Product Specific Configuration Layout (פריסת הגדרות ספציפיות למוצר).
- מאתרים את השדה כתובת SYSLOG חיצונית.
בשדה כתובת SYSLOG חיצונית, מזינים את כתובת שרת ה-syslog באחד מהפורמטים הבאים:
- כתובת IP בלבד:
192.168.1.100(משתמשת ביציאה 514 שמוגדרת כברירת מחדל) - כתובת IP עם יציאה:
192.168.1.100:514 - שם מארח בלבד:
bindplane-server.example.com(משתמש ביציאת ברירת המחדל 514) - שם המארח עם היציאה:
bindplane-server.example.com:1514
- כתובת IP בלבד:
כדי לשמור את ההגדרות, לוחצים על שמירה בתחתית הדף.
לוחצים על Apply Config כדי להחיל את השינויים במכשיר.
לוחצים על Reset (איפוס) או על Restart (הפעלה מחדש) כדי להפעיל מחדש את מכשיר ה-CTS ולהפעיל את העברת ה-syslog.
אימות ההגדרות של syslog במכשיר CTS
- פותחים דפדפן אינטרנט ועוברים לממשק הניהול של CTS בכתובת
https://<CTS-IP-ADDRESS>. - מתחברים באמצעות שם המשתמש והסיסמה של מנהל המערכת ב-SSH שהוגדרו ב-CUCM.
- עוברים אל הגדרות > הגדרות רשת.
מוודאים שבשדה Syslog Address מוצגת כתובת ה-IP או שם המארח של סוכן Bindplane.
הגדרת syslog לכמה מכשירי CTS
אם יש לכם כמה מכשירי CTS, חזרו על שלבי ההגדרה בכל מכשיר:
- ב-CUCM, עוברים אל Device > Phone.
- מחפשים ובוחרים כל מכשיר CTS.
- מגדירים את השדה External SYSLOG Address בקטע Product Specific Configuration Layout.
- שומרים את ההגדרות ומחילים אותן על כל מכשיר.
- מפעילים מחדש כל מכשיר כדי להפעיל את העברת ה-syslog.
איך מוודאים שהודעות syslog מתקבלות
בודקים את יומני הסוכן של Bindplane כדי לוודא שהודעות syslog מתקבלות:
Linux:
sudo journalctl -u observiq-otel-collector -f | grep -i ciscoWindows:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log" | findstr /i cisco
נכנסים למסוף Google SecOps.
עוברים אל חיפוש ומריצים שאילתת חיפוש של יומני CTS מהזמן האחרון:
metadata.log_type = "CISCO_CTS"מוודאים שהיומנים מופיעים בתוצאות החיפוש עם חותמות זמן עדכניות.
פורמט ההודעה של Syslog
מערכת Cisco TelePresence שולחת הודעות syslog בפורמט RFC 3164 (BSD syslog). ההודעות כוללות:
- הודעות ביומן של מפעיל המערכת (sysop) לגבי פעילויות של שיחות, אירועי וידאו/אודיו ופעולות של המערכת
- קוד מתקן: משתנה לפי סוג ההודעה
- יציאת ברירת המחדל: UDP 514
- אחסון הודעות: עד 20 קובצי יומן מתחלפים במכשיר CTS
פתרון בעיות בהעברת syslog
אם הודעות syslog לא מתקבלות:
בודקים את החיבור לרשת מה-codec של CTS לסוכן Bindplane:
ping <BINDPLANE_AGENT_IP>מוודאים שהכללים של חומת האש מאפשרים תעבורת UDP ביציאה 514 (או ביציאה שהוגדרה) מכתובות ה-IP של CTS לסוכן Bindplane.
מוודאים שכתובת ה-SYSLOG החיצונית מוגדרת בצורה נכונה בפריסת ההגדרות הספציפיות למוצר ב-CUCM.
מוודאים שמכשיר ה-CTS הופעל מחדש אחרי שהגדרתם את ה-syslog.
בודקים את היומנים של ממשק הניהול של CTS ב-פתרון בעיות > קובצי יומן כדי לראות אם יש שגיאות שקשורות ל-syslog.
מוודאים שסוכן Bindplane מאזין ליציאה הנכונה:
Linux:
sudo netstat -ulnp | grep 514Windows:
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.