איסוף יומנים של Ribbon Analytics Platform

נתמך ב:

במאמר הזה מוסבר איך להטמיע יומנים של Ribbon Analytics Platform ב-Google Security Operations באמצעות סוכן Bindplane.

‫Ribbon Analytics Platform היא פלטפורמה לניתוח נתונים ברשת ולבקרת גבולות של סשנים, שמשמשת למעקב אחרי תקשורת קולית ותקשורת נתונים. הוא יוצר הודעות syslog לרשומות של פרטי שיחות, אירועי סשן ומידע על תקינות המערכת.

לפני שמתחילים

חשוב לוודא שיש לכם את הדברים הבאים:

  • מכונה של Google SecOps
  • ‫Windows Server 2016 ואילך, או מארח Linux עם systemd
  • קישוריות רשת בין סוכן Bindplane לבין Ribbon Analytics Platform
  • אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
  • גישה מיוחדת לממשק הניהול של Ribbon Analytics Platform

קבלת פרטי כניסה ל-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/ribbon_analytics:
        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: RIBBON_ANALYTICS_PLATFORM
        raw_log_field: body
    
    service:
      pipelines:
        logs/ribbon_analytics_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/ribbon_analytics
    

פרמטרים להגדרה

מחליפים את ה-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
    • ‫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/ribbon_analytics:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: RIBBON_ANALYTICS_PLATFORM
        raw_log_field: body
    

שמירת קובץ התצורה

  • אחרי שמסיימים לערוך, שומרים את הקובץ:
    • Linux: לוחצים על Ctrl+O, אחר כך על Enter ואז על Ctrl+X
    • Windows: לוחצים על קובץ > שמירה

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

  • כדי להפעיל מחדש את הסוכן של Bindplane ב-Linux, מריצים את הפקודה הבאה:

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

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

      sudo journalctl -u observiq-otel-collector -f
      
  • כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows, בוחרים באחת מהאפשרויות הבאות:

    • שורת הפקודה או PowerShell כאדמין:

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • מסוף השירותים:

      1. לוחצים על Win+R, מקלידים services.msc ולוחצים על Enter.
      2. מאתרים את observIQ OpenTelemetry Collector.
      3. לוחצים לחיצה ימנית ובוחרים באפשרות הפעלה מחדש.
      4. מוודאים שהשירות פועל:

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

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

הגדרת העברת syslog של Ribbon Analytics Platform

  1. נכנסים לממשק הניהול של Ribbon.
  2. עוברים אל הגדרות > שרתי יומנים מרוחקים.
  3. מוסיפים שרת יומנים מרוחק חדש עם ההגדרות הבאות:
    • ‫Host: כתובת ה-IP של המארח של סוכן Bindplane.
    • יציאה: מזינים 514.
    • פרוטוקול: בוחרים באפשרות UDP.
  4. לוחצים על Save.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
type_name about מופה: SYSCALL ← about
type_syscall_props.AUID about.user.user_display_name מיפוי ישיר
type_syscall_props.auid about.user.userid מיפוי ישיר
additional_delay_data additional.fields ממוזג
additional_delays_data additional.fields ממוזג
additional_dns_data additional.fields ממוזג
additional_field additional.fields ממוזג
additional_relay_data additional.fields ממוזג
auth_realm_field additional.fields ממוזג
log_details_label additional.fields ממוזג
_mechanism extensions.auth.mechanism ממוזג
audit_message extensions.auth.type Mapped: `type=(SYSCALL/LOGIN/USER_LOGIN/USER_CMD/USER_ACCT/USER_ROLE_CHANGE/USERSTART/USER...
msg2 extensions.auth.type מופה: login failure ← MACHINE
type_name extensions.auth.type מופה: USER_LOGIN ← MACHINE, ‏"LOGIN", "USER_START", "USER_AUTH", "CRED_ACQ", "CRED_REF...
dvc intermediary.hostname מיפוי ישיר
dvc intermediary.ip ממוזג
description metadata.description מיפוי ישיר
error_message metadata.description מיפוי ישיר
msg2 metadata.description מיפוי ישיר
event_timestamp metadata.event_timestamp נותח בתור UNIX
timestamp metadata.event_timestamp נותח בתור MMM d HH:mm:ss
event_type metadata.event_type מופה: GENERIC_EVENT ← STATUS_UPDATE
has_principal metadata.event_type מופה: true ← STATUS_UPDATE
msg2 metadata.event_type מופה: HTTP ← NETWORK_HTTP, login failure ← USER_LOGIN
target_user_present metadata.event_type מופה: true ← USER_UNCATEGORIZED
type_name metadata.event_type מופה: SYSCALL ← USER_UNCATEGORIZED
applica metadata.product_event_type מיפוי ישיר
audit_message metadata.product_event_type ערכים ממופים (6 בסך הכול, למשל pam_krb5.*authentication fails for ← PAM_KRB5_AUTH_ERROR, `...
eventType metadata.product_event_type מיפוי ישיר
p_event_type metadata.product_event_type מיפוי ישיר
type metadata.product_event_type מיפוי ישיר
type_name metadata.product_event_type מיפוי ישיר
jsonPayload._AUDIT_ID metadata.product_log_id מיפוי ישיר
product_log_id metadata.product_log_id מיפוי ישיר
audit_message network.application_protocol מופה: type=(CRYPTO_SESSION/CRYPTO_KEY_USER) ← SSH
auth network.application_protocol מופה: ssh ← SSH
message network.application_protocol מופה: ssh/ssh2 ← SSH
tty network.application_protocol מופה: ssh ← SSH
audit_message network.direction Mapped: type=(CRYPTO_SESSION/CRYPTO_KEY_USER) → OUTBOUND, `type=(CRYPTO_SESSION/CRYPTO_K...
mailid network.email.mail_id מיפוי ישיר
to_email network.email.to מופה: ^.+@.+$ ← to_email
response_code network.http.response_code מיפוי ישיר
audit_message network.ip_protocol מופה: type=(CRYPTO_SESSION/CRYPTO_KEY_USER) ← TCP
bytes_sent network.sent_bytes מיפוי ישיר
type_crypto_props.ksize network.sent_bytes שינוי שם/מיפוי
jsonPayload._AUDIT_SESSION network.session_id מיפוי ישיר
sessionid network.session_id מיפוי ישיר
type_anom_props.ses network.session_id שינוי שם/מיפוי
type_syscall_props.ses network.session_id מיפוי ישיר
type_crypto_props.cipher network.tls.cipher מיפוי ישיר
type_crypto_props.pfs network.tls.curve מיפוי ישיר
applica principal.application מיפוי ישיר
jsonPayload._COMM principal.application מיפוי ישיר
type_anom_props.comm principal.application מיפוי ישיר
type_syscall_props.comm principal.application מיפוי ישיר
type_syscall_props.terminal principal.application מיפוי ישיר
%{rhost} principal.asset.hostname ממוזג
rhost principal.asset.hostname ממופה כש-kvdata != ''‎
princi_ip principal.asset.ip ממוזג
rhost principal.asset.ip ממוזג
srcIp principal.asset.ip ממופה: `^(?:(25[0-5]/2[0-4][0-9]/1[0-9]{2}/[1-9]?[0-9]).){3}(25[0-5]/2[0-4][0-9]/1[0-9]{2}...
%{rhost} principal.hostname ממוזג
jsonPayload._HOSTNAME principal.hostname מיפוי ישיר
principal_hostname principal.hostname מיפוי ישיר
rhost principal.hostname ממופה כש-kvdata != ''‎
audit_message principal.ip Mapped: `type=(SYSCALL/LOGIN/USER_LOGIN/USER_CMD/USER_ACCT/USER_ROLE_CHANGE/USERSTART/USER...
prin_ip principal.ip ממוזג
princi_ip principal.ip ממוזג
rhost principal.ip ממוזג
srcIp principal.ip ממופה: `^(?:(25[0-5]/2[0-4][0-9]/1[0-9]{2}/[1-9]?[0-9]).){3}(25[0-5]/2[0-4][0-9]/1[0-9]{2}...
type_crypto_props.laddr principal.ip ממוזג
srcPort principal.port שינוי שם/מיפוי
type_crypto_props.lport principal.port שינוי שם/מיפוי
auth principal.process.command_line מיפוי ישיר
proctitle_value principal.process.command_line מיפוי ישיר
type_syscall_props.cmd principal.process.command_line מיפוי ישיר
event.idm.read_only_udm.target.process.file.full_path principal.process.file.full_path מיפוי ישיר
proctitle_value principal.process.file.full_path מיפוי ישיר
audit_message principal.process.file.names Mapped: `type=(SYSCALL/LOGIN/USER_LOGIN/USER_CMD/USER_ACCT/USER_ROLE_CHANGE/USERSTART/USER...
filename principal.process.file.names ממוזג
jsonPayload._PPID principal.process.parent_process.pid מיפוי ישיר
type_syscall_props.ppid principal.process.parent_process.pid מיפוי ישיר
jsonPayload._PID principal.process.pid מיפוי ישיר
pi principal.process.pid מיפוי ישיר
process_pid principal.process.pid מיפוי ישיר
type_crypto_props.spid principal.process.pid מיפוי ישיר
type_syscall_props.pid principal.process.pid מיפוי ישיר
email principal.user.email_addresses מופה: ^.+@.+$ ← email
user_name principal.user.email_addresses מופה: ^.+@.+$ ← user_name
type_syscall_props.UID principal.user.user_display_name מיפוי ישיר
type_syscall_props.acct principal.user.user_display_name מיפוי ישיר
jsonPayload._AUDIT_FIELD_SUID principal.user.userid מיפוי ישיר
principal_user_userid principal.user.userid מיפוי ישיר
ruser principal.user.userid מיפוי ישיר
type_crypto_props.suid principal.user.userid מיפוי ישיר
user_name principal.user.userid מיפוי ישיר
usr principal.user.userid מיפוי ישיר
a0_label security_result.about.labels ממוזג
a1_label security_result.about.labels ממוזג
a2_label security_result.about.labels ממוזג
a3_label security_result.about.labels ממוזג
audit_message security_result.about.labels ערכים ממופים (7 בסך הכול, למשל `type=(SYSCALL/LOGIN/USER_LOGIN/USER_CMD/USER_ACCT/USER_ROLE_CH...
exit_label security_result.about.labels ממוזג
syscall_label security_result.about.labels ממוזג
tty_label security_result.about.labels ממוזג
jsonPayload._AUDIT_FIELD_ARCH security_result.about.platform_version מיפוי ישיר
type_syscall_props.arch security_result.about.platform_version מיפוי ישיר
type_syscall_props.key security_result.about.registry.registry_key מיפוי ישיר
product_log_id security_result.about.registry.registry_value_data מיפוי ישיר
action security_result.action ממוזג
action_data security_result.action מיפוי: `"authentication failure", "Authentication failure", "Failed password", "Connection ...
audit_message security_result.action Mapped: `type=(SYSCALL/LOGIN/USER_LOGIN/USER_CMD/USER_ACCT/USER_ROLE_CHANGE/USERSTART/USER...
security_action security_result.action ממוזג
action_data security_result.action_details מיפוי ישיר
auth security_result.action_details מופה: sshd ← FAILURE
status security_result.action_details מיפוי ישיר
type_crypto_props.res security_result.action_details שינוי שם/מיפוי
type_syscall_props.res security_result.action_details מיפוי ישיר
a0_label security_result.detection_fields ממוזג
a1_label security_result.detection_fields ממוזג
a2_label security_result.detection_fields ממוזג
a3_label security_result.detection_fields ממוזג
audit_message security_result.detection_fields Mapped: `type=(SYSCALL/LOGIN/USER_LOGIN/USER_CMD/USER_ACCT/USER_ROLE_CHANGE/USERSTART/USER...
auid_field security_result.detection_fields ממוזג
auth security_result.detection_fields מופו: sshd ← authentication_protocol_field, sshd ← authentication_mechanism_field,...
authentication_mechanism_field security_result.detection_fields ממוזג
authentication_protocol_field security_result.detection_fields ממוזג
bootid_label security_result.detection_fields ממוזג
connection_state_field security_result.detection_fields ממוזג
cwd_field security_result.detection_fields ממוזג
exit_label security_result.detection_fields ממוזג
jsonPayload._AUDIT_TYPE_NAME security_result.rule_id מיפוי ישיר
type_name security_result.rule_id מיפוי ישיר
msg_desc security_result.summary מיפוי ישיר
secsummary security_result.summary מיפוי ישיר
type_anom_props.reason security_result.summary מיפוי ישיר
type_syscall_props.op security_result.summary מיפוי ישיר
type_syscall_props.res security_result.summary מיפוי ישיר
type_syscall_props.success security_result.summary מיפוי ישיר
type_path1_props.name src.file.full_path שינוי שם/מיפוי
type_crypto_props.terminal target.application שינוי שם/מיפוי
target_hostname target.asset.hostname מיפוי ישיר
type_crypto_props.hostname target.asset.hostname מיפוי ישיר
dst_ip target.asset.ip ממוזג
resource.labels.project_id target.cloud.project.name מיפוי ישיר
filepath target.file.full_path מיפוי ישיר
jsonPayload._AUDIT_FIELD_FILE target.file.full_path מיפוי ישיר
target_file_full_path target.file.full_path מיפוי ישיר
jsonPayload._AUDIT_FIELD_HASH target.file.sha256 מיפוי ישיר
target_hostname target.hostname מיפוי ישיר
type_crypto_props.hostname target.hostname מיפוי ישיר
audit_message target.ip מופה: type=(CRYPTO_SESSION/CRYPTO_KEY_USER) ← tar_ip
dst_ip target.ip ממוזג
tar_ip target.ip ממוזג
resource.labels.location target.location.name מיפוי ישיר
dst_port target.port מיפוי ישיר
target_port target.port מיפוי ישיר
type_crypto_props.rport target.port שינוי שם/מיפוי
args target.process.command_line שינוי שם/מיפוי
cmnd target.process.command_line מיפוי ישיר
command_line target.process.command_line מיפוי ישיר
cwd target.process.file.full_path מיפוי ישיר
jsonPayload._EXE target.process.file.full_path מיפוי ישיר
proctitle_value target.process.file.full_path מיפוי ישיר
type_anom_props.exe target.process.file.full_path שינוי שם/מיפוי
type_crypto_props.exe target.process.file.full_path שינוי שם/מיפוי
type_syscall_props.exe target.process.file.full_path מיפוי ישיר
type_anom_props.pid target.process.pid שינוי שם/מיפוי
type_crypto_props.pid target.process.pid שינוי שם/מיפוי
resource.labels.cluster_name target.resource.name מיפוי ישיר
audit_message target.resource.type Mapped: `type=(SYSCALL/LOGIN/USER_LOGIN/USER_CMD/USER_ACCT/USER_ROLE_CHANGE/USERSTART/USER...
type_name target.resource.type מופה: "USER_ACCT", "USER_ROLE_CHANGE","USER_MGMT" ← SETTING
target_email target.user.email_addresses מופה: ^.+@.+$ ← target_email
type_syscall_props.ID target.user.user_display_name מיפוי ישיר
type_syscall_props.acct target.user.user_display_name מיפוי ישיר
event.idm.read_only_udm.principal.user.userid target.user.userid שינוי שם/מיפוי
jsonPayload._UID target.user.userid מיפוי ישיר
type_crypto_props.uid target.user.userid מיפוי ישיר
type_syscall_props.acct target.user.userid מיפוי ישיר
type_syscall_props.id target.user.userid מיפוי ישיר
type_syscall_props.uid target.user.userid מיפוי ישיר
user_name target.user.userid מיפוי ישיר
username target.user.userid מיפוי ישיר
לא רלוונטי extensions.auth.type קבוע: AUTHTYPE_UNSPECIFIED
לא רלוונטי metadata.event_type קבוע: STATUS_UPDATE
לא רלוונטי metadata.product_event_type קבוע: PAM_KRB5_AUTH_ERROR
לא רלוונטי metadata.product_name קבוע: AuditD
לא רלוונטי metadata.vendor_name קבוע: Linux
לא רלוונטי network.application_protocol קבוע: SSH
לא רלוונטי network.direction קבוע: OUTBOUND
לא רלוונטי network.ip_protocol קבוע: TCP
לא רלוונטי principal.platform קבוע: LINUX
לא רלוונטי principal.user.userid קבוע: event.idm.read_only_udm.target.user.userid
לא רלוונטי security_result.action_details קבוע: FAILURE
לא רלוונטי target.resource.type קבוע: SETTING

יומן שינויים

הצגת יומן השינויים של המנתח הזה

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.