איסוף יומנים של Juniper Junos

נתמך ב:

במסמך הזה מוסבר איך להטמיע יומני Juniper Junos ב-Google Security Operations באמצעות Bindplane.

‫Juniper Junos OS היא מערכת ההפעלה שמפעילה את הנתבים, המתגים ומכשירי האבטחה של Juniper Networks. הוא מספק פלטפורמה מאוחדת לניהול תשתית הרשת, לניתוב, להחלפה ולפונקציות אבטחה, עם רישום מקיף ביומן של אירועי מערכת, אירועי אבטחה ותנועה ברשת. המנתח מחלץ שדות מ-syslog של Juniper Junos ומיומנים בפורמט של מפתח/ערך. הוא משתמש ב-grok או ב-kv כדי לנתח את הודעת היומן, ואז ממפה את הערכים האלה למודל הנתונים המאוחד (UDM). הוא גם מגדיר ערכי מטא-נתונים שמוגדרים כברירת מחדל למקור האירוע ולסוג האירוע.

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

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

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

קבלת פרטי כניסה ל-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/chronicle_w_labels:
        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: '/path/to/ingestion-authentication-file.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: chronicle.googleapis.com
        log_type: 'JUNIPER_JUNOS'
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/source0__chronicle_w_labels-0:
          receivers:
            - udplog
          exporters:
            - chronicle/chronicle_w_labels
    

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

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

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

      • ‫udplog: משתמשים ב-udplog ל-UDP syslog או ב-tcplog ל-TCP syslog
      • ‫0.0.0.0: כתובת ה-IP להאזנה (0.0.0.0 להאזנה בכל הממשקים)
      • ‫514: מספר היציאה להאזנה (יציאת syslog רגילה)
    • הגדרת הייצוא:

      • ‫creds_file_path: הנתיב המלא לקובץ המפתח של חשבון השירות בפורמט JSON (אפשרות 1):
        • Linux: /opt/observiq-otel-collector/ingestion-auth.json
        • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
      • ‫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: סוג היומן בדיוק כמו שהוא מופיע ב-Chronicle‏ (JUNIPER_JUNOS)

מייצא API להטמעה מדור קודם

  • אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק exporters בקוד הבא. מגדירים את creds_file_path לנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים את malachiteingestion-pa.googleapis.com בנקודת הקצה האזורית (לדוגמה, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/chronicle_w_labels:
        compression: gzip
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: 'JUNIPER_JUNOS'
        raw_log_field: body
        ingestion_labels:
    

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

  • אחרי שמסיימים לערוך, שומרים את הקובץ:
    • 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 ב-Juniper Junos

  1. מתחברים למכשיר Juniper באמצעות SSH או מסוף.
  2. נכנסים למצב הגדרה:

    configure
    
  3. מגדירים את מארח ה-syslog באמצעות הפקודות הבאות:

    set system syslog host BINDPLANE_IP any info
    set system syslog host BINDPLANE_IP port 514
    set system syslog host BINDPLANE_IP facility-override local7
    set system syslog host BINDPLANE_IP log-prefix JUNOS
    
    • מחליפים את BINDPLANE_IP בכתובת ה-IP של המארח של סוכן Bindplane.
  4. מגדירים מקורות נוספים של יומנים (אופציונלי אבל מומלץ):

    set system syslog host BINDPLANE_IP authorization info
    set system syslog host BINDPLANE_IP daemon info
    set system syslog host BINDPLANE_IP kernel info
    set system syslog host BINDPLANE_IP firewall any
    set system syslog host BINDPLANE_IP interactive-commands info
    
  5. מגדירים נתוני syslog מובְנים (אופציונלי לניתוח משופר):

    set system syslog host BINDPLANE_IP structured-data
    
  6. שומרים את ההגדרות:

    commit and-quit
    
  7. מאמתים את ההגדרות של syslog:

    show system syslog host BINDPLANE_IP
    
  8. כדי לוודא שהודעות syslog נשלחות, בודקים את יומני הסוכן של Bindplane.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
DPT target.port יציאת היעד של החיבור לרשת, שהומרה למספר שלם.
מס שירותים דיגיטליים (DTS) target.ip כתובת ה-IP של היעד של החיבור לרשת.
FLAG ‫additional.fields{}.key: "FLAG", ‏ additional.fields{}.value.string_value: הערך של FLAG דגל ה-TCP שמשויך לחיבור לרשת.
מזהה additional.fields{}.key: "ID", additional.fields{}.value.string_value: Value of ID שדה הזיהוי של ה-IP.
IN additional.fields{}.key: "IN", additional.fields{}.value.string_value: Value of IN ממשק הרשת הנכנסת.
LEN additional.fields{}.key: "LEN", additional.fields{}.value.string_value: Value of LEN האורך של חבילת ה-IP.
MAC principal.mac כתובת ה-MAC שחולצה מהשדה MAC.
OUT additional.fields{}.key: "OUT", additional.fields{}.value.string_value: Value of OUT ממשק הרשת היוצאת.
PREC additional.fields{}.key: "PREC", additional.fields{}.value.string_value: Value of PREC השדה Precedence בכותרת ה-IP.
PROTO network.ip_protocol פרוטוקול ה-IP שמשמש בחיבור לרשת.
RES additional.fields{}.key: "RES", additional.fields{}.value.string_value: Value of RES שדה שמור בכותרת ה-TCP.
SPT principal.port יציאת המקור של החיבור לרשת, שהומרה למספר שלם.
SRC principal.ip כתובת ה-IP של מקור החיבור לרשת.
TOS ‫additional.fields{}.key: "TOS", ‏ additional.fields{}.value.string_value: הערך של TOS השדה "סוג השירות" בכותרת ה-IP.
TTL network.dns.additional.ttl ערך Time To Live, שהומר למספר שלם ללא סימן.
URGP additional.fields{}.key: "URGP", additional.fields{}.value.string_value: Value of URGP שדה "היסט למידע דחוף" (Urgent Pointer) בכותרת ה-TCP.
חלון ‫additional.fields{}.key: "WINDOW_SIZE", ‏ additional.fields{}.value.string_value: הערך של WINDOW גודל חלון ה-TCP.
פעולה security_result.action הפעולה שבוצעה על ידי חומת האש, שחולצה מהודעת ה-CEF.
agt observer.ip כתובת ה-IP של הסוכן.
amac target.mac כתובת ה-MAC של היעד, שהומרה לאותיות קטנות והמקפים הוחלפו בנקודתיים.
אפליקציה target.application האפליקציה שמעורבת באירוע.
artz observer.zone אזור הזמן של הצופה.
atz target.location.country_or_region אזור הזמן של היעד.
categoryBehavior ‫additional.fields{}.key: "Category Behavior", additional.fields{}.value.string_value: הערך של categoryBehavior בלי לוכסנים התנהגות הקטגוריה.
categoryDeviceGroup ‫additional.fields{}.key: "Category Device Group", ‏ additional.fields{}.value.string_value: הערך של קבוצת המכשירים של הקטגוריה בלי לוכסנים הקטגוריה "קבוצת מכשירים".
categoryObject ‫additional.fields{}.key: "Category Object", ‏ additional.fields{}.value.string_value: הערך של categoryObject בלי לוכסנים האובייקט של הקטגוריה.
categoryOutcome ‫additional.fields{}.key: "Category Outcome", ‏ additional.fields{}.value.string_value: הערך של categoryOutcome בלי לוכסנים תוצאת הקטגוריה.
categorySignificance ‫additional.fields{}.key: "category Significance", ‏ additional.fields{}.value.string_value: הערך של categorySignificance החשיבות של הקטגוריה.
פקודה target.process.command_line הפקודה בוצעה.
cs1Label ‫additional.fields{}.key: cs1Label, additional.fields{}.value.string_value: הערך של שדה ה-CEF התואם התווית והערך של שדה המחרוזת המותאם אישית 1 מהודעת ה-CEF.
cs2Label ‫additional.fields{}.key: cs2Label, additional.fields{}.value.string_value: הערך של שדה ה-CEF התואם התווית והערך של שדה המחרוזת המותאם אישית 2 מהודעת ה-CEF.
cs3Label ‫additional.fields{}.key: cs3Label, additional.fields{}.value.string_value: הערך של שדה ה-CEF התואם התווית והערך של שדה המחרוזת המותאם אישית 3 מהודעת ה-CEF.
cs4Label ‫additional.fields{}.key: cs4Label, ‏ additional.fields{}.value.string_value: הערך של שדה ה-CEF התואם התווית והערך של שדה המחרוזת המותאם אישית 4 מהודעת ה-CEF.
cs5Label ‫additional.fields{}.key: cs5Label, ‏ additional.fields{}.value.string_value: הערך של שדה ה-CEF התואם התווית והערך של שדה 5 של מחרוזת בהתאמה אישית מהודעת ה-CEF.
cs6Label ‫additional.fields{}.key: cs6Label, additional.fields{}.value.string_value: הערך של שדה ה-CEF התואם התווית והערך של שדה 6 של מחרוזת בהתאמה אישית מהודעת ה-CEF.
dhost target.hostname שם המארח של היעד.
deviceCustomString1 additional.fields{}.key: cs1Label, additional.fields{}.value.string_value: Value of deviceCustomString1 מחרוזת 1 בהתאמה אישית למכשיר.
deviceCustomString2 additional.fields{}.key: cs2Label, additional.fields{}.value.string_value: Value of deviceCustomString2 מחרוזת מותאמת אישית 2 של המכשיר.
deviceCustomString3 ‫additional.fields{}.key: cs3Label, ‏ additional.fields{}.value.string_value: הערך של deviceCustomString3 מחרוזת מותאמת אישית 3 של המכשיר.
deviceCustomString4 additional.fields{}.key: cs4Label, additional.fields{}.value.string_value: Value of deviceCustomString4 מחרוזת מותאמת אישית 4 של המכשיר.
deviceCustomString5 additional.fields{}.key: cs5Label, additional.fields{}.value.string_value: Value of deviceCustomString5 מחרוזת מותאמת אישית 5 של המכשיר.
deviceCustomString6 additional.fields{}.key: cs6Label, additional.fields{}.value.string_value: Value of deviceCustomString6 מחרוזת מותאמת אישית 6 של המכשיר.
deviceDirection network.direction כיוון התנועה ברשת.
deviceEventClassId additional.fields{}.key: "eventId", additional.fields{}.value.string_value: Value of deviceEventClassId מזהה מחלקת האירועים של המכשיר.
deviceFacility observer.product.subproduct המתקן של המכשיר.
deviceProcessName about.process.command_line שם התהליך במכשיר.
deviceSeverity security_result.severity רמת החומרה של המכשיר.
deviceTimeZone observer.zone אזור הזמן של המכשיר.
deviceVendor metadata.vendor_name ספק המכשיר.
deviceVersion metadata.product_version גרסת המכשיר.
dpt target.port יציאת היעד.
dst target.ip כתובת ה-IP של היעד.
duser target.user.user_display_name המשתמש ביעד.
eventId additional.fields{}.key: "eventId", additional.fields{}.value.string_value: Value of eventId מזהה האירוע.
event_time metadata.event_timestamp השעה שבה האירוע התרחש, כפי שנותחה מההודעה.
firewall_action security_result.action_details פעולת חומת האש שבוצעה.
מארח ‫principal.hostname, ‏ intermediary.hostname שם המארח של המכשיר שיוצר את היומן. משמש גם לגורם הראשי וגם למתווך במקרים שונים.
msg security_result.summary ההודעה שמשויכת לאירוע, שמשמשת כסיכום של תוצאת האבטחה.
name metadata.product_event_type שם האירוע.
process_name additional.fields{}.key: "process_name", additional.fields{}.value.string_value: Value of process_name שם התהליך.
p_id target.process.pid מזהה התהליך, שהומר למחרוזת.
sha256 principal.process.file.sha256 גיבוב SHA256 של קובץ, שחולץ מפרטי המפתח SSH2.
shost principal.hostname שם המארח של המקור.
source_address principal.ip כתובת ה-IP של המקור.
source_port principal.port יציאת המקור, שהומרה למספר שלם.
src principal.ip כתובת ה-IP של המקור.
src_ip principal.ip כתובת ה-IP של המקור.
src_port principal.port יציאת המקור, שהומרה למספר שלם.
ssh2 security_result.detection_fields{}.key: "ssh2", security_result.detection_fields{}.value: Value of ssh2 מידע על מפתח SSH2.
סוג משנה metadata.product_event_type סוג המשנה של האירוע.
task_summary security_result.description סיכום המשימה, שמשמש כתיאור של תוצאת האבטחה.
חותמת זמן metadata.event_timestamp חותמת הזמן של האירוע.
משתמש target.user.userid המשתמש שמשויך לאירוע.
שם משתמש principal.user.userid שם המשתמש שמשויך לאירוע.
user_name principal.user.userid שם המשתמש.
metadata.vendor_name מקודד באופן קשיח ל-"Juniper Firewall". מקודד באופן קשיח ל-"Juniper Firewall". מקודד באופן קשיח ל-"JUNIPER_JUNOS". נקבע לפי לוגיקת המנתח על סמך תוכן היומן. אם לא מדובר בהודעת CEF ולא זוהה סוג אירוע ספציפי אחר, ברירת המחדל היא STATUS_UPDATE. צריך להגדיר את הערך NETWORK_HTTP להודעות CEF. אם אין שדה desc, השדה הזה מאוכלס ב-message_description שחולץ מהודעת היומן הגולמית.
protocol-name network.ip_protocol מופה מיומן השינויים
application_name target.application מופה מיומן השינויים
desc sec_result.summary מופה מיומן השינויים
mac-address principal.mac מופה מיומן השינויים

יומן שינויים

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

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