איסוף יומנים של H3C Comware Platform Switch
במסמך הזה מוסבר איך להטמיע ב-Google Security Operations יומנים של H3C Comware Platform Switch באמצעות Bindplane.
מתגי H3C Comware Platform הם מתגי רשת ברמה ארגונית שמספקים יכולות מיתוג בשכבה 2 ובשכבה 3, תכונות אבטחה מתקדמות וניהול רשת מקיף באמצעות מערכת ההפעלה Comware. המתגים תומכים ביכולות רישום נרחבות ביומן באמצעות תכונת מרכז המידע, כדי לעקוב אחרי פעולות ברשת, אירועי אבטחה ואבחון המערכת.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מכונה של Google SecOps
- Windows Server 2016 ואילך, או מארח Linux עם
systemd - קישוריות רשת בין סוכן Bindplane לבין H3C Comware Platform Switch
- אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
- גישה עם הרשאות למסוף הניהול של H3C Comware Platform Switch דרך מסוף, Telnet או SSH
- מתג H3C Comware Platform עם תכונת מרכז המידע מופעלת (מופעלת כברירת מחדל)
קבלת פרטי כניסה ל-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/h3c_switch: 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: H3C_SWITCH raw_log_field: body ingestion_labels: env: production service: pipelines: logs/h3c_to_chronicle: receivers: - udplog exporters: - chronicle/h3c_switch
פרמטרים להגדרה
מחליפים את ה-placeholders הבאים:
הגדרת המקלט:
-
listen_address: מגדירים את הערך0.0.0.0:514כדי להאזין לכל הממשקים ביציאת UDP 51. אם אתם מריצים את השרת כמשתמשים שאינם משתמשי root ב-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במזהה הלקוח מהשלב הקודם. -
location: מחליפים את<LOCATION>באזור של המכונה של Google SecOps (לדוגמה,us,europeאוasia-southeast1). המייצא מוסיף את הערך הזה בתחילתchronicle.googleapis.com. לרשימה המלאה, ראו נקודות קצה אזוריות. -
project: מחליפים את<PROJECT_NUMBER>במספר הפרויקט שמופיע בקטע IAM & Admin > Settings. -
endpoint: משאירים את הערךchronicle.googleapis.com. log_type: מגדירים את הערךH3C_SWITCHבדיוק כמו שמוצג.-
ingestion_labels: תוויות אופציונליות בפורמט YAML (לדוגמה,env: production).
-
מייצא API להטמעה מדור קודם
אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק
exportersבקוד הבא. מגדירים אתcreds_file_pathלנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים אתmalachiteingestion-pa.googleapis.comבנקודת הקצה האזורית (לדוגמה,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/h3c_switch: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: malachiteingestion-pa.googleapis.com log_type: H3C_SWITCH raw_log_field: body ingestion_labels: env: production
שמירת קובץ התצורה
אחרי העריכה, שומרים את הקובץ:
- 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 של H3C Comware Platform Switch
מגדירים את מתג הפלטפורמה של H3C Comware כך שישלח הודעות syslog לסוכן Bindplane.
גישה ל-CLI של המתג
- נכנסים למתג של פלטפורמת H3C Comware באחת מהשיטות הבאות:
- חיבור ליציאת מסוף
- Telnet
- SSH
כדי להיכנס לתצוגת המערכת, מקלידים את הפקודה הבאה:
<H3C> system-view
ההנחיה משתנה ל-[H3C], מה שמציין שאתם בתצוגת המערכת.
מוודאים שמרכז המידע מופעל
מרכז המידע מופעל כברירת מחדל במתגים של H3C Comware Platform. כדי לאמת או להפעיל את מרכז המידע, מזינים את הפקודה הבאה:
[H3C] info-center enableאם מרכז המידע כבר מופעל, המערכת תציג את ההודעה:
Info: Information center is enabled.
הגדרת הפורמט של חותמת הזמן (אופציונלי)
פורמט ברירת המחדל של חותמת הזמן לפרטי המערכת שנשלחים למארח היומן הוא תאריך. כדי להגדיר את הפורמט של חותמת הזמן, משתמשים בפקודה הבאה:
[H3C] info-center timestamp loghost dateפורמטים זמינים של חותמות זמן:
date: הפורמט הוא "Mmm dd hh:mm:ss:ms yyyy" (לדוגמה, Dec 8 10:12:21:708 2012)-
iso: פורמט ISO 8601 (לדוגמה, 2012-09-21T15:32:55) no-year-date: התאריך והשעה הנוכחיים במערכת, בלי השנה-
none: אין מידע על חותמת הזמן
הגדרת מארח היומן
מציינים את המארח של סוכן Bindplane כמארח של היומן. אפשר להגדיר את הפרמטר facility מ-local0 עד local7, וערך ברירת המחדל הוא local7.
[H3C] info-center loghost BINDPLANE_AGENT_IP port 514 facility local7מחליפים את
BINDPLANE_AGENT_IPבכתובת ה-IP של המארח שמריץ את סוכן Bindplane.לדוגמה, אם סוכן Bindplane פועל במארח 192.168.1.100:
[H3C] info-center loghost 192.168.1.100 port 514 facility local7פרמטרים:
-
BINDPLANE_AGENT_IP: כתובת ה-IP של המארח של סוכן Bindplane -
port 514: מספר יציאת ה-UDP (חייב להתאים ליציאה שהוגדרה בסוכן Bindplane) -
facility local7: מתקן Syslog (הערכים התקינים הם local0 עד local7, ברירת המחדל היא local7)
-
הגדרת ממשק המקור (אופציונלי)
הפקודה info-center loghost source נכנסת לתוקף רק אחרי שמפעילים את מרכז המידע באמצעות הפקודה info-center enable. כדי לציין ממשק מקור להודעות ביומן:
[H3C] info-center loghost source INTERFACE_TYPE INTERFACE_NUMBERלדוגמה, כדי להשתמש בממשק VLAN 1 כמקור:
[H3C] info-center loghost source vlan-interface 1
השבתת פלט ברירת המחדל של היומן למארח היומן
כברירת מחדל, המערכת שולחת את המידע של כל המודולים למארח היומן. כדי לקבוע אילו מודולים ישלחו יומנים, קודם צריך להשבית את הפלט שמוגדר כברירת מחדל:
[H3C] undo info-center source default loghost
הגדרת כללים לפלט של יומנים
מגדירים אילו מודולים ורמות חומרה ישלחו יומנים למארח היומנים. פרטי המערכת מסווגים ל-8 רמות חומרה, מ-0 עד 7, בסדר יורד. המתג מוציא את פרטי המערכת עם רמת חומרה גבוהה או שווה לרמה שצוינה. לדוגמה, אם מגדירים כלל פלט עם ערך חומרה 6 (מידע), הפלט יכלול את המידע עם ערך חומרה מ-0 עד 6.
רמות חומרה (0-7):
- 0: מקרי חירום
- 1: התראות
- 2: קריטי
- 3: שגיאות
- 4: אזהרות
- 5: התראות
- 6: מידע בלבד
- 7: ניפוי באגים
כדי להגדיר פלט של יומן לכל המודולים ברמת מידע או ברמה גבוהה יותר:
[H3C] info-center source default loghost level informationalכדי להגדיר פלט של יומן למודולים ספציפיים (לדוגמה, ARP ו-IP):
[H3C] info-center source arp loghost level informational [H3C] info-center source ip loghost level informationalכדי לראות את מודולי המקור הזמינים, משתמשים בפקודה:
[H3C] info-center source ?
שמירת ההגדרה
שומרים את ההגדרות כדי לוודא שהן יישמרו אחרי הפעלה מחדש:
[H3C] saveכשמופיעה בקשה, כותבים
Yכדי לאשר.
אימות ההגדרות האישיות
כדי לאמת את ההגדרה של מרכז המידע, משתמשים בפקודה הבאה:
[H3C] display info-center
הפקודה הזו מציגה את ההגדרות הנוכחיות של מרכז המידע, כולל הגדרות המארח של היומן, כללי הפלט והגדרות הערוצים.
דוגמה להגדרה מלאה
בדוגמה הבאה מוצגת הגדרה מלאה לשליחת יומנים מכל המודולים ברמת מידע או ברמה גבוהה יותר למארח יומנים בכתובת 192.168.1.100:
<H3C> system-view [H3C] info-center enable [H3C] info-center timestamp loghost date [H3C] info-center loghost 192.168.1.100 port 514 facility local7 [H3C] undo info-center source default loghost [H3C] info-center source default loghost level informational [H3C] save
הגדרה לדוגמה למודולים ספציפיים
בדוגמה הבאה מוצגת הגדרה לשליחת יומני מודולים של ARP ו-IP ברמת מידע למארח יומנים:
<H3C> system-view [H3C] info-center enable [H3C] info-center loghost 192.168.1.100 port 514 facility local7 [H3C] undo info-center source default loghost [H3C] info-center source arp loghost level informational [H3C] info-center source ip loghost level informational [H3C] save
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
| extensions.auth.type | סוג האימות שבו נעשה שימוש באירוע | |
| שם המארח | intermediary.asset.hostname | שם המארח של הנכס שמשויך למתווך |
| שם המארח | intermediary.hostname | שם המארח של הישות המתווכת |
| inter_ip | intermediary.asset.ip | כתובת ה-IP של הנכס שמשויך לגורם המתווך |
| inter_ip | intermediary.ip | כתובת ה-IP של הישות המתווכת |
| IPAddr, prin_ip | principal.asset.ip | כתובת ה-IP של הנכס שמשויך לחשבון המשתמש |
| IPAddr, prin_ip | principal.ip | כתובת ה-IP של הישות הראשית |
| prin_port | principal.port | מספר היציאה שמשויך למשתמש הראשי |
| משתמש, משתמשת | principal.user.userid | מזהה המשתמש של הישות המורשית |
| tar_host | target.asset.hostname | שם המארח של הנכס שמשויך ליעד |
| tar_host | target.hostname | שם המארח של ישות היעד |
| tar_ip | target.asset.ip | כתובת ה-IP של הנכס שמשויך ליעד |
| tar_ip | target.ip | כתובת ה-IP של ישות היעד |
| tar_port | target.port | מספר היציאה שמשויך ליעד |
| tar_user | target.user.userid | מזהה המשתמש של היעד |
| Line, OperateType, OperateTime, OperateState, OperateEndTime, EventIndex, CommandSource, ConfigSource, ConfigDestination | additional.fields | שדות מטא-נתונים נוספים שלא נכללים בשדות UDM רגילים |
| desc | metadata.description | תיאור האירוע |
| חותמת זמן | metadata.event_timestamp | חותמת הזמן של האירוע |
| metadata.event_type | סוג האירוע (למשל, USER_LOGIN, NETWORK_CONNECTION) | |
| event_type | metadata.product_event_type | מזהה סוג אירוע ספציפי למוצר |
| metadata.product_name | שם המוצר שיוצר את האירוע | |
| metadata.vendor_name | שם הספק של המוצר | |
observer_asset_id |
event.idm.read_only_udm.observer.asset_id |
מופה מיומן השינויים |
observer_hostname |
event.idm.read_only_udm.observer.hostname וגם event.idm.read_only_udm.observer.asset.hostname |
מופה מיומן השינויים |
severity |
event.idm.read_only_udm.security_result.severity_details |
מופה מיומן השינויים |
severityName |
event.idm.read_only_udm.security_result.severity |
מופה מיומן השינויים |
duplicate_ip |
event.idm.read_only_udm.principal.ip וגם event.idm.read_only_udm.principal.asset.ip |
מופה מיומן השינויים |
facility |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
facilityName |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
id |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
interface |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
host |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
device_type |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
dev_ip |
event.idm.read_only_udm.target.ip וגם event.idm.read_only_udm.target.asset.ip |
מופה מיומן השינויים |
program |
event.idm.read_only_udm.metadata.product_event_type |
מופה מיומן השינויים |
security_result |
event.idm.read_only_udm.security_result |
מופה מיומן השינויים |
product_event_type |
event.idm.read_only_udm.metadata.product_event_type |
מופה מיומן השינויים |
src_ip |
event.idm.read_only_udm.principal.ip |
מופה מיומן השינויים |
src_ip |
event.idm.read_only_udm.principal.asset.ip |
מופה מיומן השינויים |
dest_ip |
event.idm.read_only_udm.target.ip |
מופה מיומן השינויים |
dest_ip |
event.idm.read_only_udm.target.asset.ip |
מופה מיומן השינויים |
hostname |
event.idm.read_only_udm.intermediary.hostname |
מופה מיומן השינויים |
hostname |
event.idm.read_only_udm.intermediary.asset.hostname |
מופה מיומן השינויים |
timestamp |
event.idm.read_only_udm.metadata.event_timestamp |
מופה מיומן השינויים |
inter_ip |
event.idm.read_only_udm.metadata.intermediary.ip |
מופה מיומן השינויים |
inter_ip |
event.idm.read_only_udm.metadata.intermediary.asset.ip |
מופה מיומן השינויים |
Line |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
OperateType |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
OperateTime |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
OperateState |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
OperateEndTime |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
EventIndex |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
CommandSource |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
ConfigSource |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
ConfigDestination |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
IPAddr |
event.idm.read_only_udm.principal.ip |
מופה מיומן השינויים |
IPAddr |
event.idm.read_only_udm.principal.asset.ip |
מופה מיומן השינויים |
User |
event.idm.read_only_udm.principal.user.userid |
מופה מיומן השינויים |
prin_ip |
event.idm.read_only_udm.principal.ip |
מופה מיומן השינויים |
prin_ip |
event.idm.read_only_udm.principal.asset.ip |
מופה מיומן השינויים |
prin_port |
event.idm.read_only_udm.principal.port |
מופה מיומן השינויים |
tar_ip |
event.idm.read_only_udm.target.ip |
מופה מיומן השינויים |
tar_ip |
event.idm.read_only_udm.target.asset.ip |
מופה מיומן השינויים |
tar_host |
event.idm.read_only_udm.target.hostname |
מופה מיומן השינויים |
tar_port |
event.idm.read_only_udm.target.port |
מופה מיומן השינויים |
tar_user |
event.idm.read_only_udm.target.user.userid |
מופה מיומן השינויים |
user |
event.idm.read_only_udm.principal.user.userid |
מופה מיומן השינויים |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.