איסוף יומנים של ManageEngine ADAudit Plus
במאמר הזה מוסבר איך להטמיע יומנים של ManageEngine ADAudit Plus ב-Google Security Operations באמצעות סוכן Bindplane. המנתח מטפל ביומנים מ-ADAudit Plus וממיר אותם לפורמט UDM. הוא משתמש בתבניות grok כדי לחלץ שדות גם מ-SYSLOG (CEF) וגם מהודעות בפורמט של מפתח/ערך, ממפה אותם לשדות UDM על סמך סוגי אירועים שנגזרים מפרופילים של התראות ודוחות, ומעשיר את הנתונים בהקשר נוסף. המנתח מטפל גם בתרחישים ספציפיים כמו כשלים בהתחברות, שינויים של משתמשים ושינויים בקבצים, ומתאים את מיפוי ה-UDM בהתאם.
לפני שמתחילים
- מוודאים שיש לכם מכונת Google SecOps.
- חשוב לוודא שאתם משתמשים ב-Windows 2016 ואילך, או במארח Linux עם
systemd. - אם אתם משתמשים בשרת proxy, ודאו שהיציאות של חומת האש פתוחות.
- מוודאים שיש לכם הרשאות גישה מיוחדות ל-ManageEngine ADAudit.
קבלת פרטי כניסה ל-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
התקנת חלונות
- פותחים את שורת הפקודה או את PowerShell כאדמין.
מריצים את הפקודה הבאה:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
התקנה ב-Linux
- פותחים טרמינל עם הרשאות root או sudo.
מריצים את הפקודה הבאה:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
מקורות מידע נוספים בנושא התקנה
- אפשרויות התקנה נוספות מפורטות במדריך ההתקנה.
הגדרת סוכן Bindplane להטמעת Syslog ושליחה אל Google SecOps
ניגשים לקובץ התצורה:
- מאתרים את הקובץ
config.yaml. בדרך כלל, הוא נמצא בספרייה/opt/observiq-otel-collector/ב-Linux או בספריית ההתקנה ב-Windows. - פותחים את הקובץ באמצעות כלי לעריכת טקסט (לדוגמה,
nano,viאו פנקס הרשימות).
- מאתרים את הקובץ
עורכים את הקובץ
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: '/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 ingestion_labels: log_type: ADAUDIT_PLUS raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labelsמחליפים את היציאה ואת כתובת ה-IP לפי הצורך בתשתית שלכם.
מחליפים את
<LOCATION>באזור של המופע של Google SecOps (לדוגמה,us,europeאוasia-southeast1). המערכת מוסיפה את הערך הזה בתחילתchronicle.googleapis.com.מחליפים את
<PROJECT_NUMBER>במספר הפרויקט שמופיע בקטע IAM & Admin > Settings.מחליפים את
<customer_id>במספר הלקוח בפועל.מעדכנים את
/path/to/ingestion-authentication-file.jsonלנתיב שבו נשמר קובץ המפתח של חשבון השירות (אפשרות 1) בקטע קבלת פרטי כניסה ל-Google SecOps בשביל סוכן Bindplane.
מייצא API להטמעה מדור קודם
אם אתם משתמשים בקובץ האימות להטמעת נתונים מאפשרות 2, החליפו את הבלוק
exportersבקוד הבא. מגדירים אתcredsלנתיב של קובץ האימות להטמעת נתונים. אם המכונה נמצאת מחוץ לארה"ב, מחליפים את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: '/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 ingestion_labels: log_type: ADAUDIT_PLUS raw_log_field: body
מפעילים מחדש את הסוכן של Bindplane כדי להחיל את השינויים.
כדי להפעיל מחדש את הסוכן של Bindplane ב-Linux, מריצים את הפקודה הבאה:
sudo systemctl restart bindplane-agentכדי להפעיל מחדש את הסוכן של Bindplane ב-Windows, אפשר להשתמש במסוף Services או להזין את הפקודה הבאה:
net stop BindPlaneAgent && net start BindPlaneAgent
הגדרת ManageEngine ADAudit Plus Syslog
- נכנסים לממשק המשתמש באינטרנט של ManageEngine ADAudit Plus.
- עוברים אל Admin > Configuration > SIEM Integration.
- כדי לשלוח את היומנים של ADAudit Plus, בוחרים באפשרות הפעלה.
- בוחרים בפורמט ArcSight (CEF).
- מזינים את פרטי ההגדרה הבאים:
- IP Address: כתובת ה-IP של סוכן Bindplane.
- Port: מספר היציאה של Bindplane, לדוגמה
514ל-UDP. - Target Type: בוחרים באפשרות UDP (אפשר גם לבחור באפשרות TCP, בהתאם להגדרות של סוכן Bindplane).
- לוחצים על Save.
טבלת מיפוי UDM
| שדה ביומן | מיפוי UDM | Logic (פונקציה לוגית) |
|---|---|---|
ACCOUNT_DOMAIN |
principal.administrative_domain |
הערך של ACCOUNT_DOMAIN מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
ACCOUNT_NAME |
principal.user.userid |
הערך של ACCOUNT_NAME מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
ALERT_PROFILE |
security_result.summary |
הערך של ALERT_PROFILE מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
APPLICATION_NAME |
target.resource.name |
הערך של APPLICATION_NAME מהיומן הגולמי מוקצה לשדה הזה ב-UDM. בנוסף, המדיניות target.resource.resource_type מוגדרת ל-TASK והמדיניות has_target_resource מוגדרת ל-True. |
CALLER_DISPLAY_NAME |
target.user.user_display_name |
הערך של CALLER_DISPLAY_NAME מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
CALLER_USER_NAME |
target.user.userid |
הערך של CALLER_USER_NAME מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
CALLER_USER_SID |
target.group.windows_sid |
הערך של CALLER_USER_SID מהיומן הגולמי מוקצה לשדה ה-UDM הזה אחרי הסרת התווים [%,{,}]. הפעולה הזו מתבצעת רק אם הערך תואם לתבנית SID של Windows. |
Category |
metadata.product_event_type |
הערך של Category מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
CLIENT_HOST_NAME |
target.hostname, target.asset.hostname |
הערך של CLIENT_HOST_NAME מהיומן הגולמי מוקצה לשדות האלה ב-UDM. |
CLIENT_IP_ADDRESS |
target.ip, target.asset.ip |
הערך של CLIENT_IP_ADDRESS מהיומן הגולמי מוקצה לשדות ה-UDM האלה אחרי שמוודאים שהוא כתובת IP תקינה. |
CLIENT_PORT |
target.port |
הערך של CLIENT_PORT מהיומן הגולמי מוקצה לשדה הזה ב-UDM אחרי המרה למספר שלם. |
DOMAIN |
target.administrative_domain |
הערך של DOMAIN מהיומן הגולמי מוקצה לשדה הזה ב-UDM. יכול להיות שהערך הזה יוחלף בהמשך על ידי ACCOUNT_DOMAIN, אם הוא קיים. |
FILE_LOCATION |
target.file.full_path |
הערך של FILE_LOCATION מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
FILE_NAME |
target.file.full_path |
הערך של FILE_NAME מהיומן הגולמי מוקצה לשדה ה-UDM הזה אם FILE_LOCATION לא קיים. |
FORMAT_MESSAGE |
security_result.description |
הערך של FORMAT_MESSAGE מהיומן הגולמי מוקצה לשדה הזה ב-UDM. יכול להיות שחלקים מהשדה הזה ישמשו לאכלוס שדות אחרים של UDM, ואז יוסרו מהתיאור. |
IP |
principal.ip, principal.asset.ip |
הערך של IP מהיומן הגולמי מוקצה לשדות ה-UDM האלה אחרי שמוודאים שהוא כתובת IP תקינה. |
loggerHost |
intermediary.hostname, intermediary.asset.hostname |
הערך של loggerHost שחולץ משדה ההודעה של היומן הגולמי מוקצה לשדות ה-UDM האלה. |
login_name |
target.user.userid או target.user.email_addresses או target.user.user_display_name |
אם הערך מכיל @, הוא נחשב לכתובת אימייל. אם הוא מכיל רווחים, הוא נחשב לשם המוצג. אחרת, הוא נחשב כמזהה משתמש. הפעולה הזו גם מגדירה את event_type לערך USER_LOGIN, את extensions.auth.type לערך MACHINE ואת extensions.auth.mechanism לערך USERNAME_PASSWORD. |
RECORD_NUMBER |
principal.process.pid |
הערך של RECORD_NUMBER מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
REPORT_PROFILE |
metadata.description |
הערך של REPORT_PROFILE מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
SEVERITY |
security_result.severity |
הערך של SEVERITY קובע את הערך של שדה ה-UDM הזה: 1 ממפה ל-LOW, 2 ממפה ל-MEDIUM ו-3 ממפה ל-HIGH. |
SOURCE |
principal.hostname, principal.asset.hostname |
הערך של SOURCE מהיומן הגולמי, בשילוב עם DOMAIN אם SOURCE לא מכיל חלק של דומיין, מוקצה לשדות ה-UDM האלה. ההגדרה הזו גם מגדירה את has_principal_host כ-true. |
TIME_GENERATED |
metadata.event_timestamp.seconds |
הערך של TIME_GENERATED מהיומן הגולמי משמש כחותמת הזמן של האירוע. |
UNIQUE_ID |
metadata.product_log_id |
הערך של UNIQUE_ID מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
USERNAME |
principal.user.userid |
הערך של USERNAME מהיומן הגולמי מוקצה לשדה ה-UDM הזה אם ACCOUNT_NAME לא קיים. |
USER_OU_GUID |
metadata.product_log_id |
הערך של USER_OU_GUID מהיומן הגולמי, אחרי הסרת הסוגריים המסולסלים, מוקצה לשדה ה-UDM הזה אם UNIQUE_ID לא קיים. |
access_mode |
security_result.detection_fields.value |
הערך של access_mode מהיומן הגולמי מוקצה לשדה הזה ב-UDM, והמפתח מוגדר כ-ACCESS_MODE. |
action_name |
security_result.description |
הערך של action_name מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
domain_name |
principal.administrative_domain |
הערך של domain_name מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
event.idm.read_only_udm.extensions.auth.mechanism |
event.idm.read_only_udm.extensions.auth.mechanism |
צריך להגדיר את הערך USERNAME_PASSWORD אם קיים המאפיין login_name או אם הערך של המאפיין event_type הוא USER_LOGIN. |
event.idm.read_only_udm.extensions.auth.type |
event.idm.read_only_udm.extensions.auth.type |
צריך להגדיר את הערך MACHINE אם קיים המאפיין login_name או אם הערך של המאפיין event_type הוא USER_LOGIN. |
event.idm.read_only_udm.metadata.event_type |
event.idm.read_only_udm.metadata.event_type |
נקבע על ידי המנתח על סמך הערכים של ALERT_PROFILE, REPORT_PROFILE ו-FORMAT_MESSAGE. הערך יכול להיות אחד מכמה ערכים, כולל USER_CHANGE_PERMISSIONS, USER_STATS, USER_LOGIN, USER_CHANGE_PASSWORD, SETTING_MODIFICATION, FILE_DELETION, FILE_MODIFICATION, STATUS_SHUTDOWN, SCHEDULED_TASK_CREATION, FILE_READ, NETWORK_CONNECTION, GENERIC_EVENT, USER_UNCATEGORIZED או STATUS_UPDATE. |
event.idm.read_only_udm.metadata.log_type |
event.idm.read_only_udm.metadata.log_type |
תמיד מוגדר כ-ADAUDIT_PLUS. |
event.idm.read_only_udm.metadata.product_name |
event.idm.read_only_udm.metadata.product_name |
תמיד מוגדר כ-ADAudit Plus. |
event.idm.read_only_udm.metadata.vendor_name |
event.idm.read_only_udm.metadata.vendor_name |
תמיד מוגדר כ-Zoho Corporation. |
host |
principal.hostname, principal.asset.hostname |
הערך של host מהיומן הגולמי מוקצה לשדות האלה ב-UDM. ההגדרה הזו גם מגדירה את has_principal_host כ-true. |
intermediary.hostname, intermediary.asset.hostname |
intermediary.hostname, intermediary.asset.hostname |
צריך להגדיר את הערך loggerHost. |
principalHost |
principal.hostname, principal.asset.hostname |
הערך של principalHost מהיומן הגולמי מוקצה לשדות ה-UDM האלה אחרי שבודקים אם מדובר בכתובת IP. ההגדרה הזו גם מגדירה את has_principal_host כ-true. |
security_result.action |
security_result.action |
הגדרה לערך ALLOW אם outcome או msg_data_2 מכילים את Success, או אם FORMAT_MESSAGE מכיל את Status:Success. מגדירים את הערך BLOCK אם status מכיל את הערכים denied, locked out, incorrect, does not meet או Unable to validate. צריך להגדיר את הערך BLOCK אם הערך של ALERT_PROFILE הוא Logon Failures for Admin Users. |
security_result.category |
security_result.category |
צריך להגדיר את הערך POLICY_VIOLATION אם הערך של event_type הוא USER_STATS או אם הערך של ALERT_PROFILE הוא Logon Failures for Admin Users. |
security_result.rule_name |
security_result.rule_name |
חולץ מהשדה FORMAT_MESSAGE אם הוא מכיל את Reason:. |
status |
security_result.summary |
הערך של status מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
targetHost |
target.hostname, target.asset.hostname או target.ip, target.asset.ip |
הערך של targetHost מהיומן הגולמי מוקצה לשדות ה-UDM האלה אחרי שבודקים אם מדובר בכתובת IP. |
targetUser |
target.user.userid |
הערך של targetUser מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
_CNtargetUser |
target.user.user_display_name |
הערך של _CNtargetUser מהיומן הגולמי מוקצה לשדה הזה ב-UDM. |
_user |
principal.user.userid או target.user.userid |
הערך של _user מהיומן הגולמי מוקצה ל-principal.user.userid, אלא אם event_type הוא USER_CHANGE_PASSWORD, ובמקרה כזה הוא מוקצה ל-target.user.userid. |
יומן שינויים
הצגת יומן השינויים של המנתח הזה
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.