איסוף יומני ClamAV
גרסת המנתח: 3.0
במאמר הזה מוסבר איך להטמיע יומני ClamAV ב-Google Security Operations באמצעות סוכן Bindplane.
ClamAV הוא מנוע אנטי-וירוס בקוד פתוח שנועד לזהות סוסים טרויאניים, וירוסים, תוכנות זדוניות ואיומים זדוניים אחרים. הוא מספק סריקה של שורת הפקודה, עדכונים אוטומטיים של מסד נתונים של חתימות, ותומך בכמה פורמטים של קבצים, כולל ארכיונים, קובצי הפעלה ומסמכים. ClamAV פועל כ-daemon מקומי (clamd) או כסורק שורת פקודה (clamscan) במערכות Linux, Unix ו-Windows.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מכונה של Google SecOps
- Windows Server 2016 ואילך, או מארח Linux עם
systemd - קישוריות רשת בין המארח של סוכן Bindplane לבין שרת ClamAV
- אם השרת פועל מאחורי שרת proxy, צריך לוודא שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
- ClamAV מותקן ופועל בנקודות קצה של Linux
- גישה לרמה הבסיסית (root) או ל-sudo לשרת ClamAV ולמארח של סוכן Bindplane
קבלת פרטי כניסה ל-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 או Linux לפי ההוראות הבאות.
התקנת חלונות
- פותחים את שורת הפקודה או את PowerShell כאדמין.
מריצים את הפקודה הבאה:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietמחכים שההתקנה תסתיים.
כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:
sc query observiq-otel-collectorסטטוס השירות צריך להיות RUNNING.
התקנה ב-Linux
- פותחים טרמינל עם הרשאות root או sudo.
מריצים את הפקודה הבאה:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shמחכים שההתקנה תסתיים.
כדי לוודא שההתקנה בוצעה, מריצים את הפקודה:
sudo systemctl status observiq-otel-collectorסטטוס השירות צריך להיות active (running).
מקורות מידע נוספים בנושא התקנה
במדריך להתקנת הסוכן של Bindplane מפורטות אפשרויות התקנה נוספות ופתרונות לבעיות.
הגדרת סוכן Bindplane כדי להטמיע את syslog ולשלוח יומנים ל-Google SecOps
מאתרים את קובץ התצורה
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
עריכת קובץ התצורה
מחליפים את כל התוכן של
config.yamlבהגדרות הבאות:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/clamav: 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: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: chronicle.googleapis.com log_type: CLAM_AV raw_log_field: body ingestion_labels: env: production service: pipelines: logs/clamav_to_chronicle: receivers: - udplog exporters: - chronicle/clamavמחליפים את ה-placeholders הבאים:
הגדרת המקלט:
-
listen_address: צריך להגדיר את הערך0.0.0.0:514כדי להאזין לכל הממשקים ביציאת UDP 514. אם יציאה 514 דורשת הרשאות ברמה הבסיסית (root) ב-Linux, צריך להשתמש ב-0.0.0.0:1514ולהגדיר את rsyslog להעביר ליציאה 1514.
-
הגדרת הייצוא:
creds_file_path: הנתיב המלא לקובץ המפתח של חשבון השירות בפורמט JSON (אפשרות 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: מחליפים אתYOUR_CUSTOMER_IDבמזהה הלקוח שקיבלתם קודם
location: מחליפים את<LOCATION>באזור של המכונה של Google SecOps (לדוגמה,us,europeאוasia-southeast1). המייצא מוסיף את הערך הזה בתחילתchronicle.googleapis.com. לרשימה המלאה, ראו נקודות קצה אזוריות.
project: מחליפים את<PROJECT_NUMBER>במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.
endpoint: משאירים את הערךchronicle.googleapis.com.
log_type: מוגדר לערךCLAM_AV(התאמה מדויקת למנתח של Google SecOps)
ingestion_labels: תוויות אופציונליות בפורמט YAML (לדוגמה,env: production)
מייצא API להטמעה מדור קודם
אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק
exportersבקוד הבא. מגדירים אתcreds_file_pathלנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים אתmalachiteingestion-pa.googleapis.comבנקודת הקצה האזורית (לדוגמה,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/clamav: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: malachiteingestion-pa.googleapis.com log_type: CLAM_AV raw_log_field: body ingestion_labels: env: production
שמירת קובץ התצורה
אחרי העריכה, שומרים את הקובץ:
- Linux: לוחצים על
Ctrl+O, אחר כך עלEnterואז עלCtrl+X - Windows: לוחצים על קובץ > שמירה
מפעילים מחדש את הסוכן של Bindplane כדי להחיל את השינויים.
כדי להפעיל מחדש את סוכן Bindplane ב-Linux:
מריצים את הפקודה הבאה:
sudo systemctl restart observiq-otel-collectorמוודאים שהשירות פועל:
sudo systemctl status observiq-otel-collectorבודקים אם יש שגיאות ביומנים:
sudo journalctl -u observiq-otel-collector -f
כדי להפעיל מחדש את הסוכן של 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"
הגדרת העברת syslog של ClamAV
הפעלת רישום ביומן של syslog ב-ClamAV
- נכנסים למערכת Linux שבה פועל ClamAV עם הרשאות root או sudo.
פותחים את קובץ התצורה של ClamAV daemon:
sudo nano /etc/clamav/clamd.confמוצאים את השורה שכתוב בה
#LogSyslog yesאו#LogSyslog true.מסירים את תו ההערה
#כדי להפעיל את הרישום ביומן של syslog:LogSyslog yesאופציונלי: מגדירים את מתקן ה-syslog. מוצאים את השורה
#LogFacility LOG_LOCAL6ומבטלים את הסימון שלה כהערה:LogFacility LOG_LOCAL6אופציונלי: מפעילים אפשרויות רישום נוספות כדי לקבל יומנים מפורטים יותר:
LogTime yes LogVerbose yes ExtendedDetectionInfo yes-
LogTime: הוספת חותמות זמן להודעות ביומן -
LogVerbose: הפעלת רישום מפורט ביומן עם פרטים נוספים ExtendedDetectionInfo: כולל את גודל הקובץ ואת ה-hash עם זיהוי הווירוסים
-
שומרים את הקובץ ויוצאים:
לוחצים על
Ctrl+O, אחר כך עלEnterואז עלCtrl+Xמפעילים מחדש את ה-daemon של ClamAV כדי להחיל את השינויים:
sudo systemctl restart clamav-daemonמוודאים שהדמון של ClamAV פועל:
sudo systemctl status clamav-daemon
הגדרת rsyslog להעברת יומני ClamAV
יוצרים קובץ תצורה חדש של rsyslog להעברת ClamAV:
sudo nano /etc/rsyslog.d/30-clamav-forward.confמוסיפים את ההגדרות הבאות כדי להעביר את היומנים של ClamAV לסוכן Bindplane:
# Forward ClamAV logs (LOG_LOCAL6 facility) to Bindplane agent if $syslogfacility-text == 'local6' then { action( type="omfwd" protocol="udp" target="BINDPLANE_AGENT_IP" port="514" queue.type="linkedList" queue.size="10000" action.resumeRetryCount="100" ) stop }מחליפים את
BINDPLANE_AGENT_IPבכתובת ה-IP של המארח של סוכן Bindplane:- אם Bindplane מותקן באותו מארח כמו ClamAV, משתמשים ב-
127.0.0.1 - אם Bindplane נמצא במארח אחר, צריך להשתמש בכתובת ה-IP של המארח הזה (לדוגמה,
192.168.1.100)
- אם Bindplane מותקן באותו מארח כמו ClamAV, משתמשים ב-
אם הגדרתם את Bindplane להאזין ליציאה אחרת (לדוגמה,
1514), צריך לעדכן את הפרמטרportבהתאם.שומרים את הקובץ ויוצאים:
לוחצים על
Ctrl+O, אחר כך עלEnterואז עלCtrl+Xמאמתים את תחביר ההגדרות של rsyslog:
sudo rsyslogd -N1מפעילים מחדש את rsyslog כדי להחיל את השינויים:
sudo systemctl restart rsyslogמוודאים ש-rsyslog פועל:
sudo systemctl status rsyslog
בדיקת ההגדרות האישיות
יוצרים זיהוי וירוס לבדיקה באמצעות קובץ הבדיקה של EICAR:
cd /tmp echo 'X5O!P%@AP[4\PZX54(P^)7CC)7}$EICAR-STANDARD-ANTIVIRUS-TEST-FILE!$H+H*' > eicar.comסורקים את קובץ הבדיקה באמצעות ClamAV:
sudo clamdscan /tmp/eicar.comמוודאים שהזיהוי מופיע ב-syslog:
sudo tail -f /var/log/syslog | grep clamdאמורה להופיע רשומת יומן דומה לזו:
Jan 15 10:30:45 hostname clamd[1234]: /tmp/eicar.com: Win.Test.EICAR_HDB-1(44d88612fea8a8f36de82e1278abb02f:68) FOUNDבודקים את יומני הפעילות של סוכן Bindplane כדי לוודא שהיומנים מועברים:
sudo journalctl -u observiq-otel-collector -fמוודאים שהיומנים מופיעים ב-Google SecOps:
- נכנסים למסוף Google SecOps.
- עוברים אל חיפוש > חיפוש ב-UDM.
מריצים שאילתת חיפוש של יומני ClamAV:
metadata.log_type = "CLAM_AV"
מנקים את קובץ הבדיקה:
sudo rm /tmp/eicar.com
הגדרה חלופית: העברת כל ההודעות של syslog ל-Bindplane
אם רוצים להעביר את כל הודעות ה-syslog (לא רק ClamAV) ל-Bindplane, משתמשים בהגדרה הפשוטה יותר:
עורכים את ההגדרות של rsyslog:
sudo nano /etc/rsyslog.d/30-forward-all.confמוסיפים את ההגדרות הבאות:
# Forward all logs to Bindplane agent *.* action( type="omfwd" protocol="udp" target="BINDPLANE_AGENT_IP" port="514" queue.type="linkedList" queue.size="10000" action.resumeRetryCount="100" )מחליפים את
BINDPLANE_AGENT_IPבכתובת ה-IP המתאימה.שומרים, מאמתים ומפעילים מחדש את rsyslog כמו שמתואר בשלבים הקודמים.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
| parsed_msg.resource.labels.instance_id | observer.resource.id | הערך הועתק ישירות |
| parsed_msg.labels.compute.googleapis.com/resource_name | observer.resource.name | הערך הועתק ישירות |
| parsed_msg.resource.type, parsed_msg.labels.container.googleapis.com/stream | observer.resource.type | משורשר מ-parsed_msg.resource.type ומ-parsed_msg.labels.container.googleapis.com/stream עם מפריד "/" |
| parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name, parsed_msg.resource.labels.container_name | observer.hostname | משורשר מ-parsed_msg.resource.labels.project_id, מ-parsed_msg.resource.labels.cluster_name ומ-parsed_msg.resource.labels.container_name עם מפרידי "/" |
| parsed_msg.resource.labels.container_name | observer.application | הערך הועתק ישירות |
| parsed_msg.labels.container.googleapis.com/namespace_name | observer.namespace | הערך הועתק ישירות |
| parsed_msg.resource.labels.zone | observer.location.country_or_region | הערך הועתק ישירות |
| parsed_msg.resource.labels.pod_id | observer.labels | מוזג כמפתח "pod_id" עם ערך מ-parsed_msg.resource.labels.pod_id |
| parsed_msg.resource.labels.project_id, parsed_msg.resource.labels.cluster_name, parsed_msg.resource.labels.container_name | principal.hostname | משורשר מ-parsed_msg.resource.labels.project_id, מ-parsed_msg.resource.labels.cluster_name ומ-parsed_msg.resource.labels.container_name עם מפרידי "/" |
| file, _file_path | target.file.full_path | ערך מהקובץ אם הוא חולץ מתבנית grok, אחרת מ-_file_path אם הוא חולץ מתבנית grok חלופית |
| איום | security_result.threat_name | הערך הועתק ישירות |
| total_files, _outcome, threat | security_result.summary | אם חולץ num_files, המדיניות מוגדרת כ-"%{total_files} infected files found.", אחרת היא מוגדרת כ-"File scanned. (%{_outcome})" if _outcome extracted, else "Threat %{threat} signature found." if threat not empty |
| קטגוריה | security_result.category | הערך מועתק ישירות (מוגדר כ-"SOFTWARE_MALICIOUS" אם האיום לא ריק) |
| פעולה | security_result.action | הערך הועתק ישירות (מוגדר כ-"BLOCK" אם האיום לא ריק, אחרת מוגדר כ-"ALLOW" אם חולץ _outcome) |
| parsed_msg.insertId | metadata.product_log_id | הערך הועתק ישירות |
| parsed_msg.logName | metadata.description | הערך הועתק ישירות |
| metadata.event_type | צריך להגדיר את הערך "SCAN_FILE" אם נמצא איום או אם הקובץ נסרק, או את הערך "STATUS_UPDATE" אם חולץ מספר הקבצים הנגועים | |
| metadata.product_name | צריך להגדיר את הערך "CLAMAV" | |
| metadata.vendor_name | מגדירים את האפשרות "Cisco Systems" |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.