איסוף יומני 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. נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט ב- Google Cloud שמקושר למכונה של Google SecOps.
  2. נכנסים לדף IAM & Admin > Service Accounts.
  3. לוחצים על Create service account.
  4. מזינים את פרטי ההגדרה הבאים:
    • Service account name: מזינים שם לחשבון (לדוגמה, bindplane-ingest).
    • Service account description: מזינים תיאור (לדוגמה, Bindplane agent log ingestion).
  5. לוחצים על Create and continue.
  6. בקטע Grant this service account access to project, לוחצים על Select a role ובוחרים באפשרות Chronicle Editor.
  7. לוחצים על המשך ואז על סיום.
  8. לוחצים על חשבון השירות שיצרתם ועוברים לכרטיסייה Keys.
  9. לוחצים על Add key > Create new key.
  10. בוחרים באפשרות JSON ולוחצים על Create. קובץ המפתח יורד למחשב.
  11. שומרים את קובץ המפתח בתור 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 כך שיתאים לנתיב שבו שמרתם אותו.
  12. עוברים אל IAM & Admin > Settings ומעתיקים את הערך של Project number. תצטרכו אותו כדי להגדיר את הייצוא.

אפשרות 2: הורדה של קובץ האימות להטמעת נתונים (גרסה קודמת)

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל הגדרות > ניהול נתונים > סוכני איסוף. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > סוכני איסוף.
  3. מורידים את קובץ האימות להטמעת נתונים.
  4. שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן הסוכן של Bindplane.

איך מקבלים את מספר הלקוח ב-Google SecOps

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל הגדרות > ניהול > פרופיל. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פרופיל.
  3. מעתיקים את מספר הלקוח מהקטע פרטי הארגון ושומרים אותו.

התקנת הסוכן של Bindplane

מתקינים את הסוכן של Bindplane במערכת ההפעלה Windows או Linux לפי ההוראות הבאות.

התקנת חלונות

  1. פותחים את שורת הפקודה או את PowerShell כאדמין.
  2. מריצים את הפקודה הבאה:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. מחכים שההתקנה תסתיים.

  4. כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:

    sc query observiq-otel-collector
    

    השירות אמור להופיע כ-RUNNING.

התקנה ב-Linux

  1. פותחים טרמינל עם הרשאות root או sudo.
  2. מריצים את הפקודה הבאה:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. מחכים שההתקנה תסתיים.

  4. כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:

    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/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
    • ‫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: לוחצים על קובץ > שמירה

מפעילים מחדש את הסוכן של Bindplane כדי להחיל את השינויים.

כדי להפעיל מחדש את סוכן Bindplane ב-Linux:

  1. מריצים את הפקודה הבאה:

    sudo systemctl restart observiq-otel-collector
    
  2. מוודאים שהשירות פועל:

    sudo systemctl status observiq-otel-collector
    
  3. בודקים אם יש שגיאות ביומנים:

    sudo journalctl -u observiq-otel-collector -f
    

כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows:

  1. בוחרים אחת מהאפשרויות האלה:

    • שורת הפקודה או PowerShell כאדמין:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • מסוף השירותים:
      1. לוחצים על Win+R, מקלידים services.msc ולוחצים על Enter.
      2. מאתרים את observIQ OpenTelemetry Collector.
      3. לוחצים לחיצה ימנית ובוחרים באפשרות הפעלה מחדש.
  2. מוודאים שהשירות פועל:

    sc query observiq-otel-collector
    
  3. בודקים אם יש שגיאות ביומנים:

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    

הגדרת העברת syslog ב-One Identity TPAM

מגדירים את TPAM כך שיעביר הודעות syslog לסוכן Bindplane.

  1. נכנסים לממשק הניהול באינטרנט של One Identity TPAM.
  2. עוברים אל ‎/admin.
  3. בתפריט הניווט הימני, עוברים אל System Status (סטטוס המערכת) > SysLog Configuration (הגדרת SysLog).
  4. בדף SysLog Configuration, מזינים את פרטי ההגדרה הבאים:
    • שרת SysLog: מזינים את כתובת ה-IP של המארח של סוכן Bindplane (לדוגמה, 192.168.1.100).
    • יציאה: מזינים את מספר היציאה שהוגדר בסוכן Bindplane (לדוגמה, 514 או 1514).
      • יציאת ברירת המחדל היא 514
      • אם משתמשים בסוכן Bindplane שאינו ברמת הבסיס (root) ב-Linux, צריך להשתמש בגרסה 1514 ואילך
    • פרוטוקול: TPAM תומך רק ב-UDP להעברת syslog.
  5. לוחצים על שמירה או על אישור כדי לשמור את ההגדרה.
  6. לוחצים על Test Connection, אם האפשרות זמינה, כדי לאמת את הקישוריות לסוכן Bindplane.
  7. אם יש מתג נפרד להפעלה או להשבתה, מפעילים את העברת ה-syslog. הערה: TPAM שולח הודעות syslog בפורמט קנייני מותאם אישית (לא תואם ל-CEF). הפורמט כולל שני סוגי יומנים:
    • דוח פעילות (tpam): אחזורי סיסמאות, פעולות מערכת ופעילויות גישה עם הרשאות
    • יומן פעילות של מנהל מערכת (sysadmin): פעולות ניהול ושינויים בהגדרות
  • הפורמט של הודעת syslog הוא במבנה הבא:

    PAR[PID]: UserName/AdminName, Operation, ObjectType, Target/ObjectName, Role, Failed, OtherInfo
    

אימות של העברת syslog

  1. מבצעים פעולת בדיקה ב-TPAM (לדוגמה, מאחזרים סיסמה או משנים מערכת).
  2. בודקים את יומני הסוכן של 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"
    
  3. נכנסים למסוף Google SecOps ומוודאים שהיומנים מופיעים בממשק Search.

פתרון בעיות בקישוריות של syslog

אם הודעות syslog לא מתקבלות:

  1. בודקים את החיבור לרשת בין מכשיר ה-TPAM לבין סוכן Bindplane:

    ping <bindplane_agent_ip>
    
  2. מוודאים שיציאת ה-UDP פתוחה ומאזינה לסוכן Bindplane:

    • Linux:

      sudo netstat -ulnp | grep 514
      
    • Windows:

      netstat -an | findstr :514
      
  3. בודקים שכללי חומת האש מאפשרים תעבורת UDP ביציאה שהוגדרה:

    • מקור: כתובת ה-IP של מכשיר ה-TPAM
    • יעד: כתובת ה-IP של סוכן Bindplane
    • פרוטוקול: UDP
    • יציאה: 514 (או היציאה שהוגדרה)

מוודאים שההגדרה של TPAM syslog נשמרה ופעילה:

  1. כניסה לממשק האינטרנט של TPAM

  2. עוברים אל ‎/admin > System Status > SysLog Configuration

  3. מוודאים שכתובת ה-IP והיציאה נכונות

  4. בדיקת החיבור, אם הוא זמין

בודקים אם יש שגיאות ביומני המערכת של TPAM שקשורות לשליחת syslog:

  1. עוברים אל ‎/admin > System Status > יומני מערכת
  2. חיפוש הודעות שגיאה שקשורות ל-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.