איסוף יומני 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: יצירת חשבון שירות ל-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
התקנה ב-Linux
- פותחים טרמינל עם הרשאות root או sudo.
מריצים את הפקודה הבאה:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
מקורות מידע נוספים בנושא התקנה
אפשרויות התקנה נוספות מפורטות במדריך ההתקנה.
הגדרת סוכן Bindplane להטמעת Syslog ושליחה אל Google SecOps
- ניגשים לקובץ התצורה:
- מאתרים את הקובץ
config.yaml. בדרך כלל, הוא נמצא בספרייה/opt/observiq-otel-collector/ב-Linux או בספריית ההתקנה ב-Windows. - פותחים את הקובץ באמצעות כלי לעריכת טקסט (לדוגמה,
nano,viאו פנקס הרשימות).
- מאתרים את הקובץ
- עורכים את הקובץ
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 כדי להחיל את השינויים.
כדי להפעיל מחדש את הסוכן של Bindplane ב-Linux, מריצים את הפקודה הבאה:
sudo systemctl restart observiq-otel-collectorכדי להפעיל מחדש את הסוכן של Bindplane ב-Windows, אפשר להשתמש במסוף Services או להזין את הפקודה הבאה:
net stop observiq-otel-collector && net start observiq-otel-collector
הגדרת העברת Syslog ב-Cisco APIC
הגדרת חוזי ניהול (פתרון בעיות)
אם הודעות syslog לא מגיעות ל-Google SecOps, צריך לבדוק את הגדרת הגישה לניהול:
- נכנסים למסוף Cisco APIC.
- עוברים אל Tenants > mgmt > Security Policies.
- בודקים שהחוזים של הניהול מאפשרים את יציאת UDP 514:
- לניהול מחוץ למסגרת (OOB) > צריך לוודא שהחוזה של ה-OOB מאפשר יציאת UDP 514.
- לניהול In-Band > מוודאים שהחוזה של INB מאפשר יציאת UDP 514.
- אם צריך, יוצרים או משנים מסננים כדי לאפשר יציאת UDP 514 ל-EPG הניהול שנבחר.
יצירת קבוצת יעדים למעקב אחרי Syslog
- עוברים אל Admin > External Data Collectors > Monitoring Destinations > Syslog.
- לוחצים על הסמל + כדי ליצור קבוצת יעדים לניטור Syslog.
- מזינים את פרטי ההגדרה הבאים:
- שם: מזינים שם תיאורי (לדוגמה,
Google SecOps-Syslog). - תיאור: מזינים תיאור (לדוגמה,
Syslog destination for Google Security Operations). - Admin State (מצב אדמין): בוחרים באפשרות enabled (מופעל).
- Format: בוחרים באפשרות aci (מומלץ) או באפשרות nxos.
- שם: מזינים שם תיאורי (לדוגמה,
- לוחצים על הבא.
- בקטע Create Syslog Remote Destination, מזינים את פרטי ההגדרה הבאים:
- Host Name/IP: מזינים את כתובת ה-IP של סוכן Bindplane.
- שם: נותנים ליעד שם תיאורי.
- מצב אדמין: בוחרים באפשרות מופעל.
- חומרה: בוחרים באפשרות מידע (או ברמת החומרה הרצויה).
- יציאה: מזינים 514 (או את היציאה שהוגדרה בסוכן Bindplane).
- Management EPG: בוחרים את ה-EPG המתאים לניהול:
- default (Out-of-Band) לניהול OOB
- inb-default לניהול In-Band
- מתקן העברה: בוחרים באפשרות local7 (או במתקן המועדף).
- לוחצים על OK.
- בודקים את ההגדרות ולוחצים על סיום.
הגדרת מקורות של syslog
מגדירים מקורות של syslog כדי לשלוח סוגים שונים של אירועים לקבוצת היעד:
הגדרת מקור Syslog של מדיניות Fabric
- עוברים אל Fabric > Fabric Policies > Monitoring Policies.
- מרחיבים את default ובוחרים באפשרות Callhome/SNMP/Syslog.
- לוחצים על הסמל + כדי ליצור מקור syslog.
- מזינים את פרטי ההגדרה הבאים:
- שם המקור: מזינים שם (לדוגמה,
fabric-syslog-source). - Min Severity: בוחרים באפשרות information.
- Include: בוחרים באפשרות Check All כדי לכלול יומני ביקורת, אירועים, תקלות ויומני סשנים.
- קבוצת יעד: בוחרים את קבוצת היעד לניטור של syslog שיצרתם קודם.
- שם המקור: מזינים שם (לדוגמה,
- לוחצים על שליחה.
הגדרת מקור Syslog של מדיניות נפוצה
- עוברים אל Fabric > Fabric Policies > Monitoring Policies.
- מרחיבים את common ובוחרים באפשרות Callhome/SNMP/Syslog.
- לוחצים על + כדי ליצור מקור syslog.
- מזינים את פרטי ההגדרה הבאים:
- שם המקור: מזינים שם (לדוגמה,
common-syslog-source). - Min Severity: בוחרים באפשרות information.
- Include: בוחרים באפשרות Check All כדי לכלול יומני ביקורת, אירועים, תקלות ויומני סשנים.
- קבוצת יעד: בוחרים את קבוצת היעד לניטור של syslog שיצרתם קודם.
- שם המקור: מזינים שם (לדוגמה,
- לוחצים על שליחה.
הגדרת מקור Syslog של מדיניות גישה
- עוברים אל Fabric > Access Policies > Monitoring Policies.
- מרחיבים את default ובוחרים באפשרות Callhome/SNMP/Syslog.
- לוחצים על הסמל + כדי ליצור מקור syslog.
- מזינים את פרטי ההגדרה הבאים:
- שם המקור: מזינים שם (לדוגמה,
access-syslog-source). - Min Severity: בוחרים באפשרות information.
- Include: בוחרים באפשרות Check All כדי לכלול יומני ביקורת, אירועים, תקלות ויומני סשנים.
- קבוצת יעד: בוחרים את קבוצת היעד לניטור של syslog שיצרתם קודם.
- שם המקור: מזינים שם (לדוגמה,
- לוחצים על שליחה.
הגדרת מדיניות להודעות מערכת (אופציונלי)
- עוברים אל Fabric > Fabric Policies > Monitoring Policies.
- מרחיבים את common > System Message Policies.
- בוחרים באפשרות מדיניות להודעות Syslog של המערכת.
- בוחרים את המתקן שמוגדר כברירת מחדל.
- משנים את הערך של Severity ל-information.
- לוחצים על עדכון.
טבלת מיפוי 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.