איסוף יומני SSL VPN של Array Networks

גרסת המנתח: 1.0

נתמך ב:

במסמך הזה מוסבר איך להטמיע יומני SSL VPN של Array Networks ב-Google Security Operations באמצעות סוכן Bindplane.

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

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

  • מכונה של Google SecOps
  • מארח עם Windows 2016 ואילך או Linux עם systemd
  • אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
  • גישה עם הרשאות למסוף הניהול או למכשיר של Array Networks SSL VPN (סדרת AG או vxAG)

קבלת פרטי כניסה ל-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: 'ARRAYNETWORKS_VPN'
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/source0__chronicle_w_labels-0:
          receivers:
            - udplog
          exporters:
            - chronicle/chronicle_w_labels
    
    • מחליפים את היציאה ואת כתובת ה-IP לפי הצורך בתשתית שלכם.
    • מחליפים את <CUSTOMER_ID> במספר הלקוח בפועל.
    • מעדכנים את /path/to/ingestion-authentication-file.json לנתיב הקובץ שבו נשמר קובץ המפתח של חשבון השירות (אפשרות 1) בשלב 1.
    • מחליפים את <LOCATION> באזור של המופע של Google SecOps (לדוגמה, us,‏ europe או asia-southeast1). המערכת מוסיפה את הערך הזה בתחילת chronicle.googleapis.com. לרשימה המלאה, ראו נקודות קצה אזוריות.
    • מחליפים את <PROJECT_NUMBER> במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.

מייצא 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: 'ARRAYNETWORKS_VPN'
        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 ב-Array Networks SSL VPN

  1. נכנסים למסוף הניהול של Array Networks SSL VPN (WebUI).
  2. בתפריט הניווט הימני, לוחצים על ADMIN TOOLS (כלי ניהול).
  3. לוחצים על Monitoring.
  4. לוחצים על הכרטיסייה רישום ביומן.
  5. לוחצים על כרטיסיית המשנה Syslog Servers (שרתי Syslog).
  6. בקטע REMOTE SYSLOG SERVER CONFIGURATION, לוחצים על Add Server Entry.
  7. מזינים את פרטי ההגדרה הבאים:
    • ‫Host IP: מזינים את כתובת ה-IP של סוכן Bindplane.
    • Host Port (יציאת המארח): מזינים את מספר היציאה של סוכן Bindplane (לדוגמה, 514).
    • Protocol: בוחרים באפשרות UDP או TCP, בהתאם להגדרות של סוכן Bindplane.
    • יציאת מקור: משאירים את ברירת המחדל או מציינים אם נדרש על ידי הגדרת הרשת.
    • רמה: בוחרים את רמת החומרה המינימלית להעברה (לדוגמה, מידע, אזהרה, שגיאה).
  8. לוחצים על הוספה או על שמירה כדי להחיל את ההגדרה.
  9. לוחצים על Save Configuration (שמירת ההגדרות) בחלק העליון של הדף כדי לשמור את השינויים.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM Logic (פונקציה לוגית)
clientip principal.ip כתובת ה-IP של הלקוח שחולצה מהשדה clientip בהודעת היומן הגולמית.
column1 principal.ip כתובת ה-IP חולצה מהשדה column1 ביומן הגולמי.
column1 principal.asset.ip כתובת ה-IP חולצה מהשדה column1 ביומן הגולמי.
column3 network.received_bytes מספר הבייטים שהתקבלו, שהומרו למספר שלם ללא סימן.
column4 network.http.method שיטת ה-HTTP שחולצה מ-column4 ביומן הגולמי.
column7 target.ip כתובת ה-IP של היעד שחולצה מהשדה column7 ביומן הגולמי.
dport target.port יציאת היעד, שהומרה למספר שלם.
dst target.ip כתובת ה-IP של היעד.
dst target.asset.ip כתובת ה-IP של היעד.
hostname principal.hostname שם המארח שחולץ מהשדה hostname בהודעת היומן הגולמית.
hostname principal.asset.hostname שם המארח שחולץ מהשדה hostname בהודעת היומן הגולמית.
http_method network.http.method שיטת ה-HTTP שחולצה מהודעת היומן הגולמית.
id principal.application מזהה האפליקציה מהיומן הגולמי.
mac principal.mac כתובת ה-MAC שחולצה מהשדה mac בהודעת היומן הגולמית.
msg metadata.product_event_type שדה ההודעה מהיומן הגולמי, שמשמש כסוג האירוע של המוצר. משמש גם ל-security_result.description אחרי הסרת לוכסנים הפוכים ומירכאות.
product_name metadata.product_name שם המוצר שחולץ מהודעת היומן הגולמית.
prxy_ip intermediary.ip כתובת ה-IP של שרת ה-Proxy.
prxy_port intermediary.port יציאת שרת ה-proxy, שהומרה למספר שלם.
response_code network.http.response_code קוד תגובת HTTP, שהומר למספר שלם.
security_result.action security_result.action נקבע על ידי הלוגיקה של המנתח על סמך הערך של column2. "BLOCK" אם column2 מכיל את "TCP_MISS", אחרת "UNKNOWN_ACTION".
security_result.description security_result.description שדה ההודעה מהיומן הגולמי, אחרי הסרת לוכסנים הפוכים ומירכאות.
sport principal.port יציאת המקור, מומרת למספר שלם.
src principal.ip כתובת ה-IP של המקור.
src principal.asset.ip כתובת ה-IP של המקור.
target_hostname target.hostname שם המארח של היעד שחולץ מהודעת היומן הגולמית.
timestamp metadata.event_timestamp חותמת הזמן שחולצה מהודעת היומן הגולמית ונותחה לאובייקט של חותמת זמן.
uri target.url חלק מכתובת היעד. משולב עם uri_param כדי ליצור את כתובת ה-URL המלאה.
uri_param target.url חלק מכתובת היעד. משולב עם uri כדי ליצור את כתובת ה-URL המלאה.
user target.user.userid שם המשתמש שחולץ מהודעת היומן הגולמית.
user_agent_string network.http.user_agent מחרוזת סוכן המשתמש שחולצה מהודעת היומן הגולמית.
vpn target.user.group_identifiers שם ה-VPN שחולץ מהודעת היומן הגולמית.
metadata.event_type metadata.event_type נקבע על ידי הלוגיקה של המנתח על סמך שילוב של שדות כמו has_principal,‏ has_target,‏ has_http_value ו-user. הערכים האפשריים הם "NETWORK_HTTP",‏ "NETWORK_CONNECTION",‏ "STATUS_UPDATE",‏ "USER_UNCATEGORIZED" או "GENERIC_EVENT".
network.ip_protocol network.ip_protocol אם ההודעה מכילה את המילה "TCP", מגדירים את הערך "TCP".

יומן שינויים

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

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