איסוף יומנים של Forcepoint Email Security

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

נתמך ב:

במאמר הזה מוסבר איך להטמיע יומנים של Forcepoint Email Security ב-Google Security Operations באמצעות BindPlane. המנתח קודם מחלץ שדות מהיומנים בפורמט JSON ומאתחל כמה שדות UDM עם ערכים ריקים. לאחר מכן, הוא ממפה את השדות שחולצו לשדות התואמים שלהם במבנה ה-UDM של Chronicle, על סמך תנאים ספציפיים ומניפולציות של נתונים, ובסופו של דבר יוצר ייצוג מאוחד של אירוע האבטחה באימייל.

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

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

  • מכונה של Google SecOps
  • מארח עם Windows 2016 ואילך או Linux עם systemd
  • אם מריצים את הסוכן מאחורי שרת proxy, מוודאים שיציאות חומת האש פתוחות בהתאם לדרישות של סוכן BindPlane
  • גישה עם הרשאות למכשיר או למסוף הניהול של Forcepoint Email Security

קבלת פרטי כניסה ל-Google SecOps עבור סוכן Bindplane

כדי לאמת את סוכן Bindplane ב-Google SecOps, בוחרים באחת מהשיטות הבאות:

  • פריסות חדשות: משתמשים ב-Chronicle API (אפשרות 1).
  • פריסות מדור קודם: אפשר להמשיך להשתמש בקובץ האימות של ה-API להעברת נתונים (אפשרות 2) עד שה-API להעברת נתונים יפסיק לפעול ב-20 ביולי 2027.
  1. נכנסים אל Google Cloud המסוף ובוחרים את Google Cloud הפרויקט שמקושר למופע של Google SecOps.
  2. נכנסים לדף IAM & Admin > Service Accounts.
  3. לוחצים על יצירת חשבון שירות.
  4. מזינים את פרטי ההגדרה הבאים:
    • שם חשבון השירות: מזינים שם לחשבון (לדוגמה, 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 (ניהול הרשאות גישה ואדמין > הגדרות) ומעתיקים את מספר הפרויקט. תצטרכו אותו כדי להגדיר את כלי הייצוא.

אפשרות 2: הורדת קובץ אימות להטמעת נתונים (גרסה מדור קודם)

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל SIEM Settings > Collection Agents (הגדרות SIEM > סוכני איסוף).
  3. מורידים את קובץ האימות להטמעת נתונים.
  4. שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן הסוכן של Bindplane.

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

  1. נכנסים למסוף Google SecOps.
  2. עוברים אל SIEM Settings > Profile.
  3. מעתיקים ושומרים את מזהה הלקוח מהקטע פרטי הארגון.

התקנת BindPlane Agent

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

התקנה ב-Windows

  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 או Notepad).
  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: 'FORCEPOINT_EMAILSECURITY'
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/source0__chronicle_w_labels-0:
          receivers:
            - udplog
          exporters:
            - chronicle/chronicle_w_labels
    
  3. מחליפים את היציאה ואת כתובת ה-IP לפי הצורך בתשתית שלכם.

  4. מחליפים את <LOCATION> באזור של מכונת Google SecOps (לדוגמה, us,‏ europe או asia-southeast1). המייצא מוסיף את הערך הזה בתחילת chronicle.googleapis.com.

  5. מחליפים את <PROJECT_NUMBER> במספר הפרויקט מתוך IAM & Admin > Settings.

  6. מחליפים את <CUSTOMER_ID> במספר הלקוח בפועל.

  7. מעדכנים את /path/to/ingestion-authentication-file.json לנתיב הקובץ שבו נשמר קובץ המפתח של חשבון השירות (אפשרות 1) בשלב 1.

כלי לייצוא נתונים מ-Legacy ingestion 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: 'FORCEPOINT_EMAILSECURITY'
        raw_log_field: body
        ingestion_labels:
    

מפעילים מחדש את BindPlane Agent כדי להחיל את השינויים.

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

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

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

הגדרת העברת Syslog ב-Forcepoint Email Security

  1. נכנסים ל-Forcepoint Email Security Management Console.
  2. עוברים אל הגדרות > שילובים > שילוב SIEM.
  3. לוחצים על הפעלת שילוב SIEM.
  4. ממלאים את פרטי ההגדרה הבאים:

    • פורמט: בוחרים באפשרות LEEF (פורמט מורחב של אירועי יומן).
    • שרת Syslog: מזינים את כתובת ה-IP של BindPlane Agent.
    • ‫Syslog Port: מזינים את מספר היציאה של סוכן BindPlane (לדוגמה, 514).
    • ‫Protocol: בוחרים באפשרות UDP או TCP, בהתאם להגדרות בפועל של BindPlane Agent.
    • מתקן: בוחרים את קוד המתקן של syslog (לדוגמה, Local0).
    • חומרה: בוחרים את רמת החומרה של האירועים ביומן.
  5. לוחצים על Save.

טבלת מיפוי UDM

שדה ביומן מיפוי UDM היגיון
פעולה security_result.action_details ממופה ישירות מהשדה "פעולה" ביומן הגולמי.
AttachmentFilename additional.fields.value.list_value.values.string_value (key: Attachments_FileNames) השדה AttachmentFilename מפוצל באמצעות פסיק, ואז כל ערך מתווסף כ-string_value למערך additional.fields עם המפתח Attachments_FileNames.
AttachmentFileType additional.fields.value.list_value.values.string_value (key: AttachmentsFileType) השדה AttachmentFileType מפוצל באמצעות פסיק, ואז כל ערך מתווסף כ-string_value למערך additional.fields עם המפתח AttachmentsFileType.
AttachmentSize additional.fields.value.list_value.values.string_value (key: AttachmentsSize) השדה AttachmentSize מפוצל באמצעות פסיק, ואז כל ערך מתווסף כ-string_value למערך additional.fields עם המפתח AttachmentsSize.
DateTime לא ממופה ב-UDM שסופק.
EnvelopeSender network.email.from ממופה ישירות מהשדה EnvelopeSender ביומן הגולמי.
EventReceivedTime metadata.event_timestamp מנותח לפורמט של חותמת זמן וממופה ל-"metadata.event_timestamp".
FilteringReason security_result.category_details ממופה ישירות מהשדה FilteringReason ביומן הגולמי.
MessageSandboxing security_result.detection_fields.value (key: MessageSandboxing) ממופה ישירות מהשדה MessageSandboxing ביומן הגולמי, ונוסף כצמד מפתח/ערך למערך security_result.detection_fields.
MessageSize security_result.detection_fields.value (key: MessageSize) ממופה ישירות מהשדה MessageSize ביומן הגולמי ומתווסף כצמד מפתח/ערך למערך security_result.detection_fields.
nxlog_filename additional.fields.value.string_value (key: nxlog_filename) ממופה ישירות מהשדה nxlog_filename ביומן הגולמי, ומתווסף כצמד מפתח/ערך למערך additional.fields.
RecipientAddress network.email.to מופה ישירות מהשדה 'RecipientAddress' ביומן הגולמי.
SenderIP principal.asset.ip, principal.ip ממופה ישירות מהשדה SenderIP ביומן הגולמי.
SenderIPCountry principal.location.country_or_region ממופה ישירות מהשדה SenderIPCountry ביומן הגולמי.
SourceModuleName principal.resource.attribute.labels.value (key: SourceModuleName) ממופה ישירות מהשדה "SourceModuleName" ביומן הגולמי, ונוסף כצמד מפתח/ערך למערך "principal.resource.attribute.labels".
SourceModuleType principal.resource.attribute.labels.value (key: SourceModuleType) מופה ישירות מהשדה SourceModuleType ביומן הגולמי ונוסף כמפתח/ערך למערך principal.resource.attribute.labels.
SpamScore security_result.detection_fields.value (key: SpamScore) ממופה ישירות מהשדה SpamScore ביומן הגולמי ומתווסף כצמד מפתח/ערך למערך security_result.detection_fields.
נושא network.email.subject ממופה ישירות מהשדה "נושא" ביומן הגולמי.
VirusName security_result.detection_fields.value (key: VirusName) ממופה ישירות מהשדה VirusName ביומן הגולמי ונוסף כמפתח/ערך למערך security_result.detection_fields.
metadata.event_type הערך נקבע על סמך הנוכחות של שדות אחרים. אם הערך של has_network_email_data הוא true, הערך של המאפיין הוא EMAIL_TRANSACTION. אם הערך של "has_principal" הוא True, הערך מוגדר כ-"STATUS_UPDATE". אחרת, ברירת המחדל היא "GENERIC_EVENT".
metadata.product_name הערך הוא FORCEPOINT EMAILSECURITY.
metadata.vendor_name הערך הוא FORCEPOINT EMAILSECURITY.

יומן שינויים

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

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