איסוף יומנים של 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. נכנסים למסוףGoogle Cloud ובוחרים את הפרויקט ב- Google Cloud שמקושר למכונה של Google SecOps.
  2. נכנסים לדף IAM & Admin > Service Accounts.
  3. לוחצים על Create service account.
  4. מזינים את פרטי ההגדרה הבאים:
    • Service account name: מזינים שם לחשבון (לדוגמה, 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 ומעתיקים את הערך של Project number. תצטרכו אותו כדי להגדיר את הייצוא.

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

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

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

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

התקנת הסוכן של Bindplane

התקנת חלונות

  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. ניגשים לקובץ התצורה:

    1. מאתרים את הקובץ config.yaml. בדרך כלל, הוא נמצא בספרייה /opt/observiq-otel-collector/ ב-Linux או בספריית ההתקנה ב-Windows.
    2. פותחים את הקובץ באמצעות כלי לעריכת טקסט (לדוגמה, nano,‏ vi או פנקס הרשימות).
  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: '/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
    
  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) בקטע קבלת פרטי כניסה ל-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

  1. נכנסים לממשק המשתמש באינטרנט של ManageEngine ADAudit Plus.
  2. עוברים אל Admin > Configuration > SIEM Integration.
  3. כדי לשלוח את היומנים של ADAudit Plus, בוחרים באפשרות הפעלה.
  4. בוחרים בפורמט ArcSight (CEF)‎.
  5. מזינים את פרטי ההגדרה הבאים:
    • ‫IP Address: כתובת ה-IP של סוכן Bindplane.
    • ‫Port: מספר היציאה של Bindplane, לדוגמה 514 ל-UDP.
    • ‫Target Type: בוחרים באפשרות UDP (אפשר גם לבחור באפשרות TCP, בהתאם להגדרות של סוכן Bindplane).
  6. לוחצים על 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.