שילוב של ServiceNow עם Google SecOps
במאמר הזה מוסבר איך לשלב את ServiceNow עם Google Security Operations (Google SecOps).
תרחישים לדוגמה
השילוב עם ServiceNow משתמש ביכולות של Google SecOps כדי לתמוך בתרחישים הבאים:
דיווח אוטומטי על אירועים: יצירה אוטומטית של אירועים ב-ServiceNow מהתראות אבטחה שמקורן ב-SIEM או בכלים אחרים לאבטחה.
העשרת אירועים ותגובה לאירועים: ייעול תהליכי העבודה של התגובה לאירועים על ידי צמצום הדיווח הידני והעשרת האירועים במידע רלוונטי מההתראה המקורית.
תיקון פישינג: הפיכת שלבים חוזרים של חקירת פישינג לאוטומטיים, כמו איסוף כותרות האימייל, חקירת קבצים מצורפים וחיפוש אימיילים דומים, כדי לקצר את זמני התגובה.
תזמור תיקון נקודות חולשה: תזמור תהליכי עבודה לתיקון נקודות חולשה על ידי יצירה אוטומטית של בקשות לשינוי ב-ServiceNow, כדי לתקן או לצמצם את הפעולות על סמך תוצאות הסריקה של נקודות החולשה.
אוטומציה של מחזור החיים של המשתמשים: אוטומציה של משימות הקצאה וביטול הקצאה של משתמשים במערכות שונות (בקרת גישה, פלטפורמות אימייל, אפליקציות) על סמך טריגרים מתהליכי עבודה ב-ServiceNow.
הקשר של מודיעין איומי סייבר: העשרת התראות האבטחה בנתוני מודיעין איומי סייבר שמגיעים ישירות מפלטפורמת ServiceNow, כדי לספק למנתחים יותר הקשר לצורך תעדוף פעולות התגובה.
לפני שמתחילים
לפני שמגדירים את השילוב בפלטפורמת Google SecOps, צריך לוודא שביצעתם את הפעולות הבאות:
- חשבון משתמש ב-ServiceNow: חשבון משתמש ייעודי עם הרשאות מספיקות כדי לשלוח שאילתות, ליצור ולעדכן רשומות יעד.
- תפקידים ב-ServiceNow: ודאו שלחשבון יש את תפקידי המערכת הנדרשים (
sn_incident_writeו-itil) והגדרת גישה מותאמת אישית למשתמשים כדי לאפשר גישה לקריאת הערות ביומן. - קישוריות לרשת: הגדרת רשת שמאפשרת לתנועה מכתובות ה-IP של Google SecOps או מתשתית הנציג המרוחק להגיע לנקודת הקצה של המכונה של ServiceNow.
- פרטי אימות: קובעים את מדיניות האימות של הארגון. אפשר לבצע אימות באמצעות אימות בסיסי רגיל או אימות OAuth 2.0.
הגדרת גישת משתמשים ב-ServiceNow
כדי לאפשר לשילוב לסנכרן תגובות, לעדכן שדות ולבצע פעולות בצורה חלקה, צריך לבצע את המשימות הניהוליות הבאות בפלטפורמת ServiceNow.
הוראות ספציפיות לניווט בממשק של ServiceNow מפורטות במסמכי התיעוד הרשמיים של ServiceNow.
- יצירת תפקיד בהתאמה אישית: עוברים אל Roles > New ויוצרים תפקיד חדש שמיועד לטיפול בגישה לתגובות ב-API.
- יצירת כלל חדש של רשימת בקרת גישה (ACL): כדי לעקוב אחרי תגובות והערות עבודה, צריך לתת לאפליקציה גישת קריאה לטבלה
sys_journal_field. עוברים אל בקרות גישה > חדש. כדי ליצור את הכלל הזה, צריך להיכנס לחשבון עם הרשאות מתקדמות. מגדירים את הפרמטרים של ה-ACL:
- מגדירים את Type לערך
record. - מגדירים את Operation לערך
read. - בשדות Name, בוחרים באפשרות Journal Entry
sys_journal_fieldבתפריט הנפתח הראשון, ובאפשרות -- None -- בתפריט הנפתח השני.
- עוברים לרשימה Requires role בתחתית הטופס ומוסיפים את תפקיד התגובה החדש בהתאמה אישית שיצרתם. לוחצים על שליחה.
- מגדירים את Type לערך
הקצאת תפקידים לחשבון השילוב: עוברים אל Users, פותחים את חשבון השילוב הייעודי ומקצים את התפקידים הבאים:
- התפקיד בהתאמה אישית שיצרתם כדי לקרוא תגובות.
-
sn_incident_write: נדרש לאינטראקציה בסיסית, כמו הפעולות Get Incident ו-Update Incident. -
itil: נדרש לפעולות CMDB ולפונקציות חיפוש קשורות של ניהול הגדרות נכסים.
אפשרויות להגדרת אימות
השילוב של ServiceNow תומך בשלוש שיטות אימות שונות. בוחרים באחת מאפשרויות ההגדרה הבאות, בהתאם לדרישות האבטחה של הארגון.
אפשרות 1: תהליך פרטי הכניסה של לקוח OAuth 2.0 (מומלץ)
בשיטה הזו משתמשים בהענקת פרטי כניסה של לקוח OAuth 2.0 לצד התחברות זמנית כמשתמש אחר כדי להגביל באופן בטוח את הגישה לנתונים בלי לחשוף לפלטפורמה סיסמה סטטית של משתמש.
שלב 1: יוצרים נקודת קצה (endpoint) של OAuth ב-ServiceNow
- מחפשים את Application Registries בתפריט הניווט של ServiceNow ולוחצים על New.
- בוחרים באפשרות New Inbound Integration Experience (חוויית שילוב חדשה של הודעות נכנסות).
- ברשימת סוגי החיבורים, בוחרים באפשרות OAuth - Client credentials grant (OAuth – הענקת פרטי כניסה של לקוח).
- בשדה Name, נותנים שם תיאורי להגדרת נקודת הקצה.
- מזינים את השם או המזהה של ספק ה-OAuth שנדרש כדי ליצור את ההקשר של פרופיל הזהות.
- בשדה OAuth application user, בוחרים את חשבון המשתמש הייעודי ב-ServiceNow שישמש להתחזות ולכל הפעילויות האוטומטיות של ה-API.
- לוחצים על שליחה או על שמירה.
- פותחים מחדש את רשומת הרישום החדשה שנוצרה כדי להעתיק ולאבטח את מזהה הלקוח ואת סוד הלקוח שנוצרו.
שלב 2: הגדרה ב-Google SecOps
- ב-Google SecOps, עוברים אל Automation > Integrations Setup ופותחים את חלון ההגדרות של ServiceNow.
- מזינים את שורש ה-API (מחליפים את דומיין ברירת המחדל של הפלייסהולדר בכתובת ה-URL של המכונה של ServiceNow).
- מזינים את מזהה הלקוח ואת סוד הלקוח שנוצרו בשלב 1.
- מוודאים שהשדות Username, Password ו-Refresh Token ריקים לגמרי.
- מסמנים את תיבת הסימון Use Oauth Authentication.
- לוחצים על בדיקה כדי לאמת את הפרמטרים באמצעות בדיקת פינג לקישוריות. אם הבדיקה הצליחה, לוחצים על Save.
אפשרות 2: אימות בסיסי
בשיטה הזו, האימות של פרטי הכניסה מתבצע באופן ישיר. קל להגדיר אותו, אבל יכול להיות שהוא יהיה מוגבל אם בארגון שלכם נאכף אימות רב-שלבי (MFA) או נחסמות כותרות אימות בסיסיות.
- ב-ServiceNow, מוודאים שלמשתמש השילוב יש שם משתמש וסיסמה מקומיים.
- כשמגדירים את השילוב ב-Google SecOps, צריך לספק את Api Root (מחליפים את דומיין ברירת המחדל של ה-placeholder בכתובת ה-URL של המכונה של ServiceNow), את Username ואת Password.
- משאירים את השדות שקשורים ל-OAuth ריקים ומוודאים שהאפשרות
Use Oauth Authenticationמושבתת (תיבת הסימון לא מסומנת). - לוחצים על Test כדי לאמת את הפרמטרים של החיבור. אם הבדיקה הצליחה, לוחצים על Save.
אפשרות 3: תהליך של טוקן רענון
השתמשו בשיטה הזו אם הארגון שלכם דורש אמצעי בקרה לאבטחת OAuth באמצעות שרשרת של אסימוני רענון, כדי לאחזר באופן פרוגרמטי אסימוני גישה מאחורי הקלעים.
- משלימים את שלב 1 במכונה של ServiceNow כדי ליצור מזהה לקוח וסוד לקוח.
- מבצעים את השלבים בקטע יצירת טוקן רענון כדי לאחזר מחרוזת תקינה של טוקן הרשאה.
- ב-Google SecOps, פותחים את חלון ההגדרות של מופע השילוב של ServiceNow.
- ממלאים את הפרמטרים במלואם באמצעות פרטי הכניסה שהגדרתם:
- שורש ה-API (החלפת דומיין ברירת המחדל של הפלייסהולדר בכתובת ה-URL של המכונה של ServiceNow).
- שם משתמש
- סיסמה
- מזהה לקוח
- סוד לקוח
- מסמנים את התיבה Use Oauth Authentication.
- מדביקים את מחרוזת הטוקן שקיבלתם מתהליך העבודה בקטע יצירת טוקן רענון בשדה Refresh Token.
- לוחצים על Test כדי לאמת את הפרמטרים של החיבור. אם הבדיקה הצליחה, לוחצים על Save.
יצירת טוקן רענון (Google SecOps)
כדי ליצור את טוקן הרענון, צריך להגדיר באופן זמני את השילוב כך שיפעיל פעולת עזר.
- ב-Google SecOps, עוברים אל Automation > Integrations Setup.
- מוודאים שהתיבה Use Oauth Authentication לא מסומנת בשלב ההגדרה הראשוני הזה.
- מגדירים מופע זמני של שילוב ServiceNow באמצעות Api Root, Username, Password, Client ID ו-Client Secret, ולוחצים על Save.
- מדמים פנייה או פותחים פנייה קיימת.
- מריצים את הפעולה Get Oauth Token של ServiceNow באופן ידני בבקשת התמיכה.
- מעתיקים את הערך של
refresh_tokenמתוצאת ה-JSON של הפעולה, כדי להשתמש בו בשדה טוקן רענון כשמגדירים את מופע האינטגרציה הסופי.
פרמטרים של שילוב
כדי לשלב את ServiceNow, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Api Root |
חובה. שורש ה-API של המכונה של ServiceNow. ערך ברירת המחדל הוא |
Username |
חובה. שם המשתמש של חשבון ServiceNow. |
Password |
חובה. הסיסמה של חשבון ServiceNow. |
Incident Table |
זה שינוי אופציונלי. שם הטבלה או הנתיב ב-API שמשמשים לפעולות שקשורות לאירועים ולאחזור רשומות. כברירת מחדל, השילוב משתמש בנתיב |
Verify SSL |
זה שינוי אופציונלי. אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow. מופעלת כברירת מחדל. |
Client ID |
זה שינוי אופציונלי. מזהה הלקוח לשילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות פרטי הכניסה של הלקוח. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם מגדירים גם את טוקן הרענון וגם את פרטי הכניסה של הלקוח, השילוב משתמש בטוקן הרענון לצורך אימות. |
Client Secret |
זה שינוי אופציונלי. סוד הלקוח לשילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות פרטי הכניסה של הלקוח. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם מגדירים גם את טוקן הרענון וגם את פרטי הכניסה של הלקוח, השילוב משתמש בטוקן הרענון לצורך אימות. |
Refresh Token |
זה שינוי אופציונלי. טוקן הרענון של השילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות טוקן רענון. התוקף של טוקן הרענון שהוגדר פג כל 90 יום. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם מגדירים גם את טוקן הרענון וגם את פרטי הכניסה של הלקוח, השילוב משתמש בטוקן הרענון לצורך אימות. |
Use Oauth Authentication |
זה שינוי אופציונלי. אם האפשרות הזו נבחרת, השילוב משתמש ב-OAuth 2.0 לאימות. כדי לבצע אימות באמצעות OAuth 2.0, צריך להגדיר את פרטי הכניסה של הלקוח ( מושבתת כברירת מחדל. |
איך מגדירים שילובים ב-Google SecOps
אם צריך, אפשר לבצע שינויים בשלב מאוחר יותר. אחרי שמגדירים מופע של שילוב, אפשר להשתמש בו בפלייבוקים. למידע נוסף על הגדרה ותמיכה במספר מופעים, ראו תמיכה במספר מופעים.
פעולות
מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.
צירוף קובץ
כדי להוסיף קבצים מצורפים לרשומה בטבלה ב-ServiceNow, משתמשים בפעולה Add Attachment.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה הוספת קובץ מצורף דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
חובה. שם הטבלה שמכילה את הרשומה שאליה מוסיפים את הקובץ המצורף. |
Record Sys ID |
חובה. מזהה המערכת ( |
File Path |
חובה. רשימה מופרדת בפסיקים של נתיבים מוחלטים לקבצים שרוצים לצרף. |
Mode |
זה שינוי אופציונלי. ההתנהגות של הפעולה כשכבר קיים קובץ עם אותו שם ברשומה. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
פלט של פעולות
הפעולה הוספת קובץ מצורף מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Add Attachment:
{
"result": {
"size_bytes": "742",
"file_name": "placeholder_document.txt",
"sys_mod_count": "0",
"average_image_color": "",
"image_width": "",
"sys_updated_on": "2025-01-01 10:00:00",
"sys_tags": "",
"table_name": "incident",
"sys_id": "TEST_SYS_ID_ATTACH_123456789",
"image_height": "",
"sys_updated_by": "admin",
"download_link": "https://placeholder.service-now.com/api/now/attachment/TEST_SYS_ID_ATTACH_123456789/file",
"content_type": "multipart/form-data",
"sys_created_on": "2025-01-01 10:00:00",
"size_compressed": "438",
"compressed": "true",
"state": "pending",
"table_sys_id": "TEST_SYS_ID_RECORD_ABCDEFG",
"chunk_size_bytes": "700000",
"hash": "test_hash_0000000000000000000000000000000000000000000000000000000000000000",
"sys_created_by": "admin"
}
}
הודעות פלט
הפעולה הוספת קובץ מצורף יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "Add Attachment". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה הוספת קובץ מצורף:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הוסף הערה
משתמשים בפעולה הוספת תגובה כדי להוסיף תגובה לאירוע ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה הוספת תגובה דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Incident Number |
חובה. מספר האירוע שאליו רוצים להוסיף את ההערה, בפורמט |
Comment |
חובה. התגובה שרוצים להוסיף לאירוע. |
פלט של פעולות
הפעולה הוספת תגובה מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה הוספת תגובה:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הוספת תגובה והמתנה לתשובה
משתמשים בפעולה Add Comment and Wait for Reply כדי להוסיף תגובה לאירוע ב-ServiceNow, ואז משהים את הפעלת הפלייבוק עד שנוספת תגובה חדשה או תשובה לאירוע הזה. הפלט של הפעולה הוא התוכן של התגובה החדשה.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה הוספת הערה והמתנה לתשובה דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Incident Number |
חובה. מספר האירוע שאליו רוצים להוסיף את ההערה, בפורמט |
Comment |
חובה. התגובה שרוצים להוסיף לאירוע. |
פלט של פעולות
הפעולה הוספת תגובה והמתנה לתשובה מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט התוצאה של הסקריפט כשמשתמשים בפעולה הוספת תגובה והמתנה לתשובה:
| שם תוצאת הסקריפט | ערך |
|---|---|
new_comment |
הוספת הערה לרשומה
משתמשים בפעולה Add Comment To Record כדי להוסיף תגובה או הערת עבודה לרשומה ספציפית בטבלה ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה הוספת הערה לרשומה דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
חובה. שם הטבלה שרוצים להוסיף לה את התגובה או ההערה. |
Type |
חובה. סוג התגובה או ההערה שרוצים להוסיף. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Record Sys ID |
חובה. מזהה המערכת ( |
Text |
חובה. תוכן התגובה או הערת העבודה. |
Wait For Reply |
זה שינוי אופציונלי. אם בוחרים באפשרות הזו, הפעולה פועלת באופן אסינכרוני והביצוע מושהה עד שמוסיפים תגובה חדשה או הערת עבודה לרשומה. הפעולה עוקבת אחרי תגובות אם מוסיפים תגובה, ואחרי הערות עבודה אם מוסיפים הערת עבודה. מושבתת כברירת מחדל. |
פלט של פעולות
הפעולה Add Comment To Record מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Add Comment To Record:
{
"sys_id": "4355183607523010ff23f6fd7c1ed0a8",
"sys_created_on": "2021-09-03 10:29:48",
"name": "incident",
"element_id": "552c48888c033300964f4932b03eb092",
"sys_tags": "",
"value": "Test comment content.",
"sys_created_by": "admin",
"element": "comments"
}
הודעות פלט
הפעולה הוספת הערה לרשומה יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully added
COMMENT_OR_NOTE "
CONTENT" to TABLE_NAME
with Sys_ID SYS_ID in ServiceNow.
|
הפעולה בוצעה בהצלחה. |
Error executing action "Add Comment To Record". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Add Comment To Record:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הוספת אירוע ראשי
משתמשים בפעולה Add Parent Incident כדי להוסיף אירוע הורה לאירועים ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
כדי להשתמש בפעולה Add Parent Incident, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Parent Incident Number |
חובה. מספר האירוע הראשי, בפורמט הפעולה מוסיפה את כל האירועים ב- |
Child Incident Numbers |
חובה. רשימה מופרדת בפסיקים של מספרי אירועים שיוגדרו כאירועים משניים של האירוע הראשי שצוין, בפורמט |
פלט של פעולות
הפעולה Add Parent Incident מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Add Parent Incident:
{
"result": [
{
"parent": "",
"made_sla": "true",
"caused_by": "",
"watch_list": "",
"upon_reject": "cancel",
"sys_updated_on": "2020-10-20 07:19:11",
"child_incidents": "0",
"hold_reason": "",
"approval_history": "",
"skills": "",
"number": "INC0010009",
"resolved_by": "",
"sys_updated_by": "admin",
"opened_by": {
"link": "https://example.service-now.com/api/now/table/sys_user/ID",
"value": "ID"
},
"user_input": "",
"sys_created_on": "2020-10-20 07:19:11",
"sys_domain": {
"link": "https://example.service-now.com/api/now/table/sys_user_group/global",
"value": "global"
},
"state": "1",
"sys_created_by": "admin",
"knowledge": "false",
"order": "",
"calendar_stc": "",
"closed_at": "",
"cmdb_ci": "",
"delivery_plan": "",
"contract": "",
"impact": "3",
"active": "true",
"work_notes_list": "",
"business_service": "",
"priority": "5",
"sys_domain_path": "/",
"rfc": "",
"time_worked": "",
"expected_start": "",
"opened_at": "2020-10-20 07:18:56",
"business_duration": "",
"group_list": "",
"work_end": "",
"caller_id": {
"link": "https://example.service-now.com/api/now/table/sys_user/ID",
"value": "ID"
},
"reopened_time": "",
"resolved_at": "",
"approval_set": "",
"subcategory": "",
"work_notes": "",
"short_description": "Assessment : Assessor",
"close_code": "",
"correlation_display": "",
"delivery_task": "",
"work_start": "",
"assignment_group": "",
"additional_assignee_list": "",
"business_stc": "",
"description": "",
"calendar_duration": "",
"close_notes": "",
"notify": "1",
"service_offering": "",
"sys_class_name": "incident",
"closed_by": "",
"follow_up": "",
"parent_incident": {
"link": "https://example.service-now.com/api/now/table/incident/ID",
"value": "ID"
},
"sys_id": "2a100a1c2fc42010c518532a2799b621",
"contact_type": "",
"reopened_by": "",
"incident_state": "1",
"urgency": "3",
"problem_id": "",
"company": "",
"reassignment_count": "0",
"activity_due": "",
"assigned_to": "",
"severity": "3",
"comments": "",
"approval": "not requested",
"sla_due": "",
"comments_and_work_notes": "",
"due_date": "",
"sys_mod_count": "0",
"reopen_count": "0",
"sys_tags": "",
"escalation": "0",
"upon_approval": "proceed",
"correlation_id": "",
"location": "",
"category": "inquiry"
}
]
}
הודעות פלט
הפעולה Add Parent Incident יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully set
PARENT_INCIDENT_NUMBER as the
"Parent Incident" for the following incidents in ServiceNow:
CHILD_INCIDENT_NUMBERS. |
הפעולה בוצעה בהצלחה. |
Error executing action "Add Parent Incident".
Reason: ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
סגירת האירוע
כדי לסגור אירוע ב-ServiceNow, משתמשים בפעולה Close Incident.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
כדי להשתמש בפעולה Close Incident, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Incident Number |
חובה. מספר האירוע שרוצים לסגור, בפורמט |
Close Reason |
חובה. הסיבה לסגירת האירוע. |
Resolution Code |
חובה. קוד הפתרון של האירוע. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Close Notes |
חובה. הערות הסגירה של האירוע. |
פלט של פעולות
הפעולה Close Incident מספקת את הפלט הבא:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Close Incident:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
יצירת אירוע התראה
משתמשים בפעולה Create Alert Incident כדי ליצור אירוע חדש ב-ServiceNow על סמך פרטי ההתראה שמפעילה את הפעלת הפלייבוק.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה יצירת אירוע התראה דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Impact |
חובה. רמת ההשפעה של האירוע. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Urgency |
חובה. רמת הדחיפות של האירוע. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Category |
זה שינוי אופציונלי. הקטגוריה של האירוע. |
Assignment Group ID |
זה שינוי אופציונלי. השם המלא של הקבוצה שאליה רוצים להקצות את האירוע. |
Assigned User ID |
זה שינוי אופציונלי. השם המלא של המשתמש שרוצים להקצות לו את האירוע. |
Description |
זה שינוי אופציונלי. תיאור האירוע. |
פלט של פעולות
הפעולה Create Alert Incident מספקת את הפלט הבא:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Create Alert Incident:
{
"sys_tags": " ",
"user_input": " ",
"calendar_stc": " ",
"subcategory": " ",
"watch_list": " ",
"follow_up": " ",
"made_sla": "true",
"sys_created_by": "admin",
"sla_due": " ",
"number": "INC0010005",
"group_list": " ",
"reassignment_count": "0",
"assigned_to": " ",
"sys_mod_count": "0",
"notify": "1",
"resolved_by": " ",
"upon_reject": "cancel",
"additional_assignee_list": " ",
"category": "inquiry",
"closed_at": " ",
"parent_incident": " ",
"cmdb_ci": " ",
"contact_type": " ",
"impact": "1",
"rfc": " ",
"expected_start": " ",
"knowledge": "false",
"sys_updated_by":
"admin", "caused_by": " ",
"comments": " ",
"closed_by": " ",
"priority": "1",
"state": "1",
"sys_id": "ID",
"opened_at": "2020-07-10 05:13:25",
"child_incidents": "0",
"work_notes": " ",
"delivery_task": " ",
"short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
"comments_and_work_notes": " ",
"time_worked": " ",
"upon_approval": "proceed",
"company": " ",
"business_stc": " ",
"correlation_display": " ",
"sys_class_name": "incident",
"delivery_plan": " ",
"escalation": "0",
"description": " ",
"parent": " ",
"close_notes": " ",
"business_duration": " ",
"problem_id": " ",
"sys_updated_on": "2020-07-10 05:13:25",
"approval_history": " ",
"approval_set": " ",
"business_service": " ",
"reopened_by": " ",
"calendar_duration": " ",
"caller_id": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"active": "true",
"approval": "not requested",
"service_offering": " ",
"sys_domain_path": "/",
"hold_reason": " ",
"activity_due": "2020-07-10 07:13:25",
"severity": "3",
"incident_state": "1",
"resolved_at": " ",
"location": " ",
"due_date": " ",
"work_start": " ",
"work_end": " ",
"work_notes_list": " ",
"sys_created_on": "2020-07-10 05:13:25",
"correlation_id": " ",
"contract": " ",
"reopened_time": " ",
"opened_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"close_code": " ",
"assignment_group": " ",
"sys_domain": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
"value": "global"
},
"order": " ",
"urgency": "1",
"reopen_count": "0"
}
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Create Alert Incident:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
יצירת אירוע
כדי ליצור אירוע חדש ב-ServiceNow, משתמשים בפעולה יצירת אירוע.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
כדי להשתמש בפעולה Create Incident, צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Short Description |
חובה. תיאור קצר של האירוע. |
Impact |
חובה. רמת ההשפעה של האירוע. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Urgency |
חובה. רמת הדחיפות של האירוע. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Category |
זה שינוי אופציונלי. הקטגוריה של האירוע. |
Assignment Group ID |
זה שינוי אופציונלי. השם המלא של הקבוצה שאליה רוצים להקצות את האירוע. |
Assigned User ID |
זה שינוי אופציונלי. השם המלא של המשתמש שרוצים להקצות לו את האירוע. |
Description |
זה שינוי אופציונלי. תיאור האירוע. |
Custom Fields |
זה שינוי אופציונלי. מחרוזת בפורמט JSON שמכילה את שמות השדות והערכים התואמים שלהם לעדכון (לדוגמה, אפשר להשתמש בפרמטר הזה כדי לשנות שדות שלא הוגדרו במפורש כקלט של פעולה. |
פלט של פעולות
הפעולה Create Incident מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Create Incident:
{
"sys_tags": " ",
"user_input": " ",
"calendar_stc": " ",
"subcategory": " ",
"watch_list": " ",
"follow_up": " ",
"made_sla": "true",
"sys_created_by": "admin",
"sla_due": " ",
"number": "INC0010005",
"group_list": " ",
"reassignment_count": "0",
"assigned_to": " ",
"sys_mod_count": "0",
"notify": "1",
"resolved_by": " ",
"upon_reject": "cancel",
"additional_assignee_list": " ",
"category": "inquiry",
"closed_at": " ",
"parent_incident": " ",
"cmdb_ci": " ",
"contact_type": " ",
"impact": "1",
"rfc": " ",
"expected_start": " ",
"knowledge": "false",
"sys_updated_by":
"admin", "caused_by": " ",
"comments": " ",
"closed_by": " ",
"priority": "1",
"state": "1",
"sys_id": "ID",
"opened_at": "2020-07-10 05:13:25",
"child_incidents": "0",
"work_notes": " ",
"delivery_task": " ",
"short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
"comments_and_work_notes": " ",
"time_worked": " ",
"upon_approval": "proceed",
"company": " ",
"business_stc": " ",
"correlation_display": " ",
"sys_class_name": "incident",
"delivery_plan": " ",
"escalation": "0",
"description": " ",
"parent": " ",
"close_notes": " ",
"business_duration": " ",
"problem_id": " ",
"sys_updated_on": "2020-07-10 05:13:25",
"approval_history": " ",
"approval_set": " ",
"business_service": " ",
"reopened_by": " ",
"calendar_duration": " ",
"caller_id": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"active": "true",
"approval": "not requested",
"service_offering": " ",
"sys_domain_path": "/",
"hold_reason": " ",
"activity_due": "2020-07-10 07:13:25",
"severity": "3",
"incident_state": "1",
"resolved_at": " ",
"location": " ",
"due_date": " ",
"work_start": " ",
"work_end": " ",
"work_notes_list": " ",
"sys_created_on": "2020-07-10 05:13:25",
"correlation_id": " ",
"contract": " ",
"reopened_time": " ",
"opened_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"close_code": " ",
"assignment_group": " ",
"sys_domain": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
"value": "global"
},
"order": " ",
"urgency": "1",
"reopen_count": "0"
}
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Create Incident:
| שם תוצאת הסקריפט | ערך |
|---|---|
incident_number |
INCIDENT_NUMBER |
יצירת רשומה
משתמשים בפעולה Create Record כדי ליצור רשומות חדשות בטבלאות שונות ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Create Record דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
זה שינוי אופציונלי. השם של הטבלה ב-ServiceNow שבה נוצרת הרשומה החדשה (לדוגמה, |
Object Json Data |
זה שינוי אופציונלי. אובייקט ה-JSON שמכיל את צמדי השדה-ערך שנדרשים כדי להגדיר את הרשומה החדשה (כמו שדות של אירועים או מאפיינים של פריטי CMDB). |
פלט של פעולות
הפעולה Create Record מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Create Record:
{
"sys_tags": " ",
"user_input": " ",
"calendar_stc": " ",
"subcategory": " ",
"watch_list": " ",
"follow_up": " ",
"made_sla": "true",
"sys_created_by": "admin",
"sla_due": " ",
"number": "INC0010021",
"group_list": " ",
"reassignment_count": "0",
"assigned_to": " ",
"sys_mod_count": "0",
"notify": "1",
"resolved_by": " ",
"upon_reject": "cancel",
"additional_assignee_list": " ",
"category": "inquiry",
"closed_at": " ",
"parent_incident": " ",
"cmdb_ci": " ",
"contact_type": " ",
"impact": "3",
"rfc": " ",
"expected_start": " ",
"knowledge": "false",
"sys_updated_by": "admin",
"caused_by": " ",
"comments": " ",
"closed_by": " ",
"priority": "5",
"state": "1",
"sys_id": "ID",
"opened_at": "2020-07-10 08:24:34",
"child_incidents": "0",
"work_notes": " ",
"delivery_task": " ",
"short_description": " ",
"comments_and_work_notes": " ",
"time_worked": " ",
"upon_approval": "proceed",
"company": " ",
"business_stc": " ",
"correlation_display": " ",
"sys_class_name": "incident",
"delivery_plan": " ",
"escalation": "0",
"description": " ",
"parent": " ",
"close_notes": " ",
"business_duration": " ",
"problem_id": " ",
"sys_updated_on": "2020-07-10 08:24:34",
"approval_history": " ",
"approval_set": " ",
"business_service": " ",
"reopened_by": " ",
"calendar_duration": " ",
"caller_id": " ",
"active": "true",
"approval": "not requested",
"service_offering": " ",
"sys_domain_path": "/",
"hold_reason": " ",
"activity_due": " ",
"severity": "3",
"incident_state": "1",
"resolved_at": " ",
"location": " ",
"due_date": " ",
"work_start": " ",
"work_end": " ",
"work_notes_list": " ",
"sys_created_on": "2020-07-10 08:24:34",
"correlation_id": " ",
"contract": " ",
"reopened_time": " ",
"opened_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"close_code": " ",
"assignment_group": " ",
"sys_domain": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
"value": "global"
},
"order": " ",
"urgency": "3",
"reopen_count": "0"
}
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Create Record:
| שם תוצאת הסקריפט | ערך |
|---|---|
object_sys_id |
OBJECT_SYS_ID |
הורדת קבצים מצורפים
אתם יכולים להשתמש בפעולה Download Attachments כדי להוריד קבצים ומסמכים שמצורפים לרשומה ספציפית ב-ServiceNow לתיקייה מקומית בסביבת Google SecOps.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה הורדת קבצים מצורפים דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
חובה. שם הטבלה ב-ServiceNow שמכילה את הרשומה שממנה רוצים להוריד קבצים מצורפים (למשל |
Record Sys ID |
חובה. מזהה המערכת ( |
Download Folder Path |
חובה. הנתיב המוחלט לתיקייה בסביבת Google SecOps שבה נשמרים הקבצים המצורפים שהורדתם. |
Overewrite |
זה שינוי אופציונלי. אם בוחרים באפשרות הזו, הפעולה מחליפה קבצים עם אותו שם. מושבתת כברירת מחדל. |
פלט של פעולות
הפעולה הורדת קבצים מצורפים מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Download Attachments:
{
"result": [
{"absolute_file_path" : ["PATH"]
"size_bytes": "187",
"file_name": "example.txt",
"sys_mod_count": "1",
"average_image_color": "",
"image_width": "",
"sys_updated_on": "2020-10-19 09:58:39",
"sys_tags": "",
"table_name": "problem",
"sys_id": "SYS_ID",
"image_height": "",
"sys_updated_by": "system",
"download_link": "https://example.service-now.com/api/now/attachment/ID/file",
"content_type": "text/plain",
"sys_created_on": "2020-10-19 09:58:38",
"size_compressed": "172",
"compressed": "true",
"state": "available",
"table_sys_id": "57771d002f002010c518532a2799b6cc",
"chunk_size_bytes": "700000",
"hash": "a4fbb8ab71268903845b59724835274ddc66e095de553c5e0c1da8fecd04ee45",
"sys_created_by": "admin"
}
]
}
הודעות פלט
הפעולה הורדת קבצים מצורפים יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "Download Attachments". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה הורדת קבצים מצורפים:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
קבלת פרטים על אירוע צאצא
משתמשים בפעולה Get Child Incident Details כדי לאחזר מידע על אירועים משניים על סמך האירוע הראשי ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Get Child Incident Details דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Parent Incident Number |
חובה. מספר האירוע הראשי שממנו רוצים לאחזר את פרטי האירוע המשני, בפורמט |
Max Child Incident To Return |
זה שינוי אופציונלי. מספר האירועים הצאצאים המקסימלי שהפעולה מחזירה מהאירוע ההורה. ערך ברירת המחדל הוא |
פלט של פעולות
הפעולה Get Child Incident Details מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | יש גישה |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
שולחן קיר עם ארונית
הפעולה Get Child Incident Details מספקת את הטבלה הבאה:
שם הטבלה: פרטי אירוע משני
עמודות בטבלה:
- Sys ID (ממופה בתור
sys_id) - מספר (ממופה בתור
number) - תיאור קצר (ממופה בתור
short_description) - Created At (ממופה בתור
sys_created_on)
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Get Child Incident Details:
{
"result": [
{
"parent": "",
"made_sla": "true",
"caused_by": "",
"watch_list": "",
"upon_reject": "cancel",
"sys_updated_on": "2020-10-20 07:19:11",
"child_incidents": "0",
"hold_reason": "",
"approval_history": "",
"skills": "",
"number": "INC0010009",
"resolved_by": "",
"sys_updated_by": "admin",
"opened_by": {
"link": "https://example.service-now.com/api/now/table/sys_user/ID",
"value": "ID"
},
"user_input": "",
"sys_created_on": "2020-10-20 07:19:11",
"sys_domain": {
"link": "https://example.service-now.com/api/now/table/sys_user_group/global",
"value": "global"
},
"state": "1",
"sys_created_by": "admin",
"knowledge": "false",
"order": "",
"calendar_stc": "",
"closed_at": "",
"cmdb_ci": "",
"delivery_plan": "",
"contract": "",
"impact": "3",
"active": "true",
"work_notes_list": "",
"business_service": "",
"priority": "5",
"sys_domain_path": "/",
"rfc": "",
"time_worked": "",
"expected_start": "",
"opened_at": "2020-10-20 07:18:56",
"business_duration": "",
"group_list": "",
"work_end": "",
"caller_id": {
"link": "https://example.service-now.com/api/now/table/sys_user/ID",
"value": "ID"
},
"reopened_time": "",
"resolved_at": "",
"approval_set": "",
"subcategory": "",
"work_notes": "",
"short_description": "Assessment : ATF Assessor",
"close_code": "",
"correlation_display": "",
"delivery_task": "",
"work_start": "",
"assignment_group": "",
"additional_assignee_list": "",
"business_stc": "",
"description": "",
"calendar_duration": "",
"close_notes": "",
"notify": "1",
"service_offering": "",
"sys_class_name": "incident",
"closed_by": "",
"follow_up": "",
"parent_incident": {
"link": "https://example.service-now.com/api/now/table/incident/ID",
"value": "ID"
},
"sys_id": "2a100a1c2fc42010c518532a2799b621",
"contact_type": "",
"reopened_by": "",
"incident_state": "1",
"urgency": "3",
"problem_id": "",
"company": "",
"reassignment_count": "0",
"activity_due": "",
"assigned_to": "",
"severity": "3",
"comments": "",
"approval": "not requested",
"sla_due": "",
"comments_and_work_notes": "",
"due_date": "",
"sys_mod_count": "0",
"reopen_count": "0",
"sys_tags": "",
"escalation": "0",
"upon_approval": "proceed",
"correlation_id": "",
"location": "",
"category": "inquiry"
}
]
}
הודעות פלט
הפעולה Get Child Incident Details יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "Get Child Incident Details". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Get Child Incident Details:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
קבלת פרטי רשומה של CMDB
משתמשים בפעולה Get CMDB Record Details כדי לקבל רשומות CMDB מפורטות מאותה מחלקה ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Get CMDB Record Details דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Class Name |
חובה. שם המחלקה של CMDB שממנה רוצים לאחזר רשומות, למשל מידע נוסף על שמות של מחלקות זמין במאמר הצגה ועריכה של הגדרות ומטא-נתונים של מחלקות. |
Sys ID |
חובה. רשימה מופרדת בפסיקים של מזהי המערכת ( |
Max Records To Return |
זה שינוי אופציונלי. המספר המקסימלי של קשרי רשומות שיוחזרו לכל סוג קשר (כמו ערך ברירת המחדל הוא |
פלט של פעולות
הפעולה Get CMDB Record Details מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Get CMDB Record Details:
{
"result": {
"outbound_relations": [
{
"sys_id": "56f3a7ad7f701200bee45f19befa910f",
"type": {
"display_value": "Members::Member of",
"link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
"value": "ID"
},
"target": {
"display_value": "Example",
"link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
"value": "ID"
}
}
],
"attributes": {
"attested_date": "",
"skip_sync": "false",
"operational_status": "1",
"caption": "",
"cluster_type": "",
"sys_updated_on": "2016-01-06 19:04:07",
"attestation_score": "",
"discovery_source": "",
"first_discovered": "",
"sys_updated_by": "example.user",
"cluster_status": "",
"due_in": "",
"sys_created_on": "2016-01-06 16:47:15",
"sys_domain": {
"display_value": "global",
"link": "https://example.service-now.com/api/now/table/sys_user_group/global",
"value": "global"
},
"install_date": "",
"invoice_number": "",
"gl_account": "",
"sys_created_by": "example.user",
"warranty_expiration": "",
"cluster_version": "",
"asset_tag": "",
"fqdn": "",
"change_control": "",
"owned_by": "",
"checked_out": "",
"sys_domain_path": "/",
"delivery_date": "",
"maintenance_schedule": "",
"install_status": "1",
"cost_center": "",
"attested_by": "",
"supported_by": "",
"dns_domain": "",
"name": "SAP-LB-Win-Cluster",
"assigned": "",
"purchase_date": "",
"subcategory": "Cluster",
"short_description": "",
"assignment_group": "",
"managed_by": "",
"managed_by_group": "",
"last_discovered": "",
"can_print": "false",
"sys_class_name": "cmdb_ci_win_cluster",
"manufacturer": "",
"sys_id": "SYS_ID",
"cluster_id": "",
"po_number": "",
"checked_in": "",
"sys_class_path": "/!!/!5/!$",
"vendor": "",
"mac_address": "",
"company": "",
"model_number": "",
"justification": "",
"department": "",
"assigned_to": "",
"start_date": "",
"cost": "",
"comments": "",
"sys_mod_count": "1",
"serial_number": "",
"monitor": "false",
"model_id": "",
"ip_address": "",
"duplicate_of": "",
"sys_tags": "",
"cost_cc": "USD",
"support_group": "",
"order_date": "",
"schedule": "",
"environment": "",
"due": "",
"attested": "false",
"unverified": "false",
"correlation_id": "",
"attributes": "",
"location": "",
"asset": "",
"category": "Resource",
"fault_count": "0",
"lease_id": ""
},
"inbound_relations": [
{
"sys_id": "3b3d95297f701200bee45f19befa910c",
"type": {
"display_value": "Depends on::Used by",
"link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
"value": "ID"
},
"target": {
"display_value": "IP-Router-3",
"link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
"value": "ID"
}
}
]
}
}
הודעות פלט
הפעולה Get CMDB Record Details יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "Get CMDB Record Details". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Get CMDB Record Details:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
קבלת אירוע
משתמשים בפעולה Get Incident כדי לאחזר מידע על אירוע ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Get Incident דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Incident Number |
חובה. המזהה הייחודי של האירוע ב-ServiceNow שרוצים לאחזר, בפורמט |
פלט של פעולות
הפעולה Get Incident מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Get Incident:
{
"sys_tags": " ",
"user_input": " ",
"calendar_stc": "2012",
"subcategory": " ",
"watch_list": " ",
"follow_up": " ",
"made_sla": "true",
"sys_created_by": "admin",
"sla_due": " ",
"number": "INC0010041",
"group_list": " ",
"reassignment_count": "0",
"assigned_to": " ",
"sys_mod_count": "10",
"notify": "1",
"resolved_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"upon_reject": "cancel",
"additional_assignee_list": " ",
"category": "inquiry",
"closed_at": "2020-07-10 12:53:06",
"parent_incident": " ",
"cmdb_ci": " ",
"contact_type": " ",
"impact": "1",
"rfc": " ",
"expected_start": " ",
"knowledge": "false",
"sys_updated_by": "admin",
"caused_by": " ",
"comments": " ",
"closed_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"priority": "1",
"state": "7",
"sys_id": "SYS_ID",
"opened_at": "2020-07-10 12:18:04",
"child_incidents": "0",
"work_notes": " ",
"delivery_task": " ",
"short_description": "sdf",
"comments_and_work_notes": " ",
"time_worked": " ",
"upon_approval": "proceed",
"company": " ",
"business_stc": "0",
"correlation_display": " ",
"sys_class_name": "incident",
"delivery_plan": " ",
"escalation": "0",
"description": " ",
"parent": " ",
"close_notes": "Closed by Caller",
"business_duration": "1970-01-01 00:00:00",
"problem_id": " ",
"sys_updated_on": "2020-07-10 13:13:57",
"approval_history": " ",
"approval_set": " ",
"business_service": " ",
"reopened_by": " ",
"calendar_duration": "1970-01-01 00:35:02",
"caller_id": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"active": "false",
"approval": "not requested",
"service_offering": " ",
"sys_domain_path": "/",
"hold_reason": " ",
"activity_due": "2020-07-10 14:33:28",
"severity": "3",
"incident_state": "7",
"resolved_at": "2020-07-10 12:53:06",
"location": " ",
"due_date": " ",
"work_start": " ",
"work_end": " ",
"work_notes_list": " ",
"sys_created_on": "2020-07-10 12:18:04",
"correlation_id": " ",
"contract": " ",
"reopened_time": " ",
"opened_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"close_code": "Closed/Resolved by Caller",
"assignment_group": " ",
"sys_domain": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
"value": "global"
},
"order": " ",
"urgency": "1",
"reopen_count": "0"
}
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Get Incident:
| שם תוצאת הסקריפט | ערך |
|---|---|
incident_number |
INCIDENT_NUMBER |
קבלת טוקן OAuth
משתמשים בפעולה Get Oauth Token כדי לקבל טוקן רענון של OAuth ל-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
אין.
פלט של פעולות
הפעולה Get Oauth Token מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Get Oauth Token:
{
"access_token": "Na4Kb1oWpFcYNUnyAjsYldiTMxYF1Cz79Q",
"refresh_token": "0ryCENbbvfggZbNG9rFFd8_C8X0UgAQSMQkPJNStGwEEt0qNt-F1lw",
"scope": "useraccount",
"token_type": "Bearer",
"expires_in": 1799
}
הודעות פלט
הפעולה Get Oauth Token יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
Successfully generated Oauth tokens for ServiceNow. Now navigate
to the configuration tab and put "refresh_token" value in the "Refresh
Token" parameter. Note: "Username" and "Password" parameters can be
emptied. |
הפעולה בוצעה בהצלחה. |
Error executing action "Get Oauth Token". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה Get Oauth Token:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
קבלת פרטי הרשומה
משתמשים בפעולה Get Record Details כדי לאחזר מידע על רשומות ספציפיות בטבלה ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Get Record Details דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
חובה. שם הטבלה ב-ServiceNow שמכילה את הרשומה שממנה רוצים לאחזר מידע (למשל |
Record Sys ID |
חובה. מזהה המערכת ( |
Fields |
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של שדות (עמודות) ספציפיים שיוחזרו מהרשומה שאוחזרה (למשל אם לא מציינים ערך, הפעולה מחזירה את שדות ברירת המחדל של הרשומה. |
פלט של פעולות
הפעולה Get Record Details מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Get Record Details:
{
"result": [
{
"parent": "",
"made_sla": "true",
"caused_by": "",
"watch_list": "",
"upon_reject": "cancel",
"sys_updated_on": "2020-10-20 07:19:11",
"child_incidents": "0",
"hold_reason": "",
"approval_history": "",
"skills": "",
"number": "INC0010009",
"resolved_by": "",
"sys_updated_by": "admin",
"opened_by": {
"link": "https://example.service-now.com/api/now/table/sys_user/ID",
"value": "ID"
},
"user_input": "",
"sys_created_on": "2020-10-20 07:19:11",
"sys_domain": {
"link": "https://example.service-now.com/api/now/table/sys_user_group/global",
"value": "global"
},
"state": "1",
"sys_created_by": "admin",
"knowledge": "false",
"order": "",
"calendar_stc": "",
"closed_at": "",
"cmdb_ci": "",
"delivery_plan": "",
"contract": "",
"impact": "3",
"active": "true",
"work_notes_list": "",
"business_service": "",
"priority": "5",
"sys_domain_path": "/",
"rfc": "",
"time_worked": "",
"expected_start": "",
"opened_at": "2020-10-20 07:18:56",
"business_duration": "",
"group_list": "",
"work_end": "",
"caller_id": {
"link": "https://example.service-now.com/api/now/table/sys_user/ID",
"value": "ID"
},
"reopened_time": "",
"resolved_at": "",
"approval_set": "",
"subcategory": "",
"work_notes": "",
"short_description": "Assessment : ATF Assessor",
"close_code": "",
"correlation_display": "",
"delivery_task": "",
"work_start": "",
"assignment_group": "",
"additional_assignee_list": "",
"business_stc": "",
"description": "",
"calendar_duration": "",
"close_notes": "",
"notify": "1",
"service_offering": "",
"sys_class_name": "incident",
"closed_by": "",
"follow_up": "",
"parent_incident": {
"link": "https://example.service-now.com/api/now/table/incident/ID",
"value": "ID"
},
"sys_id": "SYS_ID",
"contact_type": "",
"reopened_by": "",
"incident_state": "1",
"urgency": "3",
"problem_id": "",
"company": "",
"reassignment_count": "0",
"activity_due": "",
"assigned_to": "",
"severity": "3",
"comments": "",
"approval": "not requested",
"sla_due": "",
"comments_and_work_notes": "",
"due_date": "",
"sys_mod_count": "0",
"reopen_count": "0",
"sys_tags": "",
"escalation": "0",
"upon_approval": "proceed",
"correlation_id": "",
"location": "",
"category": "inquiry"
}
]
}
הודעות פלט
הפעולה Get Record Details יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "Get Record Details". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה Get Record Details:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
קבלת פרטי משתמש
משתמשים בפעולה Get User Details כדי לאחזר מידע על המשתמש באמצעות הפרמטר sys_id ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Get User Details דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
User Sys IDs |
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של מזהי המערכת שתואמים למשתמשים שרוצים לאחזר את הפרטים שלהם (למשל |
Emails |
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של כתובות אימייל שמתאימות למשתמשים שרוצים לאחזר את הפרטים שלהם (למשל |
פלט של פעולות
הפעולה קבלת פרטי משתמש מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | יש גישה |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
שולחן קיר עם ארונית
הפעולה Get User Details (קבלת פרטי משתמש) מספקת את הטבלה הבאה:
שם הטבלה: פרטי המשתמש
עמודות בטבלה:
- Sys ID (ממופה בתור
sys_id) - שם (ממופה בתור
name) - שם משתמש (ממופה בתור
user_name) - אימייל (ממופה בתור
email)
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה Get User Details:
{
"result": [
{
"calendar_integration": "1",
"country": "",
"last_position_update": "",
"user_password": "example",
"last_login_time": "",
"source": "",
"sys_updated_on": "2020-08-29 02:42:42",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"enable_multifactor_authn": "false",
"sys_updated_by": "user@example",
"sys_created_on": "2012-02-18 03:04:52",
"agent_status": "",
"sys_domain": {
"link": "https://example.service-now.com/api/now/table/sys_user_group/global",
"value": "global"
},
"state": "",
"vip": "false",
"sys_created_by": "admin",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"sys_domain_path": "/",
"cost_center": {
"link": "https://example.service-now.com/api/now/table/cmn_cost_center/ID",
"value": "ID"
},
"phone": "",
"name": "Example User",
"employee_number": "",
"password_needs_reset": "false",
"gender": "Male",
"city": "",
"failed_attempts": "",
"user_name": "example.user",
"latitude": "",
"roles": "",
"title": "",
"sys_class_name": "sys_user",
"sys_id": "SYS_ID",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "",
"street": "",
"company": {
"link": "https://example.service-now.com/api/now/table/core_company/ID",
"value": "ID"
},
"department": {
"link": "https://dev98773.service-now.com/api/now/table/cmn_department/ID",
"value": "ID"
},
"first_name": "Example",
"email": "example@example.com",
"introduction": "",
"preferred_language": "",
"manager": "",
"business_criticality": "3",
"locked_out": "false",
"sys_mod_count": "4",
"last_name": "User",
"photo": "",
"avatar": "063e38383730310042106710ce41f13b",
"middle_name": "",
"sys_tags": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": {
"link": "https://example.service-now.com/api/now/table/cmn_location/ID",
"value": "ID"
}
}
]
}
הודעות פלט
הפעולה Get User Details יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "Get User Details". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה Get User Details:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הצגת רשימה של רשומות CMDB
משתמשים בפעולה List CMDB Records כדי להציג רשימה של רשומות CMDB מאותה מחלקה ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
המערכת יוצרת את מסנן השאילתה
הפרמטר Query Filter מקבל מחרוזות שאילתה רגילות בקידוד של ServiceNow (sysparm_query). אתם יכולים ליצור את המחרוזות האלה ישירות בממשק של ServiceNow (לדוגמה, על ידי יצירת מסנן בתצוגת רשימה ובחירה באפשרות Copy query) או ליצור אותן באופן ידני.
הוראות ליצירת מחרוזות כאלה ולשימוש בהן מפורטות בקטע Encoded query strings במסמכי התיעוד של ServiceNow.
קלט של הפעולה
הפעולה List CMDB Records דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Class Name |
חובה. שם המחלקה של CMDB שממנה רוצים לאחזר רשומות, למשל מידע נוסף על שמות המחלקות ב-ServiceNow זמין במאמר הצגה ועריכה של הגדרות ומטא-נתונים של מחלקות. |
Query Filter |
זה שינוי אופציונלי. מחרוזת השאילתה המקודדת שמשמשת לסינון הרשומות שמוחזרות (למשל אפשר ליצור מחרוזות שאילתה תקינות באמצעות האפשרות Copy query בתצוגות הרשימה של ServiceNow. מידע נוסף זמין במאמר מחרוזות של שאילתות מקודדות. |
Max Records To Return |
זה שינוי אופציונלי. המספר המקסימלי של רשומות לאחזור, על סמך המסננים שהוחלו. ערך ברירת המחדל הוא |
פלט של פעולות
הפעולה List CMDB Records מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | יש גישה |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
שולחן קיר עם ארונית
הפעולה List CMDB Records מספקת את הטבלה הבאה:
שם הטבלה: CLASS_NAME רשומות
עמודות בטבלה:
- שם (ממופה בתור
name) - Sys ID (ממופה בתור
sys_id)
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה List CMDB Records:
{
"result": [
{
"sys_id": "SYS_ID",
"name": "Example server"
}
]
}
הודעות פלט
הפעולה List CMDB Records יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "List CMDB Records". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה List CMDB Records:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הצגת רשימת התגובות לרשומה
משתמשים בפעולה List Record Comments כדי להציג רשימה של תגובות שקשורות לרשומה ספציפית בטבלה ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה הצגת רשימה של הערות ברשומה דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
חובה. שם הטבלה ב-ServiceNow שמכילה את הרשומה שרוצים להציג את התגובות שלה (למשל |
Record Sys ID |
חובה. מזהה המערכת ( |
Type |
חובה. סוג התגובות או ההערות שרוצים לאחזר. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Max Results To Return |
זה שינוי אופציונלי. המספר המקסימלי של תגובות או הערות עבודה שיוחזרו. ערך ברירת המחדל הוא |
פלט של פעולות
הפעולה הצגת רשימה של תגובות לרשומה מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה List Record Comments:
{
"sys_id": "SYS_ID",
"sys_created_on": "2021-09-03 10:29:48",
"name": "incident",
"element_id": "552c48888c033300964f4932b03eb092",
"sys_tags": "",
"value": "test",
"sys_created_by": "admin",
"element": "comments"
}
הודעות פלט
הפעולה List Record Comments יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "List Record Comments". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה List Record Comments:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
הצגת רשומות שקשורות למשתמש
משתמשים בפעולה List Records Related To User כדי להציג רשימה של רשומות מטבלה שקשורות למשתמש ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה List Records Related To User דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
חובה. שם הטבלה ב-ServiceNow שבה מחפשים רשומות קשורות (למשל, |
Usernames |
חובה. רשימה מופרדת בפסיקים של שמות משתמשים שרוצים לאחזר את הרשומות שקשורות אליהם. |
Max Days Backwards |
חובה. מספר הימים אחורה מהתאריך הנוכחי שבהם יתבצע חיפוש של רשומות קשורות. ערך ברירת המחדל הוא |
Max Records To Return |
זה שינוי אופציונלי. מספר הרשומות המקסימלי שיוחזרו לכל משתמש. ערך ברירת המחדל הוא |
פלט של פעולות
הפעולה List Records Related To User מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
בדוגמה הבאה מוצג פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה List Records Related To User:
{
"result": [
{
"parent": "",
"made_sla": "true",
"caused_by": "",
"watch_list": "",
"upon_reject": "cancel",
"sys_updated_on": "2020-10-19 14:18:40",
"child_incidents": "0",
"hold_reason": "",
"approval_history": "",
"skills": "",
"number": "INC0010008",
"resolved_by": "",
"sys_updated_by": "admin",
"opened_by": {
"link": "https://example.service-now.com/api/now/table/sys_user/ID",
"value": "ID"
},
"user_input": "",
"sys_created_on": "2020-10-19 14:18:40",
"sys_domain": {
"link": "https://example.service-now.com/api/now/table/sys_user_group/global",
"value": "global"
},
"state": "1",
"sys_created_by": "admin",
"knowledge": "false",
"order": "",
"calendar_stc": "",
"closed_at": "",
"cmdb_ci": "",
"delivery_plan": "",
"contract": "",
"impact": "3",
"active": "true",
"work_notes_list": "",
"business_service": "",
"priority": "5",
"sys_domain_path": "/",
"rfc": "",
"time_worked": "",
"expected_start": "",
"opened_at": "2020-10-19 14:18:20",
"business_duration": "",
"group_list": "",
"work_end": "",
"caller_id": {
"link": "https://example.service-now.com/api/now/table/sys_user/ID",
"value": "ID"
},
"reopened_time": "",
"resolved_at": "",
"approval_set": "",
"subcategory": "",
"work_notes": "",
"short_description": "TEST",
"close_code": "",
"correlation_display": "",
"delivery_task": "",
"work_start": "",
"assignment_group": "",
"additional_assignee_list": "",
"business_stc": "",
"description": "",
"calendar_duration": "",
"close_notes": "",
"notify": "1",
"service_offering": "",
"sys_class_name": "incident",
"closed_by": "",
"follow_up": "",
"parent_incident": "",
"sys_id": "SYS_ID",
"contact_type": "",
"reopened_by": "",
"incident_state": "1",
"urgency": "3",
"problem_id": "",
"company": {
"link": "https://example.service-now.com/api/now/table/core_company/ID",
"value": "ID"
},
"reassignment_count": "0",
"activity_due": "",
"assigned_to": "",
"severity": "3",
"comments": "",
"approval": "not requested",
"sla_due": "",
"comments_and_work_notes": "",
"due_date": "",
"sys_mod_count": "0",
"reopen_count": "0",
"sys_tags": "",
"escalation": "0",
"upon_approval": "proceed",
"correlation_id": "",
"location": "",
"category": "inquiry"
}
]
}
הודעות פלט
הפעולה List Records Related To User יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "List Records Related To User". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאות הסקריפט כשמשתמשים בפעולה List Records Related To User:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
פינג
משתמשים בפעולה פינג כדי לבדוק את הקישוריות ל-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
אין.
פלט של פעולות
הפעולה פינג מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה פינג:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
עריכת האירוע
משתמשים בפעולה Update Incident כדי לעדכן את פרטי האירוע.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Update Incident דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Incident Number |
חובה. המזהה הייחודי של האירוע ב-ServiceNow שרוצים לעדכן, בפורמט |
Short Description |
זה שינוי אופציונלי. תיאור קצר של האירוע. |
Impact |
זה שינוי אופציונלי. רמת ההשפעה של האירוע. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Urgency |
זה שינוי אופציונלי. רמת הדחיפות של האירוע. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Category |
זה שינוי אופציונלי. קטגוריה לאירוע. |
Assignment Group ID |
זה שינוי אופציונלי. השם המלא של הקבוצה שאליה רוצים להקצות את האירוע. |
Assigned User ID |
זה שינוי אופציונלי. השם המלא של המשתמש שרוצים להקצות לו את האירוע. |
Description |
זה שינוי אופציונלי. תיאור האירוע. |
Incident State |
זה שינוי אופציונלי. הערך הבסיסי של ServiceNow לסטטוס האירוע (לדוגמה, |
Custom Fields |
זה שינוי אופציונלי. מחרוזת בפורמט JSON שמכילה את שמות השדות והערכים התואמים שלהם לעדכון (לדוגמה, אפשר להשתמש בפרמטר הזה כדי לשנות שדות שלא הוגדרו במפורש כקלט של פעולה. |
פלט של פעולות
הפעולה Update Incident מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Update Incident:
{
"sys_tags": " ",
"user_input": " ",
"calendar_stc": "2012",
"subcategory": " ",
"watch_list": " ",
"follow_up": " ",
"made_sla": "true",
"sys_created_by": "admin",
"sla_due": " ",
"number": "INC0010041",
"group_list": " ",
"reassignment_count": "0",
"assigned_to": " ",
"sys_mod_count": "10",
"notify": "1",
"resolved_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"upon_reject": "cancel",
"additional_assignee_list": " ",
"category": "inquiry",
"closed_at": "2020-07-10 12:53:06",
"parent_incident": " ",
"cmdb_ci": " ",
"contact_type": " ",
"impact": "1",
"rfc": " ",
"expected_start": " ",
"knowledge": "false",
"sys_updated_by": "admin",
"caused_by": " ",
"comments": " ",
"closed_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"priority": "1",
"state": "7",
"sys_id": "SYS_ID",
"opened_at": "2020-07-10 12:18:04",
"child_incidents": "0",
"work_notes": " ",
"delivery_task": " ",
"short_description": "sdf",
"comments_and_work_notes": " ",
"time_worked": " ",
"upon_approval": "proceed",
"company": " ",
"business_stc": "0",
"correlation_display": " ",
"sys_class_name": "incident",
"delivery_plan": " ",
"escalation": "0",
"description": " ",
"parent": " ",
"close_notes": "Closed by Caller",
"business_duration": "1970-01-01 00:00:00",
"problem_id": " ",
"sys_updated_on": "2020-07-10 13:13:57",
"approval_history": " ",
"approval_set": " ",
"business_service": " ",
"reopened_by": " ",
"calendar_duration": "1970-01-01 00:35:02",
"caller_id": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"active": "false",
"approval": "not requested",
"service_offering": " ",
"sys_domain_path": "/",
"hold_reason": " ",
"activity_due": "2020-07-10 14:33:28",
"severity": "3",
"incident_state": "7",
"resolved_at": "2020-07-10 12:53:06",
"location": " ",
"due_date": " ",
"work_start": " ",
"work_end": " ",
"work_notes_list": " ",
"sys_created_on": "2020-07-10 12:18:04",
"correlation_id": " ",
"contract": " ",
"reopened_time": " ",
"opened_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"close_code": "Closed/Resolved by Caller",
"assignment_group": " ",
"sys_domain": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
"value": "global"
},
"order": " ",
"urgency": "1",
"reopen_count": "0"
}
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Update Incident:
| שם תוצאת הסקריפט | ערך |
|---|---|
incident_number |
INCIDENT_NUMBER |
עדכון הרשומה
משתמשים בפעולה Update Record כדי לשנות רשומות קיימות ששייכות לטבלאות שונות ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה Update Record דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
זה שינוי אופציונלי. שם הטבלה ב-ServiceNow שמכילה את הרשומה שרוצים לעדכן (למשל |
Object Json Data |
חובה. אובייקט JSON שמכיל את צמדי השדה-ערך שצריך להחיל על הרשומה (כמו |
Record Sys ID |
חובה. מזהה המערכת ( |
פלט של פעולות
הפעולה עדכון רשומה מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה ב-JSON שמתקבל כשמשתמשים בפעולה Update Record:
{
"sys_tags": " ",
"user_input": " ",
"calendar_stc": " ",
"subcategory": " ",
"watch_list": " ",
"follow_up": " ",
"made_sla": "true",
"sys_created_by": "admin",
"sla_due": " ",
"number": "INC0010021",
"group_list": " ",
"reassignment_count": "0",
"assigned_to": " ",
"sys_mod_count": "0",
"notify": "1",
"resolved_by": " ",
"upon_reject": "cancel",
"additional_assignee_list": " ",
"category": "inquiry",
"closed_at": " ",
"parent_incident": " ",
"cmdb_ci": " ",
"contact_type": " ",
"impact": "3",
"rfc": " ",
"expected_start": " ",
"knowledge": "false",
"sys_updated_by": "admin",
"caused_by": " ",
"comments": " ",
"closed_by": " ",
"priority": "5",
"state": "1",
"sys_id": "SYS_ID",
"opened_at": "2020-07-10 08:24:34",
"child_incidents": "0",
"work_notes": " ",
"delivery_task": " ",
"short_description": " ",
"comments_and_work_notes": " ",
"time_worked": " ",
"upon_approval": "proceed",
"company": " ",
"business_stc": " ",
"correlation_display": " ",
"sys_class_name": "incident",
"delivery_plan": " ",
"escalation": "0",
"description": " ",
"parent": " ",
"close_notes": " ",
"business_duration": " ",
"problem_id": " ",
"sys_updated_on": "2020-07-10 08:24:34",
"approval_history": " ",
"approval_set": " ",
"business_service": " ",
"reopened_by": " ",
"calendar_duration": " ",
"caller_id": " ",
"active": "true",
"approval": "not requested",
"service_offering": " ",
"sys_domain_path": "/",
"hold_reason": " ",
"activity_due": " ",
"severity": "3",
"incident_state": "1",
"resolved_at": " ",
"location": " ",
"due_date": " ",
"work_start": " ",
"work_end": " ",
"work_notes_list": " ",
"sys_created_on": "2020-07-10 08:24:34",
"correlation_id": " ",
"contract": " ",
"reopened_time": " ",
"opened_by": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
"value": "ID"
},
"close_code": " ",
"assignment_group": " ",
"sys_domain": {
"link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
"value": "global"
},
"order": " ",
"urgency": "3",
"reopen_count": "0"
}
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Update Record:
| שם תוצאת הסקריפט | ערך |
|---|---|
record_sys_id |
RECORD_SYS_ID
|
המתנה לתגובות
משתמשים בפעולה המתנה לתגובות כדי להשהות את הפעלת הפלייבוק עד שנוספת תגובה או הערת עבודה לרשומה ספציפית בטבלה ב-ServiceNow.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה המתנה לתגובות דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
חובה. שם הטבלה ב-ServiceNow שמכילה את הרשומה שממנה ממתינים לתגובות (למשל |
Record Sys ID |
חובה. מזהה המערכת ( |
Type |
חובה. סוג התגובות או ההערות שהפעולה צריכה להמתין להן. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Wait Mode |
חובה. התנאי שקובע מתי הפעולה מפסיקה להמתין וממשיכה. הערכים האפשריים הם:
ערך ברירת המחדל הוא |
Text |
זה שינוי אופציונלי. מחרוזת הטקסט הספציפית שהפעולה ממתינה לה בתגובה חדשה או בהערה חדשה על העבודה. הפרמטר הזה משמש רק כשבוחרים באפשרות |
פלט של פעולות
הפעולה המתנה לתגובות מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | יש גישה |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת JSON
הדוגמה הבאה מראה את פלט התוצאה בפורמט JSON שמתקבל כשמשתמשים בפעולה המתנה לתגובות:
{
"sys_id": "SYS_ID",
"sys_created_on": "2021-09-03 10:29:48",
"name": "incident",
"element_id": "552c48888c033300964f4932b03eb092",
"sys_tags": "",
"value": "test",
"sys_created_by": "admin",
"element": "comments"
}
הודעות פלט
הפעולה המתנה לתגובות יכולה להחזיר את הודעות הפלט הבאות:
| הודעת פלט | תיאור ההודעה |
|---|---|
|
הפעולה בוצעה בהצלחה. |
Error executing action "Wait For Comments". Reason:
ERROR_REASON |
הפעולה נכשלה. בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה. |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה המתנה לתגובות:
| שם תוצאת הסקריפט | ערך |
|---|---|
is_success |
true או false |
המתנה לעדכון השדה
משתמשים בפעולה Wait for Field Update כדי להשהות את הפעלת הפלייבוק עד ששדה ספציפי ברשומת נתונים של ServiceNow מתעדכן לאחד מהערכים הצפויים.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה המתנה לעדכון שדה דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Table Name |
חובה. השם של הטבלה ב-ServiceNow שמכילה את הרשומה למעקב (למשל |
Record Sys ID |
חובה. מזהה המערכת ( |
Field - Column Name |
חובה. שם העמודה (השדה) שהפעולה עוקבת אחרי השינויים בה. |
Field - Values |
חובה. רשימה מופרדת בפסיקים של ערכים שאם הם נמצאים בשדה המנוטר, הפעולה מפסיקה להמתין וממשיכה (למשל |
פלט של פעולות
הפעולה המתנה לעדכון שדה מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה המתנה לעדכון שדה:
| שם תוצאת הסקריפט | ערך |
|---|---|
updated_field |
UPDATED_FIELD |
המתנה לעדכון סטטוס
משתמשים בפעולה Wait for Status Update כדי להשהות את הפעלת הפלייבוק עד שסטטוס האירוע הספציפי ב-ServiceNow מתעדכן לאחד מהערכים הצפויים.
הפעולה הזו לא פועלת על ישויות של Google SecOps.
קלט של הפעולה
הפעולה המתנה לעדכון סטטוס דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Incident Number |
חובה. המזהה הייחודי של אירוע ServiceNow למעקב, בפורמט |
Statuses |
חובה. רשימה מופרדת בפסיקים של סטטוסים (מצבים) של אירועים, שאם הם מתרחשים, הפעולה מפסיקה להמתין וממשיכה (למשל |
פלט של פעולות
הפעולה המתנה לעדכון סטטוס מספקת את הפלטים הבאים:
| סוג הפלט של הפעולה | זמינות |
|---|---|
| חיבור הקייס לקיר | לא זמין |
| קישור לקיר של התיק | לא זמין |
| שולחן קיר עם ארונית | לא זמין |
| טבלת העשרה | לא זמין |
| תוצאת JSON | לא זמין |
| הודעות פלט | יש גישה |
| תוצאת הסקריפט | יש גישה |
תוצאת הסקריפט
בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה המתנה לעדכון סטטוס:
| שם תוצאת הסקריפט | ערך |
|---|---|
new_status |
STATUS |
מחברים
איך מגדירים מחברים ב-Google SecOps?
מחבר ServiceNow
משתמשים ב-ServiceNow Connector כדי לאחזר אירועים מ-ServiceNow.
עבודה עם רשימת השאילתות הדינמיות
ב-ServiceNow Connector, הרשימה הדינמית משנה את ה-sysparm_query שבו המחבר משתמש כדי לשלוח שאילתות ל-ServiceNow. כך אפשר לסנן רשומות לפי כל שדה שנתמך בסוג הרשומה.
כדי להגדיר מסנן, מגדירים כל פריט ברשימה הדינמית כך שיכיל צמד אחד של שדה וערך בפורמט הבא:
FIELD_NAME=VALUE.
לדוגמה: category=security.
כשהאפשרות Use whitelist as a blacklist מופעלת, המחבר הופך את הלוגיקה של השאילתה, וגורם לרשימה הדינמית לפעול כרשימת חסימה במקום כמסנן.
כניסות קלט של מחברים
כדי להשתמש ב-ServiceNow Connector צריך להגדיר את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
Product Field Name |
חובה. שם השדה שבו מאוחסן שם המוצר. שם המוצר משפיע בעיקר על המיפוי. כדי לייעל ולשפר את תהליך המיפוי של המחבר, ערך ברירת המחדל הופך לערך חלופי שאליו מתייחס הקוד. כל קלט לא חוקי בפרמטר הזה יוחלף בערך חלופי כברירת מחדל. ערך ברירת המחדל הוא |
Event Field Name |
חובה. שם השדה שקובע את שם האירוע (סוג משנה). ערך ברירת המחדל הוא |
Rule Generator |
זה שינוי אופציונלי. שם השדה שהערך שלו מגדיר את השאילתה או את קבוצת הכללים הספציפיים שצריך להחיל במהלך אחזור הרשומות. |
Api Root |
חובה. שורש ה-API של המכונה של ServiceNow. ערך ברירת המחדל הוא |
Username |
חובה. שם המשתמש של חשבון ServiceNow. |
Password |
חובה. הסיסמה של חשבון ServiceNow. |
Verify SSL |
זה שינוי אופציונלי. אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow. מופעלת כברירת מחדל. |
Use sys_domain Environment |
זה שינוי אופציונלי. אם בוחרים באפשרות הזו, המחבר משתמש בשדה אם השדה הזה חסר או לא זמין, המחבר משתמש כברירת מחדל בערך שצוין בפרמטר |
Days Backwards |
זה שינוי אופציונלי. מספר הימים אחורה מהשעה הנוכחית לאחזור רשומות. הפרמטר הזה משמש להפעלה הראשונית של המחבר, או כערך חלופי אם פג התוקף של חותמת הזמן הקודמת של המחבר. ערך ברירת המחדל הוא |
Disable Overflow |
זה שינוי אופציונלי. אם בוחרים באפשרות הזו, המחבר מתעלם ממנגנון ההצפה של Google SecOps. |
Max Incidents Per Cycle |
זה שינוי אופציונלי. מספר האירועים המקסימלי שאפשר לאחזר בכל איטרציה של המחבר. ערך ברירת המחדל הוא |
Environments Whitelist |
זה שינוי אופציונלי. רשימה מופרדת בפסיקים של סביבות (דומיינים) שהמחבר יטמיע ב-Google SecOps, למשל |
Use whitelist as a blacklist |
זה שינוי אופציונלי. אם בוחרים באפשרות הזו, המחבר משתמש ברשימה הדינמית כרשימת חסימה. מושבתת כברירת מחדל. |
PythonProcessTimeout |
חובה. מגבלת הזמן הקצוב לתפוגה, בשניות, של תהליך Python שמריץ את הסקריפט הנוכחי. ערך ברירת המחדל הוא |
Incident Table |
זה שינוי אופציונלי. שם הטבלה או הנתיב ב-API שמשמשים לפעולות שקשורות לאירועים ולאחזור רשומות. כברירת מחדל, השילוב משתמש בנתיב |
Client ID |
זה שינוי אופציונלי. מזהה הלקוח לשילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות פרטי הכניסה של הלקוח. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם מגדירים גם את טוקן הרענון וגם את פרטי הכניסה של הלקוח, השילוב משתמש בטוקן הרענון לצורך אימות. |
Client Secret |
זה שינוי אופציונלי. סוד הלקוח לשילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות פרטי הכניסה של הלקוח. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם מגדירים גם את טוקן הרענון וגם את פרטי הכניסה של הלקוח, השילוב משתמש בטוקן הרענון לצורך אימות. |
Refresh Token |
זה שינוי אופציונלי. טוקן הרענון של השילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות טוקן רענון. התוקף של טוקן הרענון שהוגדר פג כל 90 יום. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם מגדירים גם את טוקן הרענון וגם את פרטי הכניסה של הלקוח, השילוב משתמש בטוקן הרענון לצורך אימות. |
Assignment Group |
זה שינוי אופציונלי. שם קבוצת המטלות שהמחבר צריך להטמיע את הרשומות שלה. |
Use Oauth Authentication |
זה שינוי אופציונלי. אם האפשרות הזו נבחרת, השילוב משתמש ב-OAuth 2.0 לאימות. כדי לבצע אימות באמצעות OAuth 2.0, צריך להגדיר את פרטי הכניסה של הלקוח ( מושבתת כברירת מחדל. |
Server Time Zone |
זה שינוי אופציונלי. אזור הזמן שמוגדר בשרת ServiceNow (למשל ערך ברירת המחדל הוא |
Table Name |
זה שינוי אופציונלי. שם הטבלה שממנה רוצים לאחזר רשומות, למשל |
Event Name |
זה שינוי אופציונלי. שם האירוע ב-Google SecOps שנוצר כשמתבצעת הטמעה של רשומה (למשל |
Proxy Server Address |
זה שינוי אופציונלי. הכתובת של שרת ה-Proxy שבו רוצים להשתמש. |
Proxy Username |
זה שינוי אופציונלי. שם המשתמש של שרת ה-proxy לאימות. |
Proxy Password |
זה שינוי אופציונלי. הסיסמה לאימות מול שרת ה-proxy. |
Get User Information |
זה שינוי אופציונלי. אם בוחרים באפשרות הזו, המחבר מאחזר גם את המידע על המשתמשים שקשורים לאירוע. מושבתת כברירת מחדל. |
תעסוקה
מידע נוסף על משימות זמין במאמרים הגדרת משימה חדשה ותזמון מתקדם.
ServiceNow – סנכרון אירועים סגורים
משתמשים במשימה ServiceNow - Sync Closed Incidents כדי לסנכרן אירועים סגורים ב-ServiceNow עם ההתראות והאירועים התואמים ב-Google SecOps.
המשימה הזו מעבדת אירועים ב-ServiceNow שנוספו כהתראות וכבקשות תמיכה שמכילות את התג ServiceNow וערך הקשר TICKET_ID עם מספר האירוע.
פרמטרים של משימות
למשימה ServiceNow - Sync Closed Incidents נדרשים הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
API Root |
חובה שורש ה-API של המכונה של ServiceNow. ברירת המחדל היא |
Username |
חובה שם המשתמש של המכונה ב-ServiceNow. |
Password |
חובה הסיסמה של המכונה ב-ServiceNow. |
Verify SSL |
אופציונלי אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow. מופעלת כברירת מחדל. |
Client ID |
אופציונלי מזהה הלקוח לשילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות פרטי הכניסה של הלקוח. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם גם טוקן הרענון וגם פרטי הכניסה של הלקוח מוגדרים, השילוב משתמש בטוקן הרענון לצורך אימות. |
Client Secret |
אופציונלי סוד הלקוח לשילוב של ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות פרטי הכניסה של הלקוח. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם גם טוקן הרענון וגם פרטי הכניסה של הלקוח מוגדרים, השילוב משתמש בטוקן הרענון לצורך אימות. |
Refresh Token |
אופציונלי טוקן הרענון של השילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות טוקן רענון. התוקף של טוקן הרענון שהוגדר פג כל 90 יום. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם גם טוקן הרענון וגם פרטי הכניסה של הלקוח מוגדרים, השילוב משתמש בטוקן הרענון לצורך אימות. |
Use OAuth Authentication |
אופציונלי אם האפשרות הזו נבחרת, השילוב משתמש ב-OAuth 2.0 לאימות. כדי לבצע אימות באמצעות OAuth 2.0, צריך להגדיר את פרטי הכניסה של הלקוח ( |
Max Hours Backwards |
אופציונלי מספר השעות אחורה מהשעה הנוכחית שבהן המערכת תחפש אירועים סגורים ותסנכרן אותם. ברירת המחדל היא |
Table Name |
חובה השם של טבלת מסד הנתונים שבה מחפשים אירועים סגורים (לדוגמה, |
ServiceNow – סנכרון אירועים
משתמשים במשימה ServiceNow - Sync Incidents כדי לסנכרן שדות וקבצים מצורפים של אירועים ב-ServiceNow עם בקשות תמיכה והתראות קשורות ב-Google SecOps.
כדי להריץ את המשימה הזו, למשתמש השילוב של ServiceNow צריך להיות התפקיד ITIL (itil). מידע נוסף זמין במאמר Base system roles במסמכי התיעוד של ServiceNow.
דרישות התפקיד
כדי שהמשימה תפעל כמו שצריך, ודאו שההגדרות הבאות מוגדרות ב-Google SecOps, בהתאם לפרמטר Sync Level:
- תג: הפנייה חייבת לכלול את התג
ServiceNow Incident Sync. - ערך ההקשר: לבקשת התמיכה או להתראה צריך להיות מפתח הקשר
TICKET_IDשמכיל רשימה מופרדת בפסיקים של מספרי אירועים ב-ServiceNow (לדוגמה,INC0000050,INC0000051). מגדירים את ערך ההקשרTICKET_IDבאמצעות הפעולה Set Scope Context Value מהשילוב של Siemplify Utilities.
פרמטרים של משימות
למשימה ServiceNow - Sync Incidents נדרשים הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
API Root |
חובה שורש ה-API של המכונה של ServiceNow. ברירת המחדל היא |
Username |
אופציונלי שם המשתמש של המכונה ב-ServiceNow. הפרמטר הזה נדרש כשמבצעים אימות באמצעות סיסמה בסיסית. |
Password |
אופציונלי הסיסמה של המכונה ב-ServiceNow. הפרמטר הזה נדרש כשמבצעים אימות באמצעות סיסמה בסיסית. |
Sync Level |
חובה הרמה שבה המשימה מסנכרנת נתונים. ערכים אפשריים: |
Max Hours Backwards |
חובה מספר השעות המקסימלי אחורה מהשעה הנוכחית לחיפוש פניות לסנכרון. ברירת המחדל היא |
Verify SSL |
אופציונלי אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow. מופעלת כברירת מחדל. |
Use OAuth Authentication |
אופציונלי אם בוחרים באפשרות הזו, המשימה משתמשת באימות OAuth במקום באימות בסיסי. כשבוחרים באפשרות הזו, הפרמטרים |
Client ID |
אופציונלי מזהה הלקוח של אפליקציית ServiceNow. חובה אם נבחרה האפשרות |
Client Secret |
אופציונלי סוד הלקוח של אפליקציית ServiceNow. חובה אם נבחרה האפשרות |
Refresh Token |
אופציונלי טוקן הרענון של אפליקציית ServiceNow. חובה אם נבחרה האפשרות |
סנכרון הערות ברשומות של טבלאות
כדי לסנכרן תגובות בין רשומות בטבלה של ServiceNow לבין תיקים ב-Google SecOps, משתמשים במשימה Sync Table Record Comments.
פרמטרים של משימות
למשימה Sync Table Record Comments נדרשים הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
API Root |
חובה שורש ה-API של המכונה של ServiceNow. ברירת המחדל היא |
Username |
חובה שם המשתמש של המכונה ב-ServiceNow. |
Password |
חובה הסיסמה של המכונה ב-ServiceNow. |
Verify SSL |
אופציונלי אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow. מופעלת כברירת מחדל. |
Client ID |
אופציונלי מזהה הלקוח לשילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות פרטי הכניסה של הלקוח. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם גם טוקן הרענון וגם פרטי הכניסה של הלקוח מוגדרים, השילוב משתמש בטוקן הרענון לצורך אימות. |
Client Secret |
אופציונלי סוד הלקוח לשילוב של ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות פרטי הכניסה של הלקוח. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם גם טוקן הרענון וגם פרטי הכניסה של הלקוח מוגדרים, השילוב משתמש בטוקן הרענון לצורך אימות. |
Refresh Token |
אופציונלי טוקן הרענון של השילוב עם ServiceNow, שנדרש לאימות OAuth 2.0 באמצעות טוקן רענון. התוקף של טוקן הרענון שהוגדר פג כל 90 יום. אתם יכולים לבצע אימות באמצעות טוקן הרענון או פרטי הכניסה של הלקוח. אם גם טוקן הרענון וגם פרטי הכניסה של הלקוח מוגדרים, השילוב משתמש בטוקן הרענון לצורך אימות. |
Use OAuth Authentication |
אופציונלי אם האפשרות הזו נבחרת, השילוב משתמש ב-OAuth 2.0 לאימות. כדי לבצע אימות באמצעות OAuth 2.0, צריך להגדיר את פרטי הכניסה של הלקוח ( |
Table Name |
חובה שם הטבלה ב-ServiceNow שבה מחפשים רשומות כדי לסנכרן מהן תגובות (לדוגמה, |
סנכרון הערות של רשומות בטבלה לפי תג
כדי לסנכרן את ההערות בין הרשומות בטבלה של ServiceNow לבין האירועים ב-Google SecOps, משתמשים במשימה Sync Table Record Comments By Tag.
דרישות התפקיד
כדי שהמשימה תפעל כמו שצריך, הבקשה ב-Google SecOps חייבת לכלול את שני התגים הבאים:
ServiceNow TABLE_NAME(כאשר<var class="readonly">TABLE_NAME</var>הוא השם של הטבלה ב-ServiceNow, למשלincident).-
ServiceNow TicketId: TICKET_ID(כאשר<var class="readonly">TICKET_ID</var>הוא המזהה או המספר של הרשומה המתאימה במערכת).
פרמטרים של משימות
המשימה Sync Table Record Comments By Tag דורשת את הפרמטרים הבאים:
| פרמטר | תיאור |
|---|---|
API Root |
חובה שורש ה-API של המכונה של ServiceNow. ברירת המחדל היא |
Username |
חובה שם המשתמש של המכונה ב-ServiceNow. |
Password |
Mandatoryהסיסמה של המכונה ב-ServiceNow. |
Table Name |
חובה שם הטבלה במסד הנתונים שרוצים לחפש בה, למשל |
Verify SSL |
אופציונלי אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow. מופעלת כברירת מחדל. |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.