איסוף יומני BlueCat DDI

גרסת המנתח: 1.0

נתמך ב:

במסמך הזה מוסבר איך להטמיע יומני BlueCat DDI ב-Google Security Operations באמצעות Bindplane. ‫BlueCat DDI הוא פתרון משולב לניהול DNS,‏ DHCP וכתובות IP‏ (IPAM) שמספק ניהול מרכזי ואוטומציה של שירותי רשת עיקריים. הוא עוזר לארגונים לנהל אזורי DNS, טווחי DHCP והקצאות של כתובות IP בסביבות ארגוניות מורכבות.

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

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

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

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

    receivers:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/bluecat_ddi:
        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: '<customer_id>'
        endpoint: chronicle.googleapis.com
        log_type: BLUECAT_DDI
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/bluecat_ddi:
          receivers:
            - udplog
          exporters:
            - chronicle/bluecat_ddi
    
  • מחליפים את היציאה ואת כתובת ה-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) בקטע קבלת פרטי כניסה ל-Google SecOps בשביל סוכן Bindplane.

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

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

    exporters:
      chronicle/bluecat_ddi:
        compression: gzip
        creds_file_path: '/path/to/ingestion-authentication-file.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: BLUECAT_DDI
        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 של BlueCat DDI

הגדרת syslog ב-BlueCat Address Manager

  1. נכנסים לממשק האינטרנט של BlueCat Address Manager.
  2. בתפריט הנפתח Configuration, בוחרים הגדרה.
  3. לוחצים על הכרטיסייה שרתים.
  4. בקטע Servers (שרתים), לוחצים על השם של ה-BDDS (שרת BlueCat DNS/DHCP) שרוצים להגדיר.
  5. לוחצים על הכרטיסייה Syslog.
  6. בקטע Syslog, לוחצים על New (חדש).
  7. מזינים את פרטי ההגדרה הבאים:
    • כתובת השרת: מזינים את כתובת ה-IP של המארח של סוכן Bindplane (לדוגמה, 192.168.1.100).
    • Port: מזינים 514 (או את היציאה שהגדרתם לסוכן Bindplane).
    • תעבורה: בוחרים באפשרות UDP.
  8. לוחצים על הוספה כדי לשמור את הרשומה של הפניית ה-syslog.
  9. לוחצים על Deploy כדי להעביר את ההגדרות המעודכנות למכשיר ה-BDDS.

הגדרת syslog ב-BlueCat DNS/DHCP Server ‏(BDDS) באמצעות CLI

אם אתם מעדיפים להגדיר העברת syslog ישירות במכשיר BDDS במקום דרך Address Manager:

  1. מתחברים למכשיר ה-BDDS באמצעות SSH.
  2. נכנסים באמצעות פרטי כניסה של אדמין.
  3. עורכים את קובץ התצורה של syslog-ng:

    sudo vi /etc/syslog-ng/syslog-ng.conf
    
  4. מוסיפים את היעד ואת פקודות הרישום ביומן הבאות:

    destination d_bindplane {
        udp("<BINDPLANE_IP>" port(514));
    };
    
    log {
        source(s_local);
        destination(d_bindplane);
    };
    
  5. מחליפים את <BINDPLANE_IP> בכתובת ה-IP של המארח של סוכן Bindplane.

  6. שומרים את הקובץ ומפעילים מחדש את שירות syslog-ng:

    sudo systemctl restart syslog-ng
    
  7. כדי לוודא שהיומנים מועברים, בודקים את יומן הפעילות של סוכן Bindplane.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
auth_mechanism extensions.auth.mechanism ממוזג
log_type extensions.auth.mechanism מופה: systemd ← auth_mechanism
log_type extensions.auth.type מופה: CRON ← AUTHTYPE_UNSPECIFIED, audit ← AUTHTYPE_UNSPECIFIED
log_type intermediary מופה: named ← intermediary
relay_ip intermediary.ip ממוזג
description metadata.description שינוי שם/מיפוי
inner_message metadata.description מיפוי ישיר
kv.cat metadata.description מיפוי ישיר
msg metadata.description מיפוי ישיר
ts metadata.event_timestamp נותח בתור MMM d HH:mm:ss
ts_date metadata.event_timestamp נותח בתור MMM d HH:mm:ss
ts_timestamp metadata.event_timestamp נותח בתור yyyy-MM-dd HH:mm:ss
has_principal metadata.event_type מופה: true ← NETWORK_CONNECTION
log_type metadata.event_type ערכים ממופים (15 בסך הכול, למשל named ← USER_UNCATEGORIZED,‏ named ← NETWORK_DNS, ‏ `dhcp...
message metadata.event_type מופה: session closed ← USER_LOGOUT
operation_type metadata.event_type מופה: view ← USER_UNCATEGORIZED
csv.event_id metadata.product_event_type מיפוי ישיר
log_type network.application_protocol מופה: named ← DNS, dhcpd ← DHCP
client_mac network.dhcp.chaddr מיפוי ישיר
client_ip network.dhcp.ciaddr מיפוי ישיר
src_ip network.dhcp.ciaddr מיפוי ישיר
relay_ip network.dhcp.giaddr מיפוי ישיר
log_type network.dhcp.opcode מופה: dhcpd ← BOOTREQUEST, dhcpd ← BOOTREPLY
message_type network.dhcp.opcode ערכים ממופים (7 בסך הכול, למשל DHCPDISCOVER ← BOOTREQUEST, "DHCPREQUEST", "BOOTREQUEST" ...
src_ip network.dhcp.siaddr מיפוי ישיר
server_host network.dhcp.sname שינוי שם/מיפוי
log_type network.dhcp.type ערכים ממופים (7 בסך הכול, למשל dhcpd ← DISCOVER,‏ dhcpd ← REQUEST,‏ dhcpd ← OFFER)
message_type network.dhcp.type ערכים ממופים (7 בסך הכול, למשל DHCPDISCOVER ← DISCOVER, "DHCPREQUEST", "BOOTREQUEST" ← `...
src_ip network.dhcp.yiaddr מיפוי ישיר
log_type network.dns.answers מופה: named ← response
response network.dns.answers ממוזג
log_type network.dns.questions מופה: named ← query
query network.dns.questions ממוזג
question network.dns.questions ממוזג
ses network.session_id מיפוי ישיר
hostname principal.hostname מיפוי ישיר
server_host principal.hostname מיפוי ישיר
kv.src principal.ip ממוזג
log_type principal.ip מופו: named ← src_ip, dhcpd ← src_ip, syslog-ng ← src_ip
src_ip principal.ip ממוזג
client_mac principal.mac ממוזג
log_type principal.mac מופה: dhcpd ← client_mac
message_type principal.mac מיפוי: DHCPDISCOVER ← client_mac, "DHCPREQUEST", "BOOTREQUEST" ← client_mac, `DHCPR...
src_port principal.port שינוי שם/מיפוי
acct principal.user.userid מיפוי ישיר
src_user principal.user.userid מיפוי ישיר
application target.application מיפוי ישיר
terminal target.application מיפוי ישיר
file_path target.file.full_path מיפוי ישיר
server_host target.hostname מיפוי ישיר
target_host target.hostname מיפוי ישיר
log_type target.ip מופו: named ← target_ip, dhcpd ← target_ip, syslog-ng ← target_ip
server_ip target.ip ממוזג
target_ip target.ip ממוזג
client_mac target.mac ממוזג
log_type target.mac מופה: dhcpd ← client_mac
message_type target.mac מופו: "DHCPOFFER", "BOOTREPLY" ← client_mac, DHCPACK ← client_mac, DHCPNAK ← `cl...
tgt_port target.port שינוי שם/מיפוי
cmd target.process.command_line מיפוי ישיר
exe target.process.command_line מיפוי ישיר
file_path target.process.file.full_path מיפוי ישיר
pid target.process.pid מיפוי ישיר
לא רלוונטי extensions.auth.type קבוע: AUTHTYPE_UNSPECIFIED
לא רלוונטי metadata.event_type קבוע: USER_UNCATEGORIZED
לא רלוונטי metadata.product_name קבוע: Bluecat DDI
לא רלוונטי metadata.vendor_name קבוע: Bluecat Networks
לא רלוונטי network.application_protocol קבוע: DNS
לא רלוונטי network.dhcp.opcode קבוע: BOOTREQUEST
לא רלוונטי network.dhcp.type קבוע: DISCOVER

יומן שינויים

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

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