איסוף נתוני 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 מקובץ ה-JSON של טווחי כתובות ה-IP של Google.
הוספת טווחי IP ל-ServiceNow
- נכנסים למופע של ServiceNow כאדמינים.
- עוברים אל All > System Security > IP Address Access Control.
- לוחצים על חדש.
- מזינים את פרטי ההגדרה הבאים:
- סוג: בוחרים באפשרות אישור.
- IP Address: מזינים טווח אחד של כתובות IP של Google SecOps בסימון CIDR (לדוגמה,
192.0.2.0/24). - שם: מזינים שם תיאורי (לדוגמה,
GGoogle SecOps IP Range 1). - פעיל: מסמנים את התיבה כדי להפעיל את הכלל.
- לוחצים על שליחה.
- חוזרים על שלבים 3 עד 5 לכל טווח כתובות IP נוסף של Google SecOps.
הגדרת הגישה ל-API של ServiceNow
כדי לאפשר ל-Google SecOps לשלוף נתוני CMDB, צריך ליצור משתמש ServiceNow עם הרשאות מתאימות.
יצירת משתמש ייעודי לשילוב (מומלץ)
- נכנסים למסוף Admin של ServiceNow.
- עוברים אל All > User Administration > Users.
- לוחצים על חדש.
- מזינים את פרטי ההגדרה הבאים:
- מזהה משתמש: מזינים שם משתמש תיאורי (לדוגמה,
google_secops_integration). - שם פרטי: מזינים
Google. - שם משפחה: מזינים
SecOps Integration. - אימייל: מזינים כתובת אימייל תקינה לקבלת התראות.
- סיסמה: לוחצים על הגדרת סיסמה ויוצרים סיסמה חזקה.
- פעיל: מסמנים את התיבה.
- גישה לשירות אינטרנט בלבד: מסמנים את התיבה (מומלץ לגישה ל-API בלבד).
- מזהה משתמש: מזינים שם משתמש תיאורי (לדוגמה,
- לוחצים על שליחה.
הקצאת ההרשאות הנדרשות
- אחרי שיוצרים את המשתמש, פותחים את רשומת המשתמש.
- עוברים לקטע תפקידים.
- לוחצים על Edit.
- ברשימה Collection, מחפשים ומוסיפים את התפקיד הבא:
- cmdb_read: מספקת גישת קריאה לטבלאות CMDB.
- לוחצים על 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 (אופציונלי)
- נכנסים למופע של ServiceNow בתור המשתמש של השילוב.
- עוברים אל All > System Web Services > REST > REST API Explorer.
- בתפריט הנפתח של מרחב השמות, בוחרים באפשרות Table API.
- בוחרים באפשרות אחזור רשומות מטבלה (GET).
- בקטע פרמטרים של הנתיב, מזינים את שם הטבלה (לדוגמה,
cmdb_ci). - לוחצים על שליחה.
- מוודאים שסטטוס התגובה הוא 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 עם פריטי הגדרה.
הגדרת פידים
כדי להגדיר פיד:
- עוברים אל הגדרות > ניהול נתונים > פידים. אם אתם משתמשים בפלטפורמה של SIEM בלבד, עוברים אל הגדרות > פידים.
- לוחצים על הוספת פיד חדש.
- בדף הבא, לוחצים על הגדרת פיד יחיד.
- בשדה שם הפיד, מזינים שם לפיד (לדוגמה,
ServiceNow CMDB - All CIsאוServiceNow CMDB - Servers). - בוחרים באפשרות API של צד שלישי בתור סוג המקור.
- בוחרים באפשרות ServiceNow CMDB בתור Log type.
- לוחצים על הבא.
מציינים ערכים לפרמטרים הבאים של הקלט:
- שם משתמש: מזינים את מזהה המשתמש ב-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 בלבד) הערה: שם הטבלה תלוי אותיות רישיות וחייב להיות זהה. אפשר לשלוח שאילתה רק לטבלה אחת בכל פיד. כדי להטמיע כמה טבלאות, צריך ליצור פידים נפרדים לכל טבלה.
- דוגמאות:
- מרחב השמות של הנכס: מרחב השמות של הנכס.
- תוויות הטמעה: התווית שתתווסף לאירועים מהפיד הזה.
- שם משתמש: מזינים את מזהה המשתמש ב-ServiceNow (לדוגמה,
לוחצים על הבא.
בודקים את הגדרות הפיד החדש במסך סיום ולוחצים על שליחה.
אחרי ההגדרה, הפיד מתחיל לאחזר רשומות CMDB מהמופע של ServiceNow. הסנכרון הראשוני עשוי להימשך כמה דקות, בהתאם למספר הרשומות בטבלה.
הטמעת כמה טבלאות CMDB
כדי להטמיע נתונים מכמה טבלאות CMDB, צריך ליצור פידים נפרדים לכל טבלה:
- יוצרים את הפיד הראשון לפי השלבים שלמעלה (לדוגמה, עבור
cmdb_ci_server). - כדי ליצור פידים נוספים, לוחצים על הוספת פיד חדש.
- משתמשים באותם פרטי כניסה ל-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.