איסוף נתוני CMDB של ServiceNow

נתמך ב:

במאמר הזה מוסבר איך לאסוף נתוני ServiceNow CMDB על ידי הגדרת פיד של Google Security Operations באמצעות ממשק ה-API של צד שלישי.

לפני שמתחילים

ודאו שאתם עומדים בדרישות המוקדמות הבאות:

  • מכונה של Google SecOps
  • גישה עם הרשאות לאינסטנס של ServiceNow עם גישה למסוף Admin
  • חשבון משתמש ב-ServiceNow עם התפקיד cmdb_read (דרישת המינימום להרשאת קריאה)
  • ‫API בארכיטקטורת REST מופעל במכונה של ServiceNow (מופעל כברירת מחדל)

הגדרת רשימת היתרים של כתובות IP

לפני שיוצרים את הפיד, צריך להוסיף לרשימת ההיתרים את טווחי כתובות ה-IP של Google SecOps בהגדרות של חומת האש או הגדרות הרשת ב-ServiceNow.

איך מקבלים את טווחי כתובות ה-IP של Google SecOps

הוספת טווחי IP ל-ServiceNow

  1. נכנסים למופע של ServiceNow כאדמינים.
  2. עוברים אל All > System Security > IP Address Access Control.
  3. לוחצים על חדש.
  4. מזינים את פרטי ההגדרה הבאים:
    • סוג: בוחרים באפשרות אישור.
    • ‫IP Address: מזינים טווח אחד של כתובות IP של Google SecOps בסימון CIDR (לדוגמה, 192.0.2.0/24).
    • שם: מזינים שם תיאורי (לדוגמה, GGoogle SecOps IP Range 1).
    • פעיל: מסמנים את התיבה כדי להפעיל את הכלל.
  5. לוחצים על שליחה.
  6. חוזרים על שלבים 3 עד 5 לכל טווח כתובות IP נוסף של Google SecOps.

הגדרת הגישה ל-API של ServiceNow

כדי לאפשר ל-Google SecOps לשלוף נתוני CMDB, צריך ליצור משתמש ServiceNow עם הרשאות מתאימות.

  1. נכנסים למסוף Admin של ServiceNow.
  2. עוברים אל All > User Administration > Users.
  3. לוחצים על חדש.
  4. מזינים את פרטי ההגדרה הבאים:
    • מזהה משתמש: מזינים שם משתמש תיאורי (לדוגמה, google_secops_integration).
    • שם פרטי: מזינים Google.
    • שם משפחה: מזינים SecOps Integration.
    • אימייל: מזינים כתובת אימייל תקינה לקבלת התראות.
    • סיסמה: לוחצים על הגדרת סיסמה ויוצרים סיסמה חזקה.
    • פעיל: מסמנים את התיבה.
    • גישה לשירות אינטרנט בלבד: מסמנים את התיבה (מומלץ לגישה ל-API בלבד).
  5. לוחצים על שליחה.

הקצאת ההרשאות הנדרשות

  1. אחרי שיוצרים את המשתמש, פותחים את רשומת המשתמש.
  2. עוברים לקטע תפקידים.
  3. לוחצים על Edit.
  4. ברשימה Collection, מחפשים ומוסיפים את התפקיד הבא:
    • ‫cmdb_read: מספקת גישת קריאה לטבלאות CMDB.
  5. לוחצים על Save.

תיעוד פרטי הכניסה של ה-API

אחרי שיוצרים את המשתמש, מתעדים את פרטי הכניסה הבאים:

  • שם משתמש: מזהה המשתמש שיצרתם (לדוגמה, google_secops_integration)
  • סיסמה: הסיסמה שהגדרתם למשתמש
  • שם המארח של ה-API: שם הדומיין המלא (FQDN) של המכונה של ServiceNow (לדוגמה, myinstance.servicenow.com)
    • אל תכללו את https:// או נתיבים כלשהם.
    • אל תכללו לוכסן בסוף.
  • ‫Table Name: טבלת ה-CMDB שרוצים לשלוח אליה שאילתה (לדוגמה, cmdb_ci,‏ cmdb_ci_server,‏ cmdb_ci_computer)

הסבר על טבלאות ServiceNow CMDB

‫ServiceNow CMDB מאורגן במבנה היררכי של טבלאות. הטבלאות הנפוצות ביותר להטמעת נתוני נכסים כוללות:

שם טבלה תיאור תרחיש לדוגמה
cmdb_ci טבלת Base Configuration Item (ההורה של כל טבלאות ה-CI) כל פריטי ההגדרה
cmdb_ci_server פריטים להגדרת השרת שרתים פיזיים ושרתים וירטואליים
cmdb_ci_computer פריטי הגדרה של המחשב תחנות עבודה, מחשבים ניידים, מחשבים שולחניים
cmdb_ci_linux_server פריטי הגדרה של שרת Linux שרתי Linux ספציפיים
cmdb_ci_win_server פריטי הגדרה של שרת Windows שרתי Windows באופן ספציפי
cmdb_ci_vm_instance מכונות וירטואליות מכונות וירטואליות
cmdb_ci_network_adapter מתאמי רשת כרטיסי רשת
cmdb_ci_ip_address כתובות IP רשומות של כתובות IP
cmdb_ci_service שירותים עסקיים פריטים בקטלוג השירותים
cmdb_ci_appl אפליקציות פריטים של הגדרות אישיות של אפליקציה

אימות הגישה ל-API בארכיטקטורת REST

לפני שיוצרים את הפיד, צריך לוודא שפרטי הכניסה ל-API של ServiceNow פועלים כמו שצריך.

בדיקה באמצעות REST API Explorer (אופציונלי)

  1. נכנסים למופע של ServiceNow בתור המשתמש של השילוב.
  2. עוברים אל All > System Web Services > REST > REST API Explorer.
  3. בתפריט הנפתח של מרחב השמות, בוחרים באפשרות Table API.
  4. בוחרים באפשרות אחזור רשומות מטבלה (GET).
  5. בקטע פרמטרים של הנתיב, מזינים את שם הטבלה (לדוגמה, cmdb_ci).
  6. לוחצים על שליחה.
  7. מוודאים שסטטוס התגובה הוא ‎200 OK ושהרשומות מוחזרות.

בדיקה באמצעות curl (אופציונלי)

  • לחלופין, אפשר לבדוק את ה-API באמצעות curl:

    curl "https://your-instance.service-now.com/api/now/table/cmdb_ci?sysparm_limit=10" \
    --request GET \
    --header "Accept: application/json" \
    --user 'your-username':'your-password'
    
    • מחליפים את:
      • ‫your-instance.service-now.com: שם המארח של המכונה ב-ServiceNow
      • ‫your-username: שם המשתמש שלכם בשילוב
      • ‫your-password: הסיסמה של משתמש האינטגרציה

תגובה מוצלחת תחזיר נתוני JSON עם פריטי הגדרה.

הגדרת פידים

כדי להגדיר פיד:

  1. עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
  2. לוחצים על הוספת פיד חדש.
  3. בדף הבא, לוחצים על הגדרת פיד יחיד.
  4. בשדה שם הפיד, מזינים שם לפיד (לדוגמה, ServiceNow CMDB - All CIs או ServiceNow CMDB - Servers).
  5. בוחרים באפשרות API של צד שלישי בתור סוג המקור.
  6. בוחרים באפשרות ServiceNow CMDB בתור Log type.
  7. לוחצים על הבא.
  8. מציינים ערכים לפרמטרים הבאים של הקלט:

    • שם משתמש: מזינים את מזהה המשתמש ב-ServiceNow (לדוגמה, google_secops_integration).
    • סוד: מזינים את סיסמת המשתמש ב-ServiceNow. חשוב: זהו שדה רגיש. הסיסמה מוצפנת ואי אפשר לראות אותה אחרי השמירה.
    • שם המארח של ה-API: מזינים את שם הדומיין שמוגדר במלואו של המכונה של ServiceNow.
      • לדוגמה: myinstance.servicenow.com
      • מה לא לכלול:
        • פרוטוקול (https://)
        • נתיבים (/api/now/table/)
        • לוכסן בסוף הכתובת
    • מופעים אזוריים: אם המופע של ServiceNow נמצא באזור ספציפי, צריך להשתמש בפורמט הנכון של שם המארח:
      • רגיל: instance.service-now.com
      • האיחוד האירופי: instance.service-now.eu
      • אזורים אחרים: צריך לבדוק עם האדמין ב-ServiceNow
    • ‫Table Name: מזינים את טבלת ServiceNow CMDB שרוצים לשלוח אליה שאילתה.
      • דוגמאות:
        • cmdb_ci (כל פריטי ההגדרות)
        • cmdb_ci_server (כל השרתים)
        • cmdb_ci_computer (תחנות עבודה ומחשבים)
        • cmdb_ci_linux_server (שרתי Linux בלבד)
        • cmdb_ci_win_server (שרתי Windows בלבד) הערה: שם הטבלה תלוי אותיות רישיות וחייב להיות זהה. אפשר לשלוח שאילתה רק לטבלה אחת בכל פיד. כדי להטמיע כמה טבלאות, צריך ליצור פידים נפרדים לכל טבלה.
    • מרחב השמות של הנכס: מרחב השמות של הנכס.
    • תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.
  9. לוחצים על הבא.

  10. בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.

אחרי ההגדרה, הפיד מתחיל לאחזר רשומות CMDB מהמופע של ServiceNow. הסנכרון הראשוני עשוי להימשך כמה דקות, בהתאם למספר הרשומות בטבלה.

הטמעת כמה טבלאות CMDB

כדי להטמיע נתונים מכמה טבלאות CMDB, צריך ליצור פידים נפרדים לכל טבלה:

  1. יוצרים את הפיד הראשון לפי השלבים שלמעלה (לדוגמה, עבור cmdb_ci_server).
  2. כדי ליצור פידים נוספים, לוחצים על הוספת פיד חדש.
  3. משתמשים באותם פרטי כניסה ל-ServiceNow אבל מציינים שמות שונים של טבלאות.

הגדרה לדוגמה:

שם הפיד שם טבלה מטרה
‫ServiceNow CMDB – שרתים cmdb_ci_server כל פריטי התצורה של השרת
‫ServiceNow CMDB – מחשבים cmdb_ci_computer פריטי תצורה של תחנות עבודה
‫ServiceNow CMDB – מתאמי רשת cmdb_ci_network_adapter פריטי תצורה של ממשק רשת
‫ServiceNow CMDB – אפליקציות cmdb_ci_appl פריטי תצורה של אפליקציות

הרשאות ה-API הנדרשות

למשתמש האינטגרציה נדרשות ההרשאות הבאות ב-ServiceNow:

הרשאה/תפקיד רמת גישה מטרה
cmdb_read קריאה אחזור נתונים של פריטי הגדרה ב-CMDB

תפקידים נוספים (אופציונלי):

  • itil: נדרש אם אתם צריכים גישת כתיבה כדי ליצור או לעדכן פריטי תצורה (לא נדרש להטמעה ב-Google SecOps)
  • ‫rest_api_explorer: כלי שימושי לבדיקת הגישה ל-API במהלך ההגדרה

טבלת מיפוי UDM

שדה ServiceNow מיפוי UDM Logic (פונקציה לוגית)
name entity.asset.hostname שם המארח הראשי של הנכס
ip_address entity.asset.ip כתובת ה-IP הראשית של הנכס
mac_address entity.asset.mac כתובת ה-MAC של הנכס
serial_number entity.asset.hardware.serial_number המספר הסידורי של החומרה
asset_tag entity.asset.asset_id תג או מזהה של הנכס
sys_class_name entity.asset.asset_type סוג פריט התצורה (שרת, מחשב וכו')
os entity.asset.platform_software.platform מערכת הפעלה
sys_created_on entity.asset.first_seen_time חותמת הזמן של יצירת הנכס
sys_updated_on entity.asset.last_seen_time חותמת הזמן של העדכון האחרון
location entity.asset.location.name מיקום פיזי
company entity.asset.attribute.labels.value החברה או הארגון שבבעלותם נמצאת הישות
event.idm.entity.entity.metadata.entity_type USER מופה מיומן השינויים
calendar_integration", "u_ldap_source", "u_show_popup", "source", "building", "web_service_access_only", "notification", "enable_multifactor_authn", "sso_source", "sys_domain.display_value", "sys_domain.link", "u_itil_license_type", and "u_assets_validated entity.entity.asset.attribute.labels מופה מיומן השינויים
last_login_time entity.relation.entity.user.last_login_time מופה מיומן השינויים
x_bmgr_support_ent_bomgar_username", "vip", "zip", "time_format", "active", "gender", "failed_attempts", "federated_id", "internal_integration_user", "u_business_line", "department.link", "introduction", "preferred_language", "manager.link", "photo", "avatar", "time_zone", "schedule", and "correlation_id entity.relation.entity.user.attribute.labels מופה מיומן השינויים
street entity.relation.entity.user.personal_address.name מופה מיומן השינויים
department.display_value entity.relation.entity.user.department מופה מיומן השינויים
u_office entity.relation.entity.user.company_name מופה מיומן השינויים
title entity.relation.entity.user.title מופה מיומן השינויים
first_name entity.relation.entity.user.first_name מופה מיומן השינויים
last_name entity.relation.entity.user.last_name מופה מיומן השינויים
middle_name entity.relation.entity.user.middle_name מופה מיומן השינויים
manager.display_value entity.relation.entity.user.managers.user_display_name מופה מיומן השינויים
sys_domain_path", "transaction_log", "cost_center", "sys_mod_count", and "sys_tags entity.entity.labels מופה מיומן השינויים
employee_number", "phone", "home_phone", and "mobile_phone entity.relation.entity.user.phone_numbers מופה מיומן השינויים
city entity.relation.entity.user.personal_address.city מופה מיומן השינויים
state entity.relation.entity.user.personal_address.state מופה מיומן השינויים
country entity.location.country_or_region מופה מיומן השינויים
u_site_code entity.location.city מופה מיומן השינויים
u_region entity_labels מופה מיומן השינויים
location.display_value entity.labels מופה מיומן השינויים
location.link entity.labels מופה מיומן השינויים
email _relation.entity.user.email_addresses מופה מיומן השינויים
sys_id entity.asset.product_object_id מופה מיומן השינויים
u_sima_bs_activation_date", "attestation_status", "u_oracle_asm_lun_size", "u_app_resource_jndi_name", "is_encrypted", "monitor", "operational_status", "u_updated_ci", "u_cluster_node", "firewall_status", "skip_sync", "u_excluded", "u_data_classification", "u_sla_report", "u_restriction", "u_rack_slot", "u_account_aztech_oe.link", "u_account_aztech_oedisplay_value", "u_organisational_entity.link", "u_organisational_entity.display_value", "assignment_group.link", "assignment_group.display_value", "cost_center.link", "cost_center.display_value", "u_service_instance", "u_local_oe_cost_center", "managed_by", "u_mode_of_operation", "install_status", and "u_provider_tag entity.labels מופה מיומן השינויים
u_build_user entity.user.email_addresses מופה מיומן השינויים
metadata.entity_type ASSET מופה מיומן השינויים

יומן שינויים

הצגת יומן השינויים של המנתח הזה

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.