איסוף יומני One Identity TPAM
במאמר הזה מוסבר איך להטמיע יומני One Identity TPAM ב-Google Security Operations באמצעות Bindplane.
One Identity Privileged Access Manager (TPAM) הוא פתרון מדור קודם לניהול הרשאות גישה מיוחדות, שמספק ניהול סיסמאות מרכזי, מעקב אחרי סשנים ופיקוח על חשבונות עם הרשאות מיוחדות בסביבות ארגוניות. מערכת TPAM יוצרת יומני פעילות של אחזור סיסמאות, פעולות ניהול מערכת ופעילויות של סשנים עם הרשאות.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מכונה של Google SecOps
- Windows Server 2016 ואילך, או מארח Linux עם
systemd - קישוריות רשת בין סוכן Bindplane לבין מכשיר One Identity TPAM
- אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
- גישה עם הרשאות לממשק הניהול באינטרנט של One Identity TPAM
- מכשיר TPAM מוגדר ופועל
קבלת פרטי כניסה ל-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/tpam: 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: ONEIDENTITY_TPAM raw_log_field: body ingestion_labels: source: tpam service: pipelines: logs/tpam_to_chronicle: receivers: - udplog exporters: - chronicle/tpam
פרמטרים להגדרה
מחליפים את ה-placeholders הבאים:
הגדרת המקלט:
-
listen_address: כתובת ה-IP והיציאה להאזנה-
0.0.0.0:514מאזין לכל הממשקים ביציאה 514 (יציאת syslog רגילה) - אם מפעילים כמשתמש שאינו משתמש Root ב-Linux, צריך להשתמש ב-
0.0.0.0:1514 - TPAM תומך רק ב-UDP syslog, ולכן נדרש מקלט
udplog
-
-
הגדרת הייצוא:
-
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: צריך להיותONEIDENTITY_TPAMבדיוק כמו שמוצג-
ingestion_labels: תוויות אופציונליות לסינון ולארגון
-
הגדרה לדוגמה ל-Linux (משתמש בלי הרשאות root)
receivers: udplog: listen_address: "0.0.0.0:1514" exporters: chronicle/tpam: 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: 'a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6' endpoint: chronicle.googleapis.com log_type: ONEIDENTITY_TPAM raw_log_field: body ingestion_labels: env: production source: tpam service: pipelines: logs/tpam_to_chronicle: receivers: - udplog exporters: - chronicle/tpamהגדרה לדוגמה ל-Windows
receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/tpam: 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: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: 'a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6' endpoint: chronicle.googleapis.com log_type: ONEIDENTITY_TPAM raw_log_field: body ingestion_labels: env: production source: tpam service: pipelines: logs/tpam_to_chronicle: receivers: - udplog exporters: - chronicle/tpam
מייצא API להטמעה מדור קודם
אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק
exportersבקוד הבא. מגדירים אתcreds_file_pathלנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים אתmalachiteingestion-pa.googleapis.comבנקודת הקצה האזורית (לדוגמה,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/tpam: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: malachiteingestion-pa.googleapis.com log_type: ONEIDENTITY_TPAM raw_log_field: body ingestion_labels: source: tpam
שמירת קובץ התצורה
- אחרי שמסיימים לערוך, שומרים את הקובץ:
- 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 ב-One Identity TPAM
מגדירים את TPAM כך שיעביר הודעות syslog לסוכן Bindplane.
- נכנסים לממשק הניהול באינטרנט של One Identity TPAM.
- עוברים אל /admin.
- בתפריט הניווט הימני, עוברים אל System Status (סטטוס המערכת) > SysLog Configuration (הגדרת SysLog).
- בדף SysLog Configuration, מזינים את פרטי ההגדרה הבאים:
- שרת SysLog: מזינים את כתובת ה-IP של המארח של סוכן Bindplane (לדוגמה,
192.168.1.100). - יציאה: מזינים את מספר היציאה שהוגדר בסוכן Bindplane (לדוגמה,
514או1514).- יציאת ברירת המחדל היא
514 - אם משתמשים בסוכן Bindplane שאינו ברמת הבסיס (root) ב-Linux, צריך להשתמש בגרסה
1514ואילך
- יציאת ברירת המחדל היא
- פרוטוקול: TPAM תומך רק ב-UDP להעברת syslog.
- שרת SysLog: מזינים את כתובת ה-IP של המארח של סוכן Bindplane (לדוגמה,
- לוחצים על שמירה או על אישור כדי לשמור את ההגדרה.
- לוחצים על Test Connection, אם האפשרות זמינה, כדי לאמת את הקישוריות לסוכן Bindplane.
- אם יש מתג נפרד להפעלה או להשבתה, מפעילים את העברת ה-syslog.
הערה: TPAM שולח הודעות syslog בפורמט קנייני מותאם אישית (לא תואם ל-CEF). הפורמט כולל שני סוגי יומנים:
- דוח פעילות (tpam): אחזורי סיסמאות, פעולות מערכת ופעילויות גישה עם הרשאות
- יומן פעילות של מנהל מערכת (sysadmin): פעולות ניהול ושינויים בהגדרות
הפורמט של הודעת syslog הוא במבנה הבא:
PAR[PID]: UserName/AdminName, Operation, ObjectType, Target/ObjectName, Role, Failed, OtherInfo
אימות של העברת syslog
- מבצעים פעולת בדיקה ב-TPAM (לדוגמה, מאחזרים סיסמה או משנים מערכת).
בודקים את יומני הסוכן של Bindplane כדי לוודא שהודעות syslog מתקבלות:
- Linux:
sudo journalctl -u observiq-otel-collector -f | grep -i tpam- Windows:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log" | findstr /i "tpam"נכנסים למסוף Google SecOps ומוודאים שהיומנים מופיעים בממשק Search.
פתרון בעיות בקישוריות של syslog
אם הודעות syslog לא מתקבלות:
בודקים את החיבור לרשת בין מכשיר ה-TPAM לבין סוכן Bindplane:
ping <bindplane_agent_ip>מוודאים שיציאת ה-UDP פתוחה ומאזינה לסוכן Bindplane:
Linux:
sudo netstat -ulnp | grep 514Windows:
netstat -an | findstr :514
בודקים שכללי חומת האש מאפשרים תעבורת UDP ביציאה שהוגדרה:
- מקור: כתובת ה-IP של מכשיר ה-TPAM
- יעד: כתובת ה-IP של סוכן Bindplane
- פרוטוקול: UDP
- יציאה: 514 (או היציאה שהוגדרה)
מוודאים שההגדרה של TPAM syslog נשמרה ופעילה:
כניסה לממשק האינטרנט של TPAM
עוברים אל /admin > System Status > SysLog Configuration
מוודאים שכתובת ה-IP והיציאה נכונות
בדיקת החיבור, אם הוא זמין
בודקים אם יש שגיאות ביומני המערכת של TPAM שקשורות לשליחת syslog:
- עוברים אל /admin > System Status > יומני מערכת
- חיפוש הודעות שגיאה שקשורות ל-syslog
למידע נוסף על פתרון בעיות, אפשר לעיין במדריך לפתרון בעיות ב-syslog של One Identity TPAM.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
| cn1 | additional.fields | נתוני אירועים נוספים שספציפיים לספק, שלא ניתן לייצג אותם בצורה הולמת בקטעים הרשמיים של מודל ה-UDM |
| cn1Label | additional.fields | |
| cs1 | additional.fields | |
| cs1Label | additional.fields | |
| cs2 | additional.fields | |
| cs2Label | additional.fields | |
| cs3 | additional.fields | |
| cs3Label | additional.fields | |
| cs4 | additional.fields | |
| cs4Label | additional.fields | |
| cs5 | additional.fields | |
| cs5Label | additional.fields | |
| cs6 | additional.fields | |
| cs6Label | additional.fields | |
| msg | metadata.description | תיאור האירוע |
| metadata.event_type | metadata.event_type | סוג האירוע (למשל, USER_LOGIN, NETWORK_CONNECTION) |
| eventid | metadata.product_event_type | סוג אירוע ספציפי למוצר |
| logmsg | metadata.product_event_type | |
| גרסה | metadata.product_version | גרסת המוצר |
| שם המארח | principal.asset.hostname | שם המארח של הנכס שמשויך לחשבון הראשי |
| groupName | principal.group.group_display_name | השם המוצג של הקבוצה |
| שם המארח | principal.hostname | שם המארח של הישות המורשית |
| cs1 | principal.user.attribute.roles | תפקידים שמשויכים למשתמש |
| deviceCustomDate1 | security_result.detection_fields | שדות שמשמשים לזיהוי |
| deviceCustomDate1Label | security_result.detection_fields | |
| reason | security_result.summary | סיכום של תוצאת האבטחה |
| destinationDnsDomain | target.domain.name | שם דומיין היעד |
| cn1 | target.resource.product_object_id | מזהה האובייקט הספציפי למוצר של משאב המטרה |
| requestUrl | target.url | כתובת ה-URL של היעד |
| duser | target.user.user_display_name | השם המוצג של משתמש היעד |
| duid | target.user.userid | מזהה המשתמש של משתמש היעד |
| logmessage | metadata.product_name | שם המוצר |
| logtype | metadata.vendor_name | שם הספק |
timestamp |
event.idm.read_only_udm.metadata.event_timestamp |
מופה מיומן השינויים |
cn2 |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
cn3 |
event.idm.read_only_udm.additional.fields |
מופה מיומן השינויים |
cs2", "cs3", "cs4", "cs5", "cs6 |
additional.fields |
מופה מיומן השינויים |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.