איסוף יומנים של Cisco eStreamer

גרסת המנתח: 5.0

נתמך ב:

במסמך הזה מוסבר איך להטמיע יומני Cisco eStreamer ב-Google Security Operations באמצעות Bindplane.
המנתח מחלץ שדות מיומני syslog בפורמט של Cisco eStreamer עם צמדי מפתח/ערך. הוא משתמש ב-grok או ב-kv כדי לנתח את הודעת היומן, ואז ממפה את הערכים האלה למודל הנתונים המאוחד (UDM). הוא גם מגדיר ערכי מטא-נתונים שמוגדרים כברירת מחדל למקור האירוע ולסוג האירוע.

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

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

  • מופע של Google SecOps.
  • ‫Windows Server 2016 ואילך, או מארח Linux עם systemd.
  • אם אתם מפעילים את הסוכן מאחורי שרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
  • גישה עם הרשאות מיוחדות ל-Cisco Firepower Management Center ‏(FMC).
  • מערכת Linux להפעלת לקוח ה-CLI של eNcore.

קבלת פרטי כניסה ל-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
    

התקנה ב-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
    

מקורות מידע נוספים בנושא התקנה

אפשרויות התקנה נוספות מפורטות במדריך ההתקנה.

הגדרת סוכן Bindplane להטמעת Syslog ושליחה אל Google SecOps

  1. גישה לקובץ התצורה:

    • מאתרים את הקובץ config.yaml. בדרך כלל, ב-Linux הוא נמצא בספרייה /observiq-otel-collector/ וב-Windows בספרייה `C:\Program Files\observIQ OpenTelemetry Collector`.
    • פותחים את הקובץ באמצעות כלי לעריכת טקסט (לדוגמה, nano,‏ vi או פנקס הרשימות).
  2. עורכים את הקובץ config.yaml:

    receivers:
      udplog:
        # Replace the port and IP address as required
        listen_address: "0.0.0.0:5514"
    
    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
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: YOUR_CUSTOMER_ID
        endpoint: chronicle.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'CISCO_ESTREAMER'
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/source0__chronicle_w_labels-0:
          receivers:
            - udplog
          exporters:
            - chronicle/chronicle_w_labels
    
  • מחליפים את היציאה ואת כתובת ה-IP לפי הצורך בתשתית שלכם.
  • מחליפים את <LOCATION> באזור של המופע של Google SecOps (לדוגמה, us,‏ europe או asia-southeast1). המערכת מוסיפה את הערך הזה בתחילת chronicle.googleapis.com.
  • מחליפים את <PROJECT_NUMBER> במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.
  • מחליפים את YOUR_CUSTOMER_ID במספר הלקוח בפועל.
  • מעדכנים את /path/to/ingestion-authentication-file.json לנתיב הקובץ שבו נשמר קובץ המפתח של חשבון השירות (אפשרות 1) בשלב 1.

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

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

    exporters:
      chronicle/chronicle_w_labels:
        compression: gzip
        # Adjust the path to the credentials file you downloaded in Step 1
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        # Replace with your actual customer ID from Step 2
        customer_id: YOUR_CUSTOMER_ID
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'CISCO_ESTREAMER'
        raw_log_field: body
        ingestion_labels:
    

מפעילים מחדש את הסוכן של 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 ב-Cisco eStreamer

הגדרת eStreamer ב-Firepower Management Center

  1. נכנסים אל Firepower Management Center.
  2. עוברים אל System > Integration > eStreamer (מערכת > שילוב > eStreamer).
  3. לוחצים על eStreamer כדי לגשת להגדרת האירוע של eStreamer.
  4. מסמנים את תיבות הסימון לצד סוגי האירועים שרוצים לתעד:
    • אירועי פריצה: לאירועים של זיהוי פריצות אבטחה
    • נתוני חבילות של אירועי פריצה: לתיעוד חבילות שמשויכות לאירועי פריצה
    • אירועי חיבור: לנתוני חיבור לרשת
    • התראות מודיעין אבטחה: לנתוני מודיעין איומי סייבר
    • אירועי קבצים: לאירועים של ניתוח קבצים
    • אירועי תוכנות זדוניות: לאירועים של זיהוי תוכנות זדוניות
  5. לוחצים על Save.

יצירת לקוח eStreamer

  1. בדף eStreamer, לוחצים על Create Client.
  2. מזינים את פרטי ההגדרה הבאים:
    • שם המארח: מזינים את כתובת ה-IP של מערכת Linux שבה יפעל לקוח eNcore.
    • סיסמה: מזינים סיסמה כדי להצפין את קובץ האישור.
  3. לוחצים על Save.
  4. מורידים את קובץ האישור PKCS12 שנוצר ומעבירים אותו למערכת הלקוח של eNcore.

התקנה והגדרה של לקוח eNcore CLI

  1. במערכת Linux, מורידים את לקוח ה-CLI של eStreamer eNcore מ-Cisco.
  2. מחלצים את חבילת eNcore:

    tar -xzf eStreamer-eNcore-*.tar.gz
    cd eStreamer-eNcore-*
    
  3. מריצים את סקריפט ההגדרות:

    ./encore.sh setup
    
  4. כשמופיעה בקשה, בוחרים את פורמט הפלט של צמדי מפתח/ערך (תואם למערכות SIEM).

  5. מזינים את כתובת ה-IP של ה-FMC ואת הסיסמה של אישור ה-PKCS12.

  6. מגדירים את הקובץ estreamer.conf כדי להוציא הודעות syslog לסוכן Bindplane:

    • פותחים את הקובץ estreamer.conf בכלי לעריכת טקסט.
    • מאתרים את הקטע outputters ומגדירים אותו כך שישלח את syslog לסוכן Bindplane:
    {
      "handler": {
        "outputters": [
          {
            "name": "syslog",
            "adapter": "kvpair",
            "enabled": true,
            "stream": {
              "uri": "udp://BINDPLANE_AGENT_IP:5514"
            }
          }
        ]
      }
    }
    
  7. מחליפים את BINDPLANE_AGENT_IP בכתובת ה-IP של סוכן Bindplane.

הפעלת לקוח eNcore

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

    ./encore.sh foreground
    
  2. אחרי האימות, מפעילים את eNcore כשירות הפועל ברקע:

    ./encore.sh start
    

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
additional_deviceInboundInterface additional.fields ממוזג
additional_deviceOutboundInterface additional.fields ממוזג
additional_start additional.fields ממוזג
has_target extensions.auth.type מופה: true ← AUTHTYPE_UNSPECIFIED
dvchost intermediary.asset.hostname מיפוי ישיר
hostname intermediary.asset.hostname מיפוי ישיר
dvchost intermediary.hostname מיפוי ישיר
hostname intermediary.hostname מיפוי ישיר
dvcpid intermediary.process.pid מיפוי ישיר
ts metadata.event_timestamp נותח בתור MMM d HH:mm:ss
has_principal metadata.event_type ערכים ממופים (5 בסך הכול, למשל true ← NETWORK_HTTP, true ← NETWORK_DNS, true ← `NETW...
has_target metadata.event_type מופה: true ← USER_UNCATEGORIZED
product_event_type metadata.product_event_type מיפוי ישיר
product_name metadata.product_name מיפוי ישיר
version metadata.product_version מיפוי ישיר
vendor_name metadata.vendor_name מיפוי ישיר
app network.application_protocol מיפוי ישיר
src network.dhcp.ciaddr מיפוי ישיר
deviceDirection network.direction מופה: 0 ← INBOUND, 1 ← OUTBOUND
dns_question network.dns.questions ממוזג
requestClientApplication network.http.user_agent מיפוי ישיר
ip_protocol_out network.ip_protocol מיפוי ישיר
bytesIn network.received_bytes מיפוי ישיר
bytesOut network.sent_bytes מיפוי ישיר
deviceExternalId principal.asset.asset_id מיפוי ישיר
src principal.asset.ip ממוזג
src principal.ip ממוזג
spt principal.port מיפוי ישיר
security_result_action security_result.action ממוזג
act security_result.action_details מיפוי ישיר
category security_result.category ממוזג
cat security_result.category_details ממוזג
cs5 security_result.description מיפוי ישיר
blockLength_label security_result.detection_fields ממוזג
blockType_label security_result.detection_fields ממוזג
cs1_var security_result.detection_fields ממוזג
cs2_var security_result.detection_fields ממוזג
cs3_var security_result.detection_fields ממוזג
cs4_var security_result.detection_fields ממוזג
cs5_var security_result.detection_fields ממוזג
cs6_var security_result.detection_fields ממוזג
suser_var security_result.detection_fields ממוזג
cs6 security_result.rule_id מיפוי ישיר
severity security_result.severity_details מיפוי ישיר
outcome security_result.summary מיפוי ישיר
destinationDnsDomain target.asset.hostname מיפוי ישיר
dst target.asset.ip ממוזג
fname target.file.full_path מיפוי ישיר
fileType target.file.mime_type מיפוי ישיר
fileHash target.file.sha256 מיפוי ישיר
fsize target.file.size מיפוי ישיר
destinationDnsDomain target.hostname מיפוי ישיר
host target.hostname מיפוי ישיר
dst target.ip ממוזג
dpt target.port מיפוי ישיר
request target.url מיפוי ישיר
לא רלוונטי extensions.auth.type קבוע: AUTHTYPE_UNSPECIFIED
לא רלוונטי metadata.event_type קבוע: NETWORK_HTTP
לא רלוונטי network.direction קבוע: INBOUND
BLOCK security_result.action מופה מיומן השינויים
SOFTWARE_PUA security_result.category מופה מיומן השינויים
NETWORK_COMMAND_AND_CONTROL security_result.category מופה מיומן השינויים
TOR_EXIT_NODE security_result.category מופה מיומן השינויים
PHISHING security_result.category מופה מיומן השינויים
NETWORK_MALICIOUS security_result.category מופה מיומן השינויים
request network.http.referral_url מופה מיומן השינויים
destinationDnsDomain network.dns.questions.name מופה מיומן השינויים
security_result.action BLOCK מופה מיומן השינויים

יומן שינויים

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

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