איסוף יומנים של AlgoSec Security Management

גרסת המנתח: 4.0

נתמך ב:

במאמר הזה מוסבר איך להטמיע את יומני AlgoSec Security Management ב-Google Security Operations באמצעות סוכן Bindplane.

‫AlgoSec Security Management Suite ‏(ASMS) מספקת ניהול של מדיניות אבטחת רשת בחומות אש, ב-SDN ובפלטפורמות ענן. היא כוללת את Firewall Analyzer לניתוח סיכונים ותאימות, את FireFlow לאוטומציה של ניהול שינויים ואת AppViz לניראות של קישוריות האפליקציה.

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

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

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

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

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

מחליפים את ה-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/algosec:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: ALGOSEC
        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 ל-Firewall Analyzer

  1. נכנסים למכשיר AFA באמצעות SSH.
  2. עוברים לספריית ההגדרות של syslog-ng:

    cd /etc/syslog-ng
    
  3. מגבים את ההגדרות הקיימות:

    cp syslog-ng.conf syslog-ng.conf.orig
    
  4. עורכים את קובץ התצורה של syslog-ng:

    vi syslog-ng.conf
    
  5. מוסיפים את השורות הבאות כדי להגדיר את שרת ה-syslog המרוחק:

    destination d_remote { udp("<BINDPLANE_IP>" port(514)); };
    log { source(s_sys); destination(d_remote); };
    
    • מחליפים את <BINDPLANE_IP> בכתובת ה-IP של סוכן Bindplane.
  6. שומרים ויוצאים מהעורך.

  7. מפעילים מחדש את השירות syslog-ng כדי להחיל את השינויים:

    service syslog-ng restart
    
  8. אופציונלי: מאמתים את ההגדרות של Syslog:

    1. עוברים אל Administration > Syslog Server Settings (ניהול > הגדרות שרת Syslog).
    2. לוחצים על בדיקת הקישוריות.

הגדרת syslog ל-FireFlow

  1. נכנסים למכונה של FireFlow בתור root.
  2. פותחים את הקובץ /etc/syslog.conf לעריכה:

    vi /etc/syslog.conf
    
  3. מוסיפים את השורה הבאה לקובץ:

    local0.*@<BINDPLANE_IP>
    
    • מחליפים את <BINDPLANE_IP> בכתובת ה-IP של שרת הסוכן של Bindplane.

הגדרת Syslog ל-AppViz

  1. נכנסים למכשיר AppViz באמצעות SSH.
  2. עוברים לספריית ההגדרות של syslog-ng:

    cd /etc/syslog-ng
    
  3. מגבים את ההגדרות הקיימות:

    cp syslog-ng.conf syslog-ng.conf.orig
    
  4. עורכים את קובץ התצורה של syslog-ng:

    vi syslog-ng.conf
    
  5. מוסיפים את הפרטים הבאים כדי להגדיר את שרת ה-syslog המרוחק:

    destination d_remote { udp("<BINDPLANE_IP>" port(514)); };
    log { source(s_sys); destination(d_remote); };
    
    • מחליפים את <BINDPLANE_IP> בכתובת ה-IP של סוכן Bindplane.
  6. שומרים ויוצאים מהעורך.

  7. מפעילים מחדש את השירות syslog-ng כדי להחיל את השינויים:

    service syslog-ng restart
    
  8. מאמתים את ההגדרות של syslog:

    1. בממשק של AppViz, עוברים אל ניהול > הגדרות שרת Syslog.
    2. לוחצים על בדיקת הקישוריות.

הגדרת syslog לאירועי התחברות והתנתקות

  1. נכנסים למכשיר ASMS באמצעות SSH.
  2. עוברים לספריית ההגדרות של syslog-ng:

    cd /etc/syslog-ng
    
  3. מגבים את ההגדרות הקיימות:

    cp syslog-ng.conf syslog-ng.conf.orig
    
  4. עורכים את קובץ התצורה של syslog-ng:

    vi syslog-ng.conf
    
  5. מוסיפים את הפרטים הבאים כדי להגדיר את שרת ה-syslog המרוחק:

    destination d_remote { udp("<BINDPLANE_IP>" port(514)); };
    log { source(s_sys); destination(d_remote); };
    
    • מחליפים את <BINDPLANE_IP> בכתובת ה-IP של סוכן Bindplane.
  6. שומרים ויוצאים מהעורך.

  7. מפעילים מחדש את השירות syslog-ng כדי להחיל את השינויים:

    service syslog-ng restart
    

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
by_user principal.user.user_display_name הערך של השדה by_user מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
collection_time metadata.event_timestamp השדות seconds ו-nanos משולבים כדי ליצור חותמת זמן.
comm target.process.command_line הערך של השדה comm שחולץ מהשדה desc באמצעות grok מוקצה לשדה ה-UDM הזה.
datetime metadata.event_timestamp התאריך והשעה נשלפים מהיומן הגולמי ומשמשים למילוי חותמת הזמן של האירוע.
desc metadata.description הערך של השדה desc מהיומן הגולמי מוקצה לשדה הזה ב-UDM כשאין תיאור אחר זמין.
dest_ip target.ip הערך של השדה dest_ip מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
dest_port target.port הערך של השדה dest_port מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
details security_result.summary הערך של השדה details מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
device principal.asset.hostname הערך של השדה device מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
dst_ip target.ip הערך של השדה dst_ip מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
dst_port target.port הערך של השדה dst_port מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
event_id metadata.product_event_type הערך של השדה event_id מהיומן הגולמי מוקצה לשדה הזה ב-UDM. הוא משמש גם בלוגיקה של המנתח כדי לקבוע את metadata.event_type ושדות אחרים.
event_name metadata.product_event_type הערך של השדה event_name מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
firewall target.hostname הערך של השדה firewall מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
host principal.hostname הערך של השדה host מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
host_type principal.asset.category הערך של השדה host_type מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
iporhost principal.ip/principal.hostname/target.ip/target.hostname/observer.ip/observer.hostname אם הערך הוא כתובת IP, הוא ממופה ל-principal.ip,target.ip, או ל-observer.ip בהתאם למקור היומן ולסוג האירוע. אם זה שם מארח, הוא ממופה ל-principal.hostname,target.hostname, או ל-observer.hostname.
IP principal.ip הערך של השדה IP מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
kv_data security_result.summary הערך של השדה kv_data מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
log_type metadata.log_type מקודד בתוך הקוד ל-ALGOSEC.
metric security_result.action_details הערך של השדה metric מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
msg security_result.summary/security_result.description הערך של השדה msg מהיומן הגולמי משמש לאכלוס הסיכום או התיאור של תוצאת האבטחה, בהתאם להקשר. הוא משמש גם לשדות extractrisk_level,risk_count,risk_code, ו-risk_title.
pid target.process.pid הערך של השדה pid שחולץ מהשדה desc באמצעות grok מוקצה לשדה ה-UDM הזה.
product metadata.product_name הערך של השדה product מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
report security_result.description הערך של השדה report מהיומן הגולמי נכלל בתיאור של תוצאת האבטחה.
report_data.Device IP target.ip הערך של השדה Device IP מנתוני ה-JSON המנותחים מוקצה לשדה ה-UDM הזה.
report_data.Highest Risk Level security_result.description הערך של השדה Highest Risk Level מנתוני ה-JSON שנותחו נכלל בתיאור של תוצאת האבטחה. הוא משמש גם כדי לקבוע את חומרת תוצאת האבטחה.
report_data.Security Rating Score security_result.description הערך של השדה Security Rating Score מנתוני ה-JSON שנותחו נכלל בתיאור של תוצאת האבטחה.
Requestor.Email principal.user.email_addresses הערך של השדה Email בתוך האובייקט Request מנתוני ה-JSON המנותחים מוקצה לשדה ה-UDM הזה.
Requestor.Name principal.user.user_display_name הערך של השדה Name בתוך האובייקט Requestor מנתוני ה-JSON שנותחו מוקצה לשדה ה-UDM הזה.
RequestType target.resource.attribute.labels הערך של השדה RequestType מהיומן הגולמי מתווסף כתווית למשאב המטרה.
risk_title security_result.summary הערך של השדה risk_title מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
src_ip principal.ip הערך של השדה src_ip מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
src_port principal.port הערך של השדה src_port מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
status security_result.description/security_result.action_details הערך של השדה status מהיומן הגולמי נכלל בתיאור של תוצאת האבטחה או בפרטי הפעולה, בהתאם להקשר. הוא משמש גם כדי לקבוע את חומרת תוצאת האבטחה.
target_app target.application הערך של השדה target_app מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
TemplateName metadata.description הערך של השדה TemplateName מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
url security_result.url_back_to_product הערך של השדה url מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
user principal.user.userid הערך של השדה user מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
vendor metadata.vendor_name הערך של השדה vendor מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
version metadata.product_version הערך של השדה version מהיומן הגולמי מוקצה לשדה הזה ב-UDM.
WorkFlow target.resource.attribute.labels הערך של השדה WorkFlow מהיומן הגולמי מתווסף כתווית למשאב המטרה.
(Parser Logic) extensions.auth.type מקודד בתוך הקוד ל-MACHINE.
(Parser Logic) security_result.action נקבע על סמך event_id ושדות אחרים. בדרך כלל מוגדר לערך ALLOW or BLOCK.
(Parser Logic) security_result.category מקודד באופן קשיח ל-POLICY_VIOLATION לאירועים של Firewall Analyzer.
(Parser Logic) security_result.description הוא נוצר על סמך שדות אחרים, ומספק הקשר ופרטים על האירוע.
(Parser Logic) security_result.severity נקבע על סמך event_id,msg, ושדות אחרים. בדרך כלל מוגדר ל-LOW,MEDIUM, או ל-HIGH.
(Parser Logic) metadata.event_type נקבע על סמך event_id ושדות אחרים. לדוגמה, USER_LOGIN,USER_LOGOUT,USER_RESOURCE_ACCESS,GENERIC_EVENT,STATUS_UNCATEGORIZED,SCAN_HOST,NETWORK_CONNECTION, ו-STATUS_UPDATE.

יומן שינויים

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

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