איסוף יומנים של 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: יצירת חשבון שירות ל-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.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
- Linux:
-
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: לוחצים על קובץ > שמירה
- Linux: לוחצים על
מפעילים מחדש את הסוכן של 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 Catalyst Center
- נכנסים ל-Cisco Catalyst Center.
- עוברים אל System > Settings > External Services > Destinations > Syslog (מערכת > הגדרות > שירותים חיצוניים > יעדים > Syslog).
- לוחצים על סמל ההוספה (+) כדי ליצור יעד חדש של syslog.
- מזינים את פרטי ההגדרה הבאים:
- שם: מזינים שם תיאורי (לדוגמה,
Google SecOps-Bindplane). - תיאור: מזינים תיאור קצר (לדוגמה,
Syslog forwarding to Google SecOps via Bindplane). - Hostname/IP Address: מזינים את כתובת ה-IP של המארח של סוכן Bindplane.
- יציאה: מזינים
514(או את היציאה שהוגדרה בסוכן Bindplane). - Protocol: בוחרים באפשרות UDP או TCP, בהתאם להגדרות של Bindplane.
- שם: מזינים שם תיאורי (לדוגמה,
לוחצים על Save.
אפשרות 2 – שילוב של תגובה לפעולה מאתר אחר (webhook)
באפשרות הזו, יכולות ה-webhook המקוריות של Cisco Catalyst Center משמשות להעברת אירועי JSON מובְנים ישירות אל Google SecOps בזמן אמת.
יצירת פיד של webhook ב-Google SecOps
יצירת הפיד
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- בדף הבא, לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
Cisco Catalyst Center Webhook). - בוחרים באפשרות Webhook בתור סוג המקור.
- בוחרים באפשרות Cisco Catalyst Center בתור Log type.
- לוחצים על הבא.
- מציינים ערכים לפרמטרים הבאים של הקלט:
- תו מפריד לפיצול (אופציונלי): מזינים
\nלאירועים שמופרדים בשורה חדשה. - מרחב השמות של הנכס: מרחב השמות של הנכס.
- תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.
- תו מפריד לפיצול (אופציונלי): מזינים
- לוחצים על הבא.
- בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.
יצירה ושמירה של מפתח סודי
אחרי שיוצרים את הפיד, צריך ליצור מפתח סודי לאימות:
- בדף הפרטים של הפיד, לוחצים על יצירת מפתח סודי.
- תיפתח תיבת דו-שיח עם המפתח הסודי.
מעתיקים ושומרים את המפתח הסודי באופן מאובטח.
איך מקבלים את כתובת ה-URL של נקודת הקצה של הפיד
- עוברים לכרטיסייה פרטים של הפיד.
- בקטע Endpoint Information, מעתיקים את Feed endpoint URL.
- שומרים את כתובת ה-URL הזו לשלבים הבאים.
- לוחצים על סיום.
יצירת מפתח API של Google Cloud
כדי לבצע אימות ב-Google SecOps, צריך מפתח API. יוצרים מפתח API מוגבל במסוף Google Cloud.
יצירת מפתח ה-API
- נכנסים לדף Credentials במסוף Google Cloud.
- בוחרים את הפרויקט (הפרויקט שמשויך למכונה של Google SecOps).
- לוחצים על Create credentials > מפתח API.
- מפתח ה-API נוצר ומוצג בתיבת דו-שיח.
- לוחצים על Edit API key כדי להגביל את מפתח ה-API.
הגבלת מפתח ה-API
- בדף ההגדרות של מפתח ה-API:
- שם: מזינים שם תיאורי (לדוגמה,
Chronicle Webhook API Key).
- שם: מזינים שם תיאורי (לדוגמה,
- בקטע API restrictions:
- בוחרים באפשרות Restrict key.
- בתפריט הנפתח Select APIs, מחפשים את Chronicle API ובוחרים אותו.
- לוחצים על Save.
- מעתיקים את הערך של מפתח ה-API מהשדה API key שבחלק העליון של הדף.
שומרים את מפתח ה-API בצורה מאובטחת.
הגדרת יעד ה-webhook ב-Cisco Catalyst Center
- נכנסים ל-Cisco Catalyst Center.
- עוברים אל System > Settings > External Services > Destinations > Webhook (מערכת > הגדרות > שירותים חיצוניים > יעדים > Webhook).
- לוחצים על סמל ההוספה (+) כדי ליצור יעד חדש ל-webhook.
- מזינים את פרטי ההגדרה הבאים:
- שם: מזינים שם תיאורי (לדוגמה,
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
- שם:
- שם: מזינים שם תיאורי (לדוגמה,
- לוחצים על Save.
הרשמה של אירועים להתראות של תגובה לפעולה מאתר אחר (Webhook)
- ב-Cisco Catalyst Center, עוברים אל Platform > Developer Toolkit > Event Notifications.
- בכרטיסייה התראות, לוחצים על יצירת התראה חדשה.
- בשלב 1 (בחירת אתר ואירועים), בוחרים את האתרים והאירועים שרוצים לעקוב אחריהם:
- אירועים ברשת: אין גישה למכשיר, הממשק לא פועל, שינויים בהגדרות.
- אירועי אבטחה: הפרות של מדיניות האבטחה, כשלים באימות.
- אירועי מערכת: אירועים בפלטפורמה, עדכוני תוכנה, תחזוקה.
- אירועי אבטחה: פגיעה בביצועים, בעיות בקישוריות.
- לוחצים על הבא.
- בשלב 2 (בחירת ערוצים), בוחרים באפשרות REST כערוץ ההתראות.
- בתפריט הנפתח Endpoint, בוחרים את היעד של ה-webhook שיצרתם בקטע הקודם (לדוגמה,
Google SecOps-Webhook). - לוחצים על הבא.
- בשלב 3 (סיכום), בודקים את הגדרת ההתראה.
- מזינים שם למינוי (לדוגמה,
Google SecOps Events). - לוחצים על סיום.
טבלת מיפוי 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.