איסוף יומני WinSCP
במסמך הזה מוסבר איך להטמיע יומני WinSCP ב-Google Security Operations באמצעות סוכן Bindplane.
WinSCP הוא לקוח SFTP, SCP ו-FTP בקוד פתוח ל-Windows, שיוצר יומני פעילות של העברת קבצים, אימות וסשנים. הסוכן של Bindplane אוסף קובצי יומן של סשנים ב-WinSCP ישירות ממערכת הקבצים המקומית.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מכונה של Google SecOps
- Windows Server 2016 ואילך עם תמיכה בשירות
observiq-otel-collector - אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
- מחשב עם Windows שמריץ את WinSCP עם רישום ביומן מופעל
קבלת פרטי כניסה ל-Google SecOps בשביל סוכן Bindplane
כדי לאמת את סוכן Bindplane ב-Google SecOps, בוחרים באחת מהשיטות הבאות:
- פריסות חדשות: משתמשים ב-Chronicle API (אפשרות 1).
- פריסות קודמות: ממשיכים להשתמש בקובץ האימות להטמעת נתונים (אפשרות 2) עד שה-Ingestion API יופסק ב-20 ביולי 2027.
אפשרות 1: יצירת חשבון שירות ל-Chronicle API (מומלץ)
- נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט ב- Google Cloud שמקושר למכונה של Google SecOps.
- נכנסים לדף IAM & Admin > Service Accounts.
- לוחצים על Create service account.
- מזינים את פרטי ההגדרה הבאים:
- Service account name: מזינים שם לחשבון (לדוגמה,
bindplane-ingest). - Service account description: מזינים תיאור (לדוגמה,
Bindplane agent log ingestion).
- Service account name: מזינים שם לחשבון (לדוגמה,
- לוחצים על Create and continue.
- בקטע Grant this service account access to project, לוחצים על Select a role ובוחרים באפשרות Chronicle Editor.
- לוחצים על המשך ואז על סיום.
- לוחצים על חשבון השירות שיצרתם ועוברים לכרטיסייה Keys.
- לוחצים על Add key > Create new key.
- בוחרים באפשרות JSON ולוחצים על Create. קובץ המפתח יורד למחשב.
- שומרים את קובץ המפתח בתור
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כך שיתאים לנתיב שבו שמרתם אותו. - עוברים אל IAM & Admin > Settings ומעתיקים את הערך של Project number. תצטרכו אותו כדי להגדיר את הייצוא.
אפשרות 2: הורדה של קובץ האימות להטמעת נתונים (גרסה קודמת)
- נכנסים למסוף Google SecOps.
- עוברים אל הגדרות > ניהול נתונים > סוכני איסוף. אם אתם משתמשים בפלטפורמת SIEM בלבד, עוברים אל הגדרות > סוכני איסוף.
- מורידים את קובץ האימות להטמעת נתונים.
- שומרים את הקובץ בצורה מאובטחת במערכת שבה יותקן הסוכן של Bindplane.
איך מקבלים את מספר הלקוח ב-Google SecOps
- נכנסים למסוף Google SecOps.
- עוברים אל הגדרות > ניהול > פרופיל. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פרופיל.
מעתיקים את מספר הלקוח מהקטע פרטי הארגון ושומרים אותו.
התקנת הסוכן של Bindplane
מתקינים את הסוכן של Bindplane במערכת ההפעלה Windows לפי ההוראות הבאות.
התקנת חלונות
- פותחים את שורת הפקודה או את PowerShell כאדמין.
מריצים את הפקודה הבאה:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietמחכים שההתקנה תסתיים.
כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:
sc query observiq-otel-collectorהשירות אמור להופיע כ-RUNNING.
מקורות מידע נוספים בנושא התקנה
במדריך להתקנת הסוכן של Bindplane מפורטות אפשרויות התקנה נוספות ופתרונות לבעיות.
הגדרת סוכן Bindplane להטמעת יומנים ושליחה שלהם ל-Google SecOps
מאתרים את קובץ התצורה
Windows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
עריכת קובץ התצורה
מחליפים את כל התוכן של
config.yamlבהגדרות הבאות:receivers: filelog: include: - C:\Logs\WinSCP\*.log start_at: beginning exporters: chronicle/winscp: 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: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: WINSCP raw_log_field: body ingestion_labels: env: production service: pipelines: logs/winscp_to_chronicle: receivers: - filelog exporters: - chronicle/winscp
פרמטרים להגדרה
מחליפים את ה-placeholders הבאים:
הגדרת המקלט:
-
filelog: סוג המקלט לאיסוף קובצי יומן מהדיסק -
include: רשימה של נתיבי קבצים למעקב. מגדירים את המיקום שבו WinSCP כותב את יומני הסשנים (לדוגמה,C:\Logs\WinSCP\*.log) -
start_at: צריך להגדיר את הערךbeginningכדי לקרוא יומנים קיימים, או את הערךendכדי לקרוא רק רשומות חדשות
-
הגדרת הייצוא:
-
winscp: שם תיאורי של הייצואן -
creds_file_path: הנתיב המלא לקובץ המפתח של חשבון השירות בפורמט JSON (אפשרות 1):- Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Windows:
-
<customer_id>: מספר הלקוח מהשלב הקודם -
location: מחליפים את<LOCATION>באזור של המכונה של Google SecOps (לדוגמה,us,europeאוasia-southeast1). המייצא מוסיף את הערך הזה בתחילתchronicle.googleapis.com. לרשימה המלאה, ראו נקודות קצה אזוריות. -
project: מחליפים את<PROJECT_NUMBER>במספר הפרויקט שמופיע בקטע IAM & Admin > Settings. -
endpoint: משאירים את הערךchronicle.googleapis.com. -
WINSCP: סוג היומן בדיוק כמו שהוא מופיע ב-Chronicle -
ingestion_labels: תוויות אופציונליות בפורמט YAML (לדוגמה,env: production)
-
הגדרת צינור עיבוד הנתונים:
-
winscp_to_chronicle: שם תיאורי של צינור עיבוד הנתונים
-
מייצא API להטמעה מדור קודם
אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק
exportersבקוד הבא. מגדירים אתcreds_file_pathלנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים אתmalachiteingestion-pa.googleapis.comבנקודת הקצה האזורית (לדוגמה,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/winscp: compression: gzip creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: WINSCP raw_log_field: body ingestion_labels: env: production
שמירת קובץ התצורה
- אחרי שמסיימים לערוך, שומרים את הקובץ:
- Windows: לוחצים על קובץ > שמירה
מפעילים מחדש את הסוכן של Bindplane כדי להחיל את השינויים.
כדי להפעיל מחדש את הסוכן של Bindplane ב-Windows, בוחרים באחת מהאפשרויות הבאות:
שורת הפקודה או PowerShell כאדמין:
net stop observiq-otel-collector && net start observiq-otel-collectorמסוף השירותים:
- לוחצים על
Win+R, מקלידיםservices.mscולוחצים על Enter. - מאתרים את observIQ OpenTelemetry Collector.
- לוחצים לחיצה ימנית ובוחרים באפשרות הפעלה מחדש.
מוודאים שהשירות פועל:
sc query observiq-otel-collectorבודקים אם יש שגיאות ביומנים:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- לוחצים על
הגדרת ייצוא של יומן WinSCP
WinSCP כותב יומני סשנים במיקום שהמשתמש מגדיר. צריך להפעיל את הרישום ביומן ב-WinSCP ולהפנות את סוכן Bindplane לספריית היומן.
- פותחים את WinSCP במחשב עם Windows.
- עוברים אל Options > Preferences > Logging.
- מפעילים את הרישום ביומן של הסשן:
- מסמנים את האפשרות הפעלת רישום סשנים ביומן ברמה.
- בוחרים ברמת הרישום ביומן רגילה או ניפוי באגים 1.
- מגדירים את Log file name לשם קובץ יומן בנתיב מרכזי (לדוגמה,
C:\Logs\WinSCP\winscp.log).
- לוחצים על אישור כדי לשמור את ההגדרות.
יוצרים את ספריית היומן אם היא לא קיימת:
mkdir C:\Logs\WinSCPמוודאים ש-WinSCP כותב קובצי יומן לספרייה שהוגדרה אחרי הפעלה של העברת קבצים.
מוודאים שהנתיב של סוכן Bindplane
includeב-config.yamlתואם לספריית היומן.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
| directory,console,consoleinstance,public_key,script,hostkey,total_size | additional.fields | שדות נוספים בהתאמה אישית לאירוע |
| description | metadata.description | תיאור האירוע |
| חותמת זמן | metadata.event_timestamp | חותמת הזמן של האירוע |
| metadata.event_type | סוג האירוע | |
| src_ip | principal.asset.ip | כתובת ה-IP של הנכס שמשויך לחשבון המשתמש |
| local_file | principal.file.full_path | הנתיב המלא לקובץ שמשויך לחשבון המשתמש |
| src_ip | principal.ip | כתובת ה-IP של החשבון הראשי |
| command_line | principal.process.command_line | שורת הפקודה ששימשה להפעלת התהליך |
| שם משתמש | principal.user.userid | מזהה המשתמש של הישות המורשית |
| transfer_speed,result | security_result.detection_fields | שדות שקשורים לזיהוי בתוצאת האבטחה |
| file,target_file | target.file.full_path | הנתיב המלא לקובץ היעד |
| file_type | target.file.mime_type | סוג ה-MIME של קובץ היעד |
| file_size | target.file.size | גודל קובץ היעד בבייטים |
| metadata.product_name | שם המוצר שיצר את האירוע | |
| metadata.vendor_name | שם הספק של המוצר |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.