איסוף יומנים של מתג Cisco

גרסת כלי הניתוח: 27.0

נתמך ב:

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

מתגי Cisco יוצרים הודעות syslog לגבי שינויים במצב היציאה, אירועים של עץ פורש, התאמות של ACL, אימות ופעולות מערכת. הכלי לניתוח מחלץ שדות באמצעות דפוסי grok וממפה אותם למודל הנתונים המאוחד (UDM).

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

חשוב לוודא שמתקיימות הדרישות המוקדמות הבאות:

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

קבלת קובץ אימות להטמעת נתונים ב-Google SecOps

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל SIEM Settings > Collection Agents.
  3. הורדה של קובץ אימות להטמעת נתונים

  4. שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן סוכן Bindplane.

איך מוצאים את מספר הלקוח ב-Google SecOps

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל SIEM Settings > Profile (הגדרות SIEM > פרופיל).

  3. מעתיקים את מזהה הלקוח מהקטע פרטי הארגון ושומרים אותו.

התקנת סוכן Bindplane

מתקינים את סוכן Bindplane במערכת ההפעלה Windows או Linux לפי ההוראות הבאות.

התקנה ב-Windows

  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 /etc/bindplane-agent/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/cisco_switch:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: CISCO_SWITCH
        raw_log_field: body

service:
    pipelines:
        logs/cisco_switch_to_chronicle:
            receivers:
                - udplog
            exporters:
                - chronicle/cisco_switch

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

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

  • הגדרת מקלט:

    • ‫listen_address: כתובת ה-IP והיציאה להאזנה:
      • ‫0.0.0.0 כדי להאזין בכל הממשקים (מומלץ)
      • יציאה 514 היא יציאת syslog רגילה (נדרשת הרשאת root ב-Linux; אפשר להשתמש ב-1514 ללא הרשאת root)

  • הגדרת כלי הייצוא:

    • ‫creds_file_path: הנתיב המלא לקובץ האימות להטמעת נתונים:
      • ‫Linux: /etc/bindplane-agent/ingestion-auth.json
      • ‫Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • ‫customer_id: מספר הלקוח שהועתק ממסוף Google SecOps
    • ‫endpoint: כתובת ה-URL של נקודת הקצה האזורית:
      • ארה"ב: malachiteingestion-pa.googleapis.com
      • אירופה: europe-malachiteingestion-pa.googleapis.com
      • אסיה: asia-southeast1-malachiteingestion-pa.googleapis.com
      • רשימה מלאה מופיעה במאמר בנושא נקודות קצה אזוריות.

שמירת קובץ ההגדרות

  • אחרי שמסיימים לערוך, שומרים את הקובץ:
    • ‫Linux: מקישים על Ctrl+O, אחר כך על Enter ואז על Ctrl+X.
    • ‫Windows: לוחצים על קובץ > שמירה.

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

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

    sudo systemctl restart observiq-otel-collector

    1. מוודאים שהשירות פועל:

      ```bash
sudo systemctl status observiq-otel-collector
```

    2. בודקים אם יש שגיאות ביומנים:

      ```bash
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 במתג Cisco

  1. נכנסים ל-Cisco Switch.

  2. העלאת רמת ההרשאות:

    enable

  3. עוברים למצב הגדרה:

    conf t

  4. הגדרת syslog:

    logging host <BINDPLANE_IP> transport <tcp/udp> port <PORT>
logging source-interface <INTERFACE>
    • מחליפים את <BINDPLANE_IP> בכתובת ה-IP של סוכן Bindplane.
    • מחליפים את <tcp/udp> בפרוטוקול ההאזנה שהוגדר (לדוגמה, udp).
    • מחליפים את <INTERFACE> במזהה הממשק של Cisco.

  5. מגדירים את רמת העדיפות:

    logging trap Informational
logging console Informational
logging severity Informational

  6. מגדירים את המתקן של syslog:

    logging facility local6

  7. הפעלת חותמות זמן:

    service timestamps log datetime

  8. שומרים ויוצאים.

  9. שמירת ההגדרה כדי שהיא תישמר גם אחרי הפעלה מחדש:

    copy running-config startup-config

טבלת מיפוי UDM

שדה ביומן מיפוי UDM היגיון
פעולה security_result.action_details הערך בשדה הזה נגזר מהשדה action ביומן הגולמי.
יום
description metadata.description הערך בשדה הזה נגזר מהשדה description ביומן הגולמי.
description security_result.description הערך בשדה הזה נגזר מהשדה description ביומן הגולמי.
destination_ip target.asset.ip הערך בשדה הזה נגזר מהשדה destination_ip ביומן הגולמי.
destination_ip target.ip הערך בשדה הזה נגזר מהשדה destination_ip ביומן הגולמי.
destination_port target.port הערך בשדה הזה נגזר מהשדה destination_port ביומן הגולמי.
מכשיר principal.asset.hostname הערך בשדה הזה נגזר מהשדה device ביומן הגולמי.
מכשיר principal.hostname הערך בשדה הזה נגזר מהשדה device ביומן הגולמי.
מכשיר target.asset.hostname הערך בשדה הזה נגזר מהשדה device ביומן הגולמי.
מכשיר target.hostname הערך בשדה הזה נגזר מהשדה device ביומן הגולמי.
device_ip principal.asset.ip הערך בשדה הזה נגזר מהשדה device_ip ביומן הגולמי.
device_ip principal.ip הערך בשדה הזה נגזר מהשדה device_ip ביומן הגולמי.
device_ip target.asset.ip הערך בשדה הזה נגזר מהשדה device_ip ביומן הגולמי.
device_ip target.ip הערך בשדה הזה נגזר מהשדה device_ip ביומן הגולמי.
facility principal.resource.type הערך בשדה הזה נגזר מהשדה facility ביומן הגולמי.
header_data metadata.product_log_id הערך בשדה הזה נגזר מהשדה header_data ביומן הגולמי.
header_data target.asset.ip הערך בשדה הזה נגזר מהשדה header_data ביומן הגולמי.
header_data target.ip הערך בשדה הזה נגזר מהשדה header_data ביומן הגולמי.
שם המארח principal.asset.hostname הערך בשדה הזה נגזר מהשדה hostname ביומן הגולמי.
שם המארח principal.hostname הערך בשדה הזה נגזר מהשדה hostname ביומן הגולמי.
ip principal.asset.ip הערך בשדה הזה נגזר מהשדה ip ביומן הגולמי.
ip principal.ip הערך בשדה הזה נגזר מהשדה ip ביומן הגולמי.
ip_address principal.asset.ip הערך בשדה הזה נגזר מהשדה ip_address ביומן הגולמי.
ip_address principal.ip הערך בשדה הזה נגזר מהשדה ip_address ביומן הגולמי.
ip_protocol network.ip_protocol הערך בשדה הזה נגזר מהשדה ip_protocol ביומן הגולמי.
Mac principal.mac הערך בשדה הזה נגזר מהשדה mac ביומן הגולמי.
מנמוניקה network.dhcp.opcode הערך בשדה הזה נגזר מהשדה mnemonic ביומן הגולמי.
מנמוניקה metadata.product_event_type הערך בשדה הזה נגזר מהשדה mnemonic ביומן הגולמי.
month
p_ip principal.asset.ip הערך בשדה הזה נגזר מהשדה p_ip ביומן הגולמי.
p_ip principal.ip הערך בשדה הזה נגזר מהשדה p_ip ביומן הגולמי.
יציאה target.port הערך בשדה הזה נגזר מהשדה port ביומן הגולמי.
עדיפות
פרוטוקול network.ip_protocol הערך בשדה הזה נגזר מהשדה protocol ביומן הגולמי.
reason
כלל security_result.rule_id הערך בשדה הזה נגזר מהשדה rule ביומן הגולמי.
sec_result_action security_result.action הערך בשדה הזה נגזר מהשדה sec_result_action ביומן הגולמי.
severity
מקור principal.asset.ip הערך בשדה הזה נגזר מהשדה source ביומן הגולמי.
מקור principal.ip הערך בשדה הזה נגזר מהשדה source ביומן הגולמי.
source_ip network.dhcp.ciaddr הערך בשדה הזה נגזר מהשדה source_ip ביומן הגולמי.
source_ip principal.asset.ip הערך בשדה הזה נגזר מהשדה source_ip ביומן הגולמי.
source_ip principal.ip הערך בשדה הזה נגזר מהשדה source_ip ביומן הגולמי.
source_mac network.dhcp.chaddr הערך בשדה הזה נגזר מהשדה source_mac ביומן הגולמי.
source_port principal.port הערך בשדה הזה נגזר מהשדה source_port ביומן הגולמי.
סיכום security_result.summary הערך בשדה הזה נגזר מהשדה summary ביומן הגולמי.
פעם
אזור זמן
משתמש principal.user.userid הערך בשדה הזה נגזר מהשדה user ביומן הגולמי.
משתמש target.user.userid הערך בשדה הזה נגזר מהשדה user ביומן הגולמי.
מתי
שנה
extensions.auth.type מכונה
metadata.log_type CISCO_SWITCH
metadata.vendor_name Cisco
metadata.product_name Cisco Switch
network.application_protocol DHCP
network.dhcp.type בקשה
intermediary_ip event.idm.read_only_udm.intermediary.ip וגם event.idm.read_only_udm.intermediary.asset.ip מופה מיומן השינויים
priority event.idm.read_only_udm.additional.fields מופה מיומן השינויים
product_log_id event.idm.read_only_udm.metadata.product_log_id מופה מיומן השינויים
_time event.idm.read_only_udm.metadata.collected_timestamp מופה מיומן השינויים
vlan_data event.idm.read_only_udm.intermediary.resource.attribute.labels מופה מיומן השינויים
intermediary_ip event.idm.read_only_udm.intermediary.ip מופה מיומן השינויים
intermediary_ip event.idm.read_only_udm.intermediary.asset.ip מופה מיומן השינויים
time_stamp event.idm.read_only_udm.metadata.event_timestamp מופה מיומן השינויים
process_name event.idm.read_only_udm.additional.fields מופה מיומן השינויים
switch_id event.idm.read_only_udm.additional.fields מופה מיומן השינויים
log_seq_num event.idm.read_only_udm.additional.fields מופה מיומן השינויים
log_seq_num_2 event.idm.read_only_udm.additional.fields מופה מיומן השינויים
p_interface event.idm.read_only_udm.principal.resource.name מופה מיומן השינויים
audit_session_id event.idm.read_only_udm.security_result.detection_fields מופה מיומן השינויים
mac event.idm.read_only_udm.principal.mac מופה מיומן השינויים
packets event.idm.read_only_udm.network.sent_packets מופה מיומן השינויים
facility event.idm.read_only_udm.principal.resource.resource_subtype מופה מיומן השינויים
seq_num event.idm.read_only_udm.additional.fields מופה מיומן השינויים
device_hostname event.idm.read_only_udm.principal.hostname וגם event.idm.read_only_udm.principal.asset.hostname מופה מיומן השינויים
id event.idm.read_only_udm.principal.user.userid מופה מיומן השינויים
seq_num event.idm.read_only_udm.target.user.userid מופה מיומן השינויים
log_message event.idm.read_only_udm.metadata.description מופה מיומן השינויים
syslog_tag event.idm.read_only_udm.additional.fields מופה מיומן השינויים
syslog_pri event.idm.read_only_udm.additional.fields מופה מיומן השינויים
appcat event.idm.read_only_udm.additional.fields מופה מיומן השינויים
applist event.idm.read_only_udm.additional.fields מופה מיומן השינויים
dstintf event.idm.read_only_udm.additional.fields מופה מיומן השינויים
dstintfrole event.idm.read_only_udm.additional.fields מופה מיומן השינויים
mastersrcmac event.idm.read_only_udm.additional.fields מופה מיומן השינויים
osname event.idm.read_only_udm.additional.fields מופה מיומן השינויים
poluuid event.idm.read_only_udm.additional.fields מופה מיומן השינויים
service event.idm.read_only_udm.additional.fields מופה מיומן השינויים
srchwvendor event.idm.read_only_udm.additional.fields מופה מיומן השינויים
srcintf event.idm.read_only_udm.additional.fields מופה מיומן השינויים
srcintfrole event.idm.read_only_udm.additional.fields מופה מיומן השינויים
srcserver event.idm.read_only_udm.additional.fields מופה מיומן השינויים
transport event.idm.read_only_udm.additional.fields מופה מיומן השינויים
trandisp event.idm.read_only_udm.additional.fields מופה מיומן השינויים
vd event.idm.read_only_udm.additional.fields מופה מיומן השינויים
vwlid event.idm.read_only_udm.additional.fields מופה מיומן השינויים
devid event.idm.read_only_udm.intermediary.asset.product_object_id מופה מיומן השינויים
devname event.idm.read_only_udm.intermediary.hostname מופה מיומן השינויים
logid event.idm.read_only_udm.metadata.product_log_id מופה מיומן השינויים
subtype event.idm.read_only_udm.network.direction מופה מיומן השינויים
proto event.idm.read_only_udm.network.ip_protocol מופה מיומן השינויים
rcvdbyte event.idm.read_only_udm.network.received_bytes מופה מיומן השינויים
sentbyte event.idm.read_only_udm.network.sent_bytes מופה מיומן השינויים
sentpkt event.idm.read_only_udm.network.sent_packets מופה מיומן השינויים
duration event.idm.read_only_udm.network.session_duration.seconds מופה מיומן השינויים
sessionid event.idm.read_only_udm.network.session_id מופה מיומן השינויים
srcname event.idm.read_only_udm.principal.asset.hostname, event.idm.read_only_udm.principal.hostname מופה מיומן השינויים
srcip event.idm.read_only_udm.principal.asset.ip, event.idm.read_only_udm.principal.ip מופה מיומן השינויים
srcmac event.idm.read_only_udm.principal.asset.mac, event.idm.read_only_udm.principal.mac מופה מיומן השינויים
osname event.idm.read_only_udm.principal.asset.platform_software.platform מופה מיומן השינויים
srcswversion event.idm.read_only_udm.principal.asset.platform_software.platform_version מופה מיומן השינויים
srccountry event.idm.read_only_udm.principal.location.country_or_region מופה מיומן השינויים
transip event.idm.read_only_udm.principal.nat_ip מופה מיומן השינויים
srcport event.idm.read_only_udm.principal.port מופה מיומן השינויים
action event.idm.read_only_udm.security_result.action מופה מיומן השינויים
policyid event.idm.read_only_udm.security_result.rule_id מופה מיומן השינויים
policyname event.idm.read_only_udm.security_result.rule_name מופה מיומן השינויים
policytype event.idm.read_only_udm.security_result.rule_type מופה מיומן השינויים
level event.idm.read_only_udm.security_result.severity מופה מיומן השינויים
action event.idm.read_only_udm.security_result.summary מופה מיומן השינויים
dstip event.idm.read_only_udm.target.asset.ip, event.idm.read_only_udm.target.ip מופה מיומן השינויים
dstcountry event.idm.read_only_udm.target.location.country_or_region מופה מיומן השינויים
dstport event.idm.read_only_udm.target.port מופה מיומן השינויים
device principle.hostname מופה מיומן השינויים
username3 principal.user.userid מופה מיומן השינויים
login_status security_result.summary מופה מיומן השינויים
ecs.version metadata.product_version מופה מיומן השינויים
fileset.name", "flow.locality", "flow.id", "input.type", "netflow.exporter.source_id", and "netflow.exporter.uptime_millis additional.fields מופה מיומן השינויים
network.transport network.ip_protocol מופה מיומן השינויים
netflow.post_nat_source_ipv4_address principal.ip מופה מיומן השינויים
netflow.source_transport_port principal.port מופה מיומן השינויים
network.direction network.direction מופה מיומן השינויים
intermediary_ip intermediary.ip מופה מיומן השינויים
intermediary_hostname intermediary.hostname מופה מיומן השינויים
principal_host principal.hostname מופה מיומן השינויים
src_mac principal.mac מופה מיומן השינויים
eventSummary metadata.product_event_type מופה מיומן השינויים
error_msg security_result.detection_fields מופה מיומן השינויים
pid principal.process.pid מופה מיומן השינויים
srcPort principal.port מופה מיומן השינויים
srcUser principal.user.userid מופה מיומן השינויים
username1 target.user.userid מופה מיומן השינויים
command target.process.command_line מופה מיומן השינויים
PWD target.process.file.full_path מופה מיומן השינויים
node_id", "cluster_id", "exception", "UniqueId", and "app_id additional.fields מופה מיומן השינויים
DEVICE principal.mac מופה מיומן השינויים
SRC principal.ip מופה מיומן השינויים
SPT principal.port מופה מיומן השינויים
DST target.ip מופה מיומן השינויים
DPT target.port מופה מיומן השינויים
ID network.session_id מופה מיומן השינויים
LEN network.session_duration.seconds מופה מיומן השינויים
PROTO network.ip_protocol מופה מיומן השינויים
IN", "OUT", "PHYSIN", "WINDOW", "RES, "TOS", "PREC", "TTL" ,"URGP", "MAC", "radio", "vap", "auth_type", "sugg_band", "ssid_id", "ssid_profile_name" and "protocol additional.fields מופה מיומן השינויים
client_mac principal.mac מופה מיומן השינויים
aid network.session_id מופה מיומן השינויים
rssi intermediary.asset.product_object_id מופה מיומן השינויים
channel security_result.detection_fields מופה מיומן השינויים
eventSummary", "dhcp_ip", "client_mac", "aid" and "ip_src metadata.product_event_type מופה מיומן השינויים
mac", "src", "sport", "dst", "dport", "action", "protocol", "url" and "signature principal.mac מופה מיומן השינויים
metadata.event_type" and "extensions.auth.type USER_LOGIN מופה מיומן השינויים
eventSummary", "aid", "rssi", "channel", "last_known_client_ip" and "event_type security_result.summary מופה מיומן השינויים
pid target.process.pid מופה מיומן השינויים
app_name target.application מופה מיומן השינויים

יומן שינויים

צפייה ביומן השינויים של מנתח התוכן הזה

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