איסוף יומנים של iBoss Web Proxy

נתמך ב:

במסמך הזה מוסבר איך להטמיע ב-Google Security Operations יומנים של iBoss Web Proxy באמצעות Bindplane.

‫iBoss היא פלטפורמת SASE (שירותי אבטחה בקצה הרשת) מבוססת-ענן עם מודל אבטחה של אפס אמון, שמספקת גישה מאובטחת לאינטרנט, שער גישה מאובטח (SWG),‏ CASB, ‏ ZTNA ויכולות DLP. הוא מנתב את התנועה דרך תשתית הענן שלו כדי לאכוף מדיניות אבטחה עקבית והגנה מפני איומים על המשתמשים, בלי קשר למיקום שלהם.

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

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

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

קבלת פרטי כניסה ל-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/iboss_webproxy:
        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: '<CREDS_FILE_PATH>'
        customer_id: '<CUSTOMER_ID>'
        endpoint: chronicle.googleapis.com
        log_type: IBOSS_WEBPROXY
        raw_log_field: body
        ingestion_labels:
          log_source: iboss
    
    service:
      pipelines:
        logs/iboss_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/iboss_webproxy
    

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

מחליפים את ה-placeholders הבאים:

  • הגדרת המקלט:

    • ‫listen_address: כתובת ה-IP והיציאה שבהן סוכן Bindplane מאזין להודעות syslog נכנסות. כדי להאזין בכל הממשקים, צריך להשתמש ב-0.0.0.0. היציאה צריכה להתאים ליציאה שהוגדרה בהגדרות ההעברה של iBoss syslog.
    • אם iBoss מוגדר לשלוח יומנים דרך TCP, מחליפים את המקלט udplog במקלט tcplog:
    receivers:
      tcplog:
        listen_address: "0.0.0.0:514"
    
  • הגדרת הייצוא:

    • ‫<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/iboss_webproxy:
        compression: gzip
        creds_file_path: '<CREDS_FILE_PATH>'
        customer_id: '<CUSTOMER_ID>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: IBOSS_WEBPROXY
        raw_log_field: body
        ingestion_labels:
          log_source: iboss
    

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

אחרי העריכה, שומרים את הקובץ:

  • 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 ב-iBoss

  1. נכנסים לפורטל iBoss.
  2. עוברים אל Integration Marketplace, בוחרים באפשרות Log Forwarding בתפריט הימני ולוחצים על הלחצן Configure שמשויך לווידג'ט Syslog Log Forwarding.
  3. לוחצים על הכפתור Add Integration כדי להוסיף את השילוב של Syslog.
  4. ממלאים את פרטי ההגדרה הבאים:

    • העברה מ: בוחרים באפשרות מדווח בתפריט הנפתח.
    • בחירת מסד נתונים לדיווח: בוחרים את מסד הנתונים לדיווח.
    • שם השירות: מזינים שם תיאורי לשילוב (לדוגמה, SecOps-Bindplane).
    • הפעלת השירות: מגדירים את האפשרות הזו כמופעלת.
    • סוג היומן: בוחרים באפשרות כתובת URL בתפריט הנפתח. הפעולה הזו מתעדת את יומני התנועה של שרת ה-proxy לאינטרנט (בקשות HTTP/HTTPS). כדי להעביר קטגוריות אחרות של אירועים, כמו DLP או DNS, צריך להגדיר שילובים נפרדים עם סוג היומן המתאים.
    • סוג הפרוטוקול: בוחרים באפשרות UDP או TCP מהתפריט הנפתח.

    • Syslog Facility Level: בוחרים באפשרות Facility Syslog בתפריט הנפתח.

    • קבוצת דיווח: בוחרים באפשרות הכול בתפריט הנפתח.

    • שם המארח: מזינים את כתובת ה-IP או את שם הדומיין שמוגדר במלואו של המארח של סוכן Bindplane.

    • יציאה: מזינים את מספר היציאה שתואם ליציאת listen_address בהגדרות הסוכן של Bindplane (לדוגמה, 514).

    • פורמט היומן: בוחרים באפשרות JSON בתפריט הנפתח.

    • Transfer Interval: בוחרים באפשרות Continuous בתפריט הנפתח.

    • תו מפריד שדה: בוחרים באפשרות רווח בתפריט הנפתח.

    • שליחת יומני DLP/אינטרנט/DNS/תוכנה זדונית/ביקורת/שגיאת חיבור: מגדירים את האפשרות הפעלה בהתאם להעדפה שלכם לשליחת יומנים.

    • שדות להעברה: מוסיפים את כל השדות חוץ ממטא-נתונים בקידוד Base64 של DLP, מטא-נתונים בקידוד Base64 והודעת ChatGPT.

  5. לוחצים על הוספת שירות.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
מתווך מתווך מידע על מכשיר או שירות מתווך שמעורב באירוע.
desc metadata.description תיאור נוסף של האירוע.
metadata.event_type metadata.event_type סוג האירוע (למשל, USER_LOGIN, ‏ NETWORK_CONNECTION).
urlLogId metadata.product_log_id המזהה הייחודי של רשומת היומן מהמוצר.
requestMethod network.http.method שיטת ה-HTTP שנעשה בה שימוש בבקשה.
ref_url network.http.referral_url כתובת ה-URL שהפנתה את המשתמש לדף הנוכחי.
response_Code network.http.response_code קוד תגובת HTTP.
user_Agent network.http.user_agent מחרוזת סוכן המשתמש מבקשת ה-HTTP.
up_stream network.received_bytes מספר הבייטים שהתקבלו בחיבור לרשת.
down_stream network.sent_bytes מספר הבייטים שנשלחו בחיבור לרשת.
computerName principal.asset.hostname שם המארח של הנכס שמשויך לחשבון הראשי.
computer_Mac_Address principal.asset.mac כתובת ה-MAC של הנכס שמשויך לחשבון הראשי.
filtering_Group_Name principal.group.group_display_name השם המוצג של הקבוצה שמשויכת לחשבון המשתמש.
computerName principal.hostname שם המארח של חשבון המשתמש.
sourceIpAddress principal.ip כתובת ה-IP של חשבון המשתמש.
pri_ip principal.ip
pub_ip principal.ip
mac_address principal.mac כתובת ה-MAC של חשבון המשתמש.
src_port principal.port מספר היציאה שמשמש את החשבון הראשי.
file_name principal.process.file.names שמות הקבצים שמשויכים לתהליך.
שם משתמש principal.user.userid מזהה המשתמש של חשבון המשתמש.
sec_res security_result תוצאת ניתוח האבטחה, כולל פעולות וקטגוריות.
מארח target.hostname שם המארח של היעד.
ipAddress target.ip כתובת ה-IP של היעד.
targetPort target.port מספר היציאה של היעד.
uri_path target.process.file.full_path הנתיב המלא של הקובץ או המשאב ביעד.
url target.url כתובת ה-URL של היעד.
metadata.product_name metadata.product_name שם המוצר שיצר את האירוע.
metadata.vendor_name metadata.vendor_name שם הספק שייצר את המוצר.

יומן שינויים

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

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