איסוף יומנים של Symantec VIP Enterprise Gateway
במסמך הזה מוסבר איך להטמיע ב-Google Security Operations יומנים של Symantec VIP Enterprise Gateway באמצעות סוכן Bindplane.
Symantec VIP (Validation and ID Protection) Enterprise Gateway הוא פתרון לאימות רב-שלבי שיוצר הודעות syslog לאירועי אימות, אימות פרטי כניסה, סנכרון LDAP ופעילות של בדיקת תקינות. המנתח מחלץ שדות מיומנים בפורמט JSON ובפורמט syslog וממפה אותם למודל הנתונים המאוחד (UDM).
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מכונה של Google SecOps
- Windows Server 2016 ואילך, או מארח Linux עם
systemd - קישוריות רשת בין סוכן Bindplane לבין Symantec VIP Gateway
- אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
- הרשאת אדמין לממשק המשתמש באינטרנט של Symantec VIP Gateway
קבלת פרטי כניסה ל-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/symantec_vip: 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: '<customer_id>' endpoint: chronicle.googleapis.com log_type: SYMANTEC_VIP raw_log_field: body service: pipelines: logs/symantec_vip_to_chronicle: receivers: - udplog exporters: - chronicle/symantec_vip
פרמטרים להגדרה
מחליפים את ה-placeholders הבאים:
הגדרת המקלט:
-
listen_address: כתובת ה-IP והיציאה להאזנה:-
0.0.0.0כדי להאזין בכל הממשקים (מומלץ) - יציאה
514היא יציאת syslog הרגילה (נדרש root ב-Linux; צריך להשתמש ב-1514ללא root)
-
-
הגדרת הייצוא:
-
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: מספר הלקוח שהועתק ממסוף 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/symantec_vip: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: SYMANTEC_VIP 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 ב-Symantec VIP Enterprise Gateway
- נכנסים לממשק המשתמש באינטרנט של Symantec VIP Gateway.
- עוברים אל Logs > Syslog Configuration.
- אם מגדירים את Syslog בפעם הראשונה, בוחרים באפשרות כן כשמופיעה בקשה. אם ההגדרה כבר נקבעה, לוחצים על עריכה.
- מזינים את פרטי ההגדרה הבאים:
- Syslog Facility: בוחרים באפשרות LOG_LOCAL0.
- Syslog Host: מזינים את כתובת ה-IP של סוכן Bindplane.
- יציאת Syslog: מזינים את מספר היציאה של סוכן Bindplane (לדוגמה,
514ל-UDP).
- לוחצים על Save.
- עוברים אל הגדרות > הגדרות המסוף.
- מזינים את פרטי ההגדרה הבאים:
- Logging Level (רמת רישום ביומן): בוחרים באפשרות Info (מידע).
- הפעלת Syslog: בוחרים באפשרות כן.
- לוחצים על שליחה.
- עוברים אל הגדרות > הגדרות של בדיקת תקינות.
- בוחרים באפשרות כן כדי להפעיל את שירות בדיקת התקינות.
- מזינים את פרטי ההגדרה הבאים:
- Logging Level (רמת רישום ביומן): בוחרים באפשרות Info (מידע).
- הפעלת Syslog: בוחרים באפשרות כן.
- לוחצים על שליחה.
- עוברים אל User Store > LDAP Directory Synchronization.
- עורכים את פרטי ההגדרה הבאים:
- Log Level: בוחרים באפשרות Info.
- הפעלת Syslog: בוחרים באפשרות כן.
- לוחצים על שליחה.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
| אפליקציה | read_only_udm.principal.application | הערך נלקח מהשדה application שחולץ על ידי מסנן JSON. |
| פקודה | read_only_udm.target.process.command_line | הערך נלקח מהשדה command שחולץ על ידי תבנית grok. |
| credentialType | השדה הזה לא ממופה ישירות ל-UDM. הוא משמש להפקת הערך של read_only_udm.extensions.auth.mechanism. | |
| נתונים | השדה הזה לא ממופה ישירות ל-UDM. הוא מנותח כדי לחלץ שדות אחרים. | |
| data2 | השדה הזה לא ממופה ישירות ל-UDM. הוא מנותח כדי לחלץ שדות אחרים. | |
| datetime | read_only_udm.metadata.event_timestamp.seconds read_only_udm.metadata.event_timestamp.nanos |
שניות וננו-שניות מאז תחילת התקופה שחולצו מהשדה datetime. |
| desc | read_only_udm.metadata.description | הערך נלקח מהשדה desc שחולץ על ידי מסנן JSON. |
| description | read_only_udm.security_result.description | הערך נלקח מהשדה description שחולץ על ידי מסנן JSON. |
| filename | read_only_udm.target.process.file.full_path | הערך נלקח מהשדה filename שחולץ על ידי תבנית grok. |
| שם המארח | read_only_udm.principal.hostname | הערך נלקח מהשדה hostname שחולץ על ידי מסנן JSON. |
| host_name | read_only_udm.intermediary.hostname | הערך נלקח מהשדה host_name שחולץ על ידי מסנן JSON. |
| log_level | השדה הזה לא ממופה ישירות ל-UDM. הוא משמש להפקת הערך של read_only_udm.security_result.severity. | |
| log_type | read_only_udm.metadata.product_event_type | הערך נלקח מהשדה log_type שחולץ על ידי מסנן JSON. |
| msg | השדה הזה לא ממופה ישירות ל-UDM. הוא מנותח כדי לחלץ שדות אחרים. | |
| פעולה | read_only_udm.security_result.summary | הערך נלקח מהשדה operation שחולץ על ידי תבנית grok. |
| processid | read_only_udm.target.process.pid | הערך נלקח מהשדה processid שחולץ על ידי תבנית grok. |
| מוצר | read_only_udm.metadata.product_name | הערך נלקח מהשדה product שחולץ על ידי מסנן JSON. |
| reason | read_only_udm.metadata.description | הערך נלקח מהשדה reason שחולץ על ידי תבנית grok. |
| request_id | read_only_udm.target.resource.id | הערך נלקח מהשדה request_id שחולץ על ידי תבנית grok. |
| src_ip | read_only_udm.principal.ip | הערך נלקח מהשדה src_ip שחולץ על ידי תבנית grok. |
| סטטוס | read_only_udm.metadata.description | הערך נלקח מהשדה status שחולץ על ידי תבנית grok. |
| סיכום | read_only_udm.security_result.summary | הערך נלקח מהשדה summary שחולץ על ידי מסנן JSON. |
| timestamp.nanos | read_only_udm.metadata.event_timestamp.nanos | ננו-שניות מחותמת הזמן המקורית של היומן. |
| timestamp.seconds | read_only_udm.metadata.event_timestamp.seconds | שניות מחותמת הזמן המקורית של היומן. |
| פעם | השדה הזה לא ממופה ישירות ל-UDM. הוא משמש להפקת הערכים של read_only_udm.metadata.event_timestamp.seconds ו-read_only_udm.metadata.event_timestamp.nanos. | |
| משתמש | read_only_udm.target.user.userid | הערך נלקח מהשדה user שחולץ על ידי מסנן JSON או תבנית Grok. |
| ספק | read_only_udm.metadata.vendor_name | הערך נלקח מהשדה vendor שחולץ על ידי מסנן JSON. |
| read_only_udm.extensions.auth.mechanism | נקבע לפי השדה credentialType. אם credentialType הוא SMS_OTP או STANDARD_OTP, נעשה שימוש ב-OTP. אם credentialType תואם לביטוי הרגולרי PASSWORD, המערכת תשתמש ב-USERNAME_PASSWORD. |
|
| read_only_udm.extensions.auth.type | אם השדה reason תואם לביטוי הרגולרי LDAP, המערכת תשתמש ב-SSO. אחרת, נעשה שימוש ב-AUTHTYPE_UNSPECIFIED. |
|
| read_only_udm.metadata.event_type | נקבע לפי הנוכחות של שדות מסוימים. אם השדה user או processid לא ריק, המערכת משתמשת ב-USER_LOGIN. אם user ריק ו-src_ip לא ריק או 0.0.0.0, אז נעשה שימוש ב-STATUS_UPDATE. אחרת, נעשה שימוש ב-GENERIC_EVENT. |
|
| read_only_udm.metadata.log_type | מקודד בתוך הקוד ל-SYMANTEC_VIP. |
|
| read_only_udm.security_result.action | נקבע לפי השדה status. אם הערך של status הוא Authentication Success, GRANTED, Authentication Completed, After Services Authenticate call או CHALLENGED, המערכת משתמשת ב-ALLOW. אם הערך של status הוא DENIED, Acces-Reject, Unknown Error, Service Unavailable או FAILED, המערכת משתמשת ב-BLOCK. אם status הוא PUSH request sent for user או Trying to fetch attribute, נעשה שימוש ב-QUARANTINE. |
|
| read_only_udm.security_result.severity | נקבע לפי השדה log_level. אם הערך של log_level הוא DEBUG, INFO או AUDIT, המערכת משתמשת ב-INFORMATIONAL. אם הערך של log_level הוא ERROR, המערכת משתמשת ב-ERROR. אם הערך של log_level הוא WARNING, המערכת משתמשת ב-MEDIUM. |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.