איסוף יומנים של Aruba Central

נתמך ב:

במאמר הזה מוסבר איך להטמיע יומנים של HPE Aruba Networking Central ב-Google SecOps באמצעות סוכן Bindplane. המנתח מחלץ שדות מיומנים בפורמט syslog של Aruba Central. הוא משתמש ב-grok או ב-kv כדי לנתח את הודעת היומן, ואז ממפה את הערכים האלה למודל הנתונים המאוחד (UDM). הוא מגדיר ערכי ברירת מחדל של מטא-נתונים למקור ולסוג של האירוע.

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

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

  • מכונה של Google SecOps
  • מארח עם Windows 2016 ואילך או Linux עם systemd
  • אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
  • גישה עם הרשאות מיוחדות למסוף Aruba Central Management

קבלת פרטי כניסה ל-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. בדרך כלל, הוא נמצא בספרייה /opt/observiq-otel-collector/ ב-Linux או בספריית ההתקנה ב-Windows.
    • פותחים את הקובץ באמצעות כלי לעריכת טקסט (לדוגמה, nano,‏ vi או פנקס הרשימות).
  2. עורכים את הקובץ config.yaml:

    receivers:
      udplog:
        # Replace the port and IP address as required
        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
        # 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: <customer_id>
        endpoint: chronicle.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'ARUBA_CENTRAL'
        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.
    • מחליפים את <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: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'ARUBA_CENTRAL'
        raw_log_field: body
        ingestion_labels:
    

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

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

    sudo systemctl restart observiq-otel-collector
    
  2. כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows, אפשר להשתמש במסוף Services או להזין את הפקודה הבאה:

    net stop observiq-otel-collector && net start observiq-otel-collector
    

הגדרת Syslog ב-Aruba Central

  1. נכנסים לממשק המשתמש באינטרנט של Aruba Central.
  2. בלוח הבקרה, מאתרים קבוצה שמכילה את המכשירים שרוצים להגדיר, או מגדירים את המסנן ל-כל המכשירים כדי להחיל הגדרות גלובליות.
  3. לוחצים על המכשיר או על הקבוצה שרוצים להגדיר.
  4. עוברים אל Configuration > System > Logging.
  5. מאתרים את הקטע שרתי Syslog ולוחצים על הכפתור +.
    • שם השרת: מזינים שם ייחודי ותיאורי.
    • ‫Server IP: מזינים את כתובת ה-IP של סוכן Bindplane.
    • יציאת שרת: מזינים את מספר היציאה של סוכן Bindplane.
    • פורמט רישום ביומן: בוחרים באפשרות Syslog.
    • קטגוריה ומתקן: בוחרים את הקטגוריות והמתקנים שרוצים לשלוח את היומנים שלהם.
    • רמת רישום ביומן: בוחרים באפשרות מידע.
  6. לוחצים על שמירת הגדרות.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
additional_amm additional.fields ממוזג
additional_nid additional.fields ממוזג
additional_setting_id additional.fields ממוזג
additional_webhook additional.fields ממוזג
dev_type_label additional.fields ממוזג
operation_label additional.fields ממוזג
datetime metadata.event_timestamp נותח בתור RFC 3339
timestamp metadata.event_timestamp נותח בתור RFC 3339
event_type metadata.event_type מיפוי ישיר
alert_type metadata.product_event_type מיפוי ישיר
event_data metadata.product_event_type מיפוי ישיר
id metadata.product_log_id מיפוי ישיר
details.__base_url metadata.url_back_to_product מיפוי ישיר
network_ssid network.session_id מיפוי ישיר
app principal.application מיפוי ישיר
cluster_hostname principal.asset.hostname מיפוי ישיר
host principal.asset.hostname מיפוי ישיר
princ_mac principal.asset.mac ממוזג
details.group_name principal.group.group_display_name מיפוי ישיר
details.group principal.group.product_object_id מיפוי ישיר
cluster_hostname principal.hostname מיפוי ישיר
host principal.hostname מיפוי ישיר
princ_mac principal.mac ממוזג
pid principal.process.pid מיפוי ישיר
cid principal.user.product_object_id מיפוי ישיר
details.user principal.user.userid מיפוי ישיר
device_id principal.user.userid מיפוי ישיר
labels security_result.about.labels ממוזג
description security_result.description מיפוי ישיר
state_label security_result.detection_fields ממוזג
severity security_result.severity ערכים ממופים (5 בסך הכול, למשל "LOG_INFO", "LOG_DEBUG" ← LOW, LOG_WARN ← MEDIUM, `LOG_...
details.config_change security_result.summary מיפוי ישיר
target_mac target.asset.mac ממוזג
target_mac target.mac ממוזג
alert_type target.resource.type מופה: DEVICE_CONFIG_CHANGE_DETECTED ← DEVICE
target_userid target.user.userid מיפוי ישיר
userid target.user.userid מיפוי ישיר
לא רלוונטי metadata.product_name קבוע: ARUBA_CENTRAL
לא רלוונטי metadata.vendor_name קבוע: ARUBA CENTRAL
לא רלוונטי security_result.severity קבוע: LOW
לא רלוונטי target.resource.type קבוע: DEVICE
nid" , "setting_id" , "details.dev_type" , "webhook" and "operation additional.fields מופה מיומן השינויים
details.labels security_result.about.labels מופה מיומן השינויים

יומן שינויים

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

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