איסוף יומני LDAP של CA
גרסת המנתח: 2.0
במסמך הזה מוסבר איך להטמיע יומני CA LDAP ב-Google Security Operations באמצעות סוכן Bindplane.
CA Directory (לשעבר Symantec Directory) הוא שרת גילוי שתואם ל-LDAP v2/v3 ומבוסס על תקני X.500. הוא מספק שירותי ספריות ברמה ארגונית עם יכולות רישום מקיפות ביומן, כולל יומני התראות, מעקב, אזהרות, שאילתות, סיכומים, חיבורים, אבחון, עדכונים ונתונים סטטיסטיים למעקב אחרי פעולות בספריות ואירועי אבטחה.
לפני שמתחילים
חשוב לוודא שיש לכם את הדברים הבאים:
- מכונה של Google SecOps
- Windows Server 2016 ואילך, או מארח Linux עם
systemd - קישוריות הרשת בין סוכן Bindplane לבין שרת CA Directory
- אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות בהתאם לדרישות של סוכן Bindplane.
- גישה עם הרשאות לשרת CA Directory (שורש או אדמין)
- התקנה והגדרה של CA Directory עם רישום ביומן מופעל
קבלת פרטי כניסה ל-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השירות אמור להופיע כפעיל (פועל).
מקורות מידע נוספים בנושא התקנה
במדריך להתקנת הסוכן של 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/ca_directory: 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: CA_LDAP raw_log_field: body ingestion_labels: env: production source: ca_directory service: pipelines: logs/ca_directory_to_chronicle: receivers: - udplog exporters: - chronicle/ca_directoryמחליפים את ה-placeholders הבאים:
הגדרת המקלט:
listen_address: צריך להגדיר את הערך0.0.0.0:514כדי להאזין בכל הממשקים ביציאת UDP 514- בהתקנות של Linux ללא הרשאות בסיס, צריך להשתמש ביציאה
1514ומעלה - מוודאים שהיציאה תואמת ליציאה שהוגדרה בהעברה של rsyslog.
- בהתקנות של Linux ללא הרשאות בסיס, צריך להשתמש ביציאה
הגדרת הייצוא:
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ב-customer ID. פרטים נוספים זמינים במאמר קבלת מזהה לקוח ב-Google SecOps.
location: מחליפים את<LOCATION>באזור של המכונה של Google SecOps (לדוגמה,us,europeאוasia-southeast1). המייצא מוסיף את הערך הזה בתחילתchronicle.googleapis.com. לרשימה המלאה, ראו נקודות קצה אזוריות.
project: מחליפים את<PROJECT_NUMBER>במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.
endpoint: משאירים את הערךchronicle.googleapis.com.
log_type: צריך להגדיר את הערךCA_LDAP(תווית הטמעה של Chronicle ל-CA Directory)
ingestion_labels: תוויות אופציונליות לסינון ולארגון
מייצא API להטמעה מדור קודם
אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק
exportersבקוד הבא. מגדירים אתcreds_file_pathלנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים אתmalachiteingestion-pa.googleapis.comבנקודת הקצה האזורית (לדוגמה,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/ca_directory: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: 'YOUR_CUSTOMER_ID' endpoint: malachiteingestion-pa.googleapis.com log_type: CA_LDAP raw_log_field: body ingestion_labels: env: production source: ca_directory
שמירת קובץ התצורה
אחרי העריכה, שומרים את הקובץ:
- 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 של CA LDAP באמצעות rsyslog
בקטע הזה מוסבר איך להגדיר את rsyslog בשרת CA Directory כדי להעביר יומנים לסוכן Bindplane.
זיהוי המיקומים של קובצי היומן של CA Directory
קובצי היומן של CA Directory מאוחסנים במיקומים הבאים:
- Linux:
/opt/CA/Directory/dxserver/logs/ - Windows:
C:\Program Files\CA\Directory\dxserver\logs\
שמות קובצי היומן מבוססים על השם של ה-DSA (לדוגמה, democorp_alarm, democorp_warn, democorp_trace).
סוגי היומנים הזמינים
ב-CA Directory נוצרים סוגי היומנים הבאים:
- יומן התראות: אירועים קריטיים (תמיד מופעל)
- Warn log: שגיאות ואזהרות
- יומן מעקב: מעקב מפורט אחרי פעולות
- יומן שאילתות: מידע מפורט על הפעולות עם חותמות זמן
- יומן סיכום: סיכומי פעולות
- יומן חיבורים: אירועי חיבור וניתוק
- יומן אבחון: פעולות שנדחו
- יומן נתונים סטטיסטיים: נתונים סטטיסטיים תפעוליים לפי דקה
- יומן עדכונים: פעולות הוספה, שינוי, שינוי שם ומחיקה
- יומן זמנים: מידע על תזמון הפעולה
הגדרת rsyslog ב-Linux
נכנסים לשרת CA Directory כמשתמש root או עם הרשאות sudo.
אם rsyslog לא מותקן, מתקינים אותו:
sudo yum install rsyslogאו ב-Debian או ב-Ubuntu:
sudo apt-get install rsyslogיוצרים קובץ תצורה חדש של rsyslog ל-CA Directory:
sudo nano /etc/rsyslog.d/ca-directory.confכדי להעביר את היומנים של CA Directory, מוסיפים את ההגדרות הבאות:
# Load the imfile module for file monitoring module(load="imfile" PollingInterval="10") # Monitor CA Directory alarm logs input(type="imfile" File="/opt/CA/Directory/dxserver/logs/*_alarm*" Tag="ca-directory-alarm" Severity="error" Facility="local0") # Monitor CA Directory warn logs input(type="imfile" File="/opt/CA/Directory/dxserver/logs/*_warn*" Tag="ca-directory-warn" Severity="warning" Facility="local0") # Monitor CA Directory trace logs input(type="imfile" File="/opt/CA/Directory/dxserver/logs/*_trace*" Tag="ca-directory-trace" Severity="info" Facility="local0") # Monitor CA Directory query logs input(type="imfile" File="/opt/CA/Directory/dxserver/logs/*_query*" Tag="ca-directory-query" Severity="info" Facility="local0") # Monitor CA Directory connection logs input(type="imfile" File="/opt/CA/Directory/dxserver/logs/*_connection*" Tag="ca-directory-connection" Severity="info" Facility="local0") # Monitor CA Directory update logs input(type="imfile" File="/opt/CA/Directory/dxserver/logs/*_update*" Tag="ca-directory-update" Severity="info" Facility="local0") # Forward all CA Directory logs to Bindplane agent if $syslogtag contains 'ca-directory' then @@BINDPLANE_AGENT_IP:514 & stopמחליפים את
BINDPLANE_AGENT_IPבכתובת ה-IP של המארח של סוכן Bindplane:- אם הסוכן של Bindplane נמצא באותו שרת:
127.0.0.1 - אם הסוכן של Bindplane נמצא בשרת אחר: מזינים את כתובת ה-IP (לדוגמה,
192.168.1.100)
- אם הסוכן של Bindplane נמצא באותו שרת:
שומרים את קובץ התצורה:
לוחצים על
Ctrl+O, אחר כך עלEnterואז עלCtrl+Xמאמתים את תחביר ההגדרות של rsyslog:
sudo rsyslogd -N1מפעילים מחדש את שירות rsyslog:
sudo systemctl restart rsyslogמוודאים ש-rsyslog פועל:
sudo systemctl status rsyslogבודקים אם יש שגיאות ביומני rsyslog:
sudo tail -f /var/log/messages
הגדרת rsyslog ב-Windows
מורידים ומתקינים את rsyslog ל-Windows מאתר rsyslog.
פותחים את קובץ התצורה של rsyslog:
notepad "C:\Program Files\rsyslog\rsyslog.conf"מוסיפים את ההגדרות הבאות:
# Load the imfile module for file monitoring module(load="imfile" PollingInterval="10") # Monitor CA Directory alarm logs input(type="imfile" File="C:\\Program Files\\CA\\Directory\\dxserver\\logs\\*_alarm*" Tag="ca-directory-alarm" Severity="error" Facility="local0") # Monitor CA Directory warn logs input(type="imfile" File="C:\\Program Files\\CA\\Directory\\dxserver\\logs\\*_warn*" Tag="ca-directory-warn" Severity="warning" Facility="local0") # Monitor CA Directory trace logs input(type="imfile" File="C:\\Program Files\\CA\\Directory\\dxserver\\logs\\*_trace*" Tag="ca-directory-trace" Severity="info" Facility="local0") # Forward all CA Directory logs to Bindplane agent if $syslogtag contains 'ca-directory' then @@BINDPLANE_AGENT_IP:514 & stopמחליפים את
BINDPLANE_AGENT_IPבכתובת ה-IP של המארח של סוכן Bindplane.שומרים את קובץ התצורה.
מפעילים מחדש את שירות rsyslog:
net stop rsyslog net start rsyslog
הפעלת הרישום ביומן של CA Directory
מוודאים שסוגי היומנים הנדרשים מופעלים ב-CA Directory:
עורכים את קובץ התצורה של DSA:
- Linux:
/opt/CA/Directory/dxserver/config/servers/democorp.dxc - Windows:
C:\Program Files\CA\Directory\dxserver\config\servers\democorp.dxc
- Linux:
בודקים או מוסיפים את הגדרות הרישום ביומן הבאות:
set alarm-log = true; set warn-log = true; set trace-log = true; set query-log = true; set connection-log = true; set update-log = true;שומרים את קובץ התצורה.
מפעילים מחדש את ה-DSA של CA Directory:
Linux:
dxserver stop democorp dxserver start democorpWindows:
net stop "CA Directory DSA - democorp" net start "CA Directory DSA - democorp"
אימות העברת היומנים
יוצרים פעילות בדיקה ב-CA Directory על ידי ביצוע שאילתות LDAP או ניסיונות אימות.
בודקים את יומני הסוכן של Bindplane כדי לוודא שהיומנים מתקבלים:
Linux:
sudo journalctl -u observiq-otel-collector -fWindows:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
נכנסים למסוף Google SecOps ומוודאים שהיומנים של CA Directory מופיעים בכלי לצפייה ביומנים.
למידע נוסף על רישום ביומן של CA Directory, אפשר לעיין במסמכי התיעוד של Broadcom CA Directory.
דוגמאות מפורטות להגדרת rsyslog זמינות במאמר של Broadcom Knowledge Base בנושא רישום מרכזי ביומן.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
| agent.ephemeral_id, logstash.irm_region, logstash.irm_environment, logstash.irm_site, host.os.name | additional.fields | מוזגו כתוויות עם המפתחות "ephemeral_id", "irm_region", "irm_environment", "irm_site", "os_name" בהתאמה |
| host.architecture | hardware.cpu_platform | הערך הועתק ישירות |
| logstash.process.host | intermediary.hostname | הערך הועתק ישירות |
| logstash.collect.timestamp | metadata.collected_timestamp | מנותח כחותמת זמן באמצעות מסנן תאריכים |
| msg | metadata.description | הערך הועתק ישירות |
| metadata.event_type | צריך להגדיר את הערך STATUS_UPDATE | |
| agent.type, agent.version | observer.application | משורשר כ-"%{agent.type} %{agent.version}" אם שניהם לא ריקים, אחרת "%{agent.type}" |
| agent.type, agent.id | observer.asset_id | משורשר כ-"%{agent.type}: %{agent.id}" |
| agent.hostname | observer.hostname | הערך הועתק ישירות |
| host.id | principal.asset.asset_id | משורשר כ-"CA_LDAP:%{host.id}" |
| חומרה | principal.asset.hardware | מוזג מאובייקט חומרה |
| host.hostname | principal.hostname | הערך הועתק ישירות |
| host.ip | principal.ip | מוזג ממערך host.ip |
| host.mac | principal.mac | מוזג ממערך host.mac |
| host.os.family | principal.platform | אם יש התאמה ל-"(rhel|redhat)", מגדירים את הערך "LINUX" |
| host.os.kernel | principal.platform_patch_level | הערך הועתק ישירות |
| host.os.version | principal.platform_version | הערך הועתק ישירות |
| log.file.path | principal.process.file.full_path | הערך הועתק ישירות |
| syslog_severity | security_result.severity | ההגדרה תהיה INFORMATIONAL אם יש התאמה ל-(?i)(DEFAULT|DEBUG|INFO|NOTICE), ERROR אם יש התאמה ל-(?i)ERROR, MEDIUM אם יש התאמה ל-(?i)WARNING, HIGH אם יש התאמה ל-(?i)(CRITICAL|ALERT|EMERGENCY) |
| syslog_severity | security_result.severity_details | הערך הועתק ישירות |
| metadata.product_name | מגדירים את הערך "CA_LDAP" | |
| metadata.vendor_name | מגדירים את הערך "CA_LDAP" |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.