שילוב של 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.

  1. יצירת תפקיד בהתאמה אישית: עוברים אל Roles > New ויוצרים תפקיד חדש שמיועד לטיפול בגישה לתגובות ב-API.
  2. יצירת כלל חדש של רשימת בקרת גישה (ACL): כדי לעקוב אחרי תגובות והערות עבודה, צריך לתת לאפליקציה גישת קריאה לטבלה sys_journal_field. עוברים אל בקרות גישה > חדש. כדי ליצור את הכלל הזה, צריך להיכנס לחשבון עם הרשאות מתקדמות.
  3. מגדירים את הפרמטרים של ה-ACL:

    • מגדירים את Type לערך record.
    • מגדירים את Operation לערך read.
    • בשדות Name, בוחרים באפשרות Journal Entry sys_journal_field בתפריט הנפתח הראשון, ובאפשרות -- None -- בתפריט הנפתח השני.
    • עוברים לרשימה Requires role בתחתית הטופס ומוסיפים את תפקיד התגובה החדש בהתאמה אישית שיצרתם. לוחצים על שליחה.
  4. הקצאת תפקידים לחשבון השילוב: עוברים אל Users, פותחים את חשבון השילוב הייעודי ומקצים את התפקידים הבאים:

    • התפקיד בהתאמה אישית שיצרתם כדי לקרוא תגובות.
    • ‫sn_incident_write: נדרש לאינטראקציה בסיסית, כמו הפעולות Get Incident ו-Update Incident.
    • ‫itil: נדרש לפעולות CMDB ולפונקציות חיפוש קשורות של ניהול הגדרות נכסים.

אפשרויות להגדרת אימות

השילוב של ServiceNow תומך בשלוש שיטות אימות שונות. בוחרים באחת מאפשרויות ההגדרה הבאות, בהתאם לדרישות האבטחה של הארגון.

אפשרות 1: תהליך פרטי הכניסה של לקוח OAuth 2.0 (מומלץ)

בשיטה הזו משתמשים בהענקת פרטי כניסה של לקוח OAuth 2.0 לצד התחברות זמנית כמשתמש אחר כדי להגביל באופן בטוח את הגישה לנתונים בלי לחשוף לפלטפורמה סיסמה סטטית של משתמש.

שלב 1: יוצרים נקודת קצה (endpoint) של OAuth ב-ServiceNow

  1. מחפשים את Application Registries בתפריט הניווט של ServiceNow ולוחצים על New.
  2. בוחרים באפשרות New Inbound Integration Experience (חוויית שילוב חדשה של הודעות נכנסות).
  3. ברשימת סוגי החיבורים, בוחרים באפשרות OAuth - Client credentials grant (OAuth – הענקת פרטי כניסה של לקוח).
  4. בשדה Name, נותנים שם תיאורי להגדרת נקודת הקצה.
  5. מזינים את השם או המזהה של ספק ה-OAuth שנדרש כדי ליצור את ההקשר של פרופיל הזהות.
  6. בשדה OAuth application user, בוחרים את חשבון המשתמש הייעודי ב-ServiceNow שישמש להתחזות ולכל הפעילויות האוטומטיות של ה-API.
  7. לוחצים על שליחה או על שמירה.
  8. פותחים מחדש את רשומת הרישום החדשה שנוצרה כדי להעתיק ולאבטח את מזהה הלקוח ואת סוד הלקוח שנוצרו.

שלב 2: הגדרה ב-Google SecOps

  1. ב-Google SecOps, עוברים אל Automation > Integrations Setup ופותחים את חלון ההגדרות של ServiceNow.
  2. מזינים את שורש ה-API (מחליפים את דומיין ברירת המחדל של הפלייסהולדר בכתובת ה-URL של המכונה של ServiceNow).
  3. מזינים את מזהה הלקוח ואת סוד הלקוח שנוצרו בשלב 1.
  4. מוודאים שהשדות Username,‏ Password ו-Refresh Token ריקים לגמרי.
  5. מסמנים את תיבת הסימון Use Oauth Authentication.
  6. לוחצים על בדיקה כדי לאמת את הפרמטרים באמצעות בדיקת פינג לקישוריות. אם הבדיקה הצליחה, לוחצים על Save.

אפשרות 2: אימות בסיסי

בשיטה הזו, האימות של פרטי הכניסה מתבצע באופן ישיר. קל להגדיר אותו, אבל יכול להיות שהוא יהיה מוגבל אם בארגון שלכם נאכף אימות רב-שלבי (MFA) או נחסמות כותרות אימות בסיסיות.

  1. ב-ServiceNow, מוודאים שלמשתמש השילוב יש שם משתמש וסיסמה מקומיים.
  2. כשמגדירים את השילוב ב-Google SecOps, צריך לספק את Api Root (מחליפים את דומיין ברירת המחדל של ה-placeholder בכתובת ה-URL של המכונה של ServiceNow), את Username ואת Password.
  3. משאירים את השדות שקשורים ל-OAuth ריקים ומוודאים שהאפשרות Use Oauth Authentication מושבתת (תיבת הסימון לא מסומנת).
  4. לוחצים על Test כדי לאמת את הפרמטרים של החיבור. אם הבדיקה הצליחה, לוחצים על Save.

אפשרות 3: תהליך של טוקן רענון

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

  1. משלימים את שלב 1 במכונה של ServiceNow כדי ליצור מזהה לקוח וסוד לקוח.
  2. מבצעים את השלבים בקטע יצירת טוקן רענון כדי לאחזר מחרוזת תקינה של טוקן הרשאה.
  3. ב-Google SecOps, פותחים את חלון ההגדרות של מופע השילוב של ServiceNow.
  4. ממלאים את הפרמטרים במלואם באמצעות פרטי הכניסה שהגדרתם:
    • שורש ה-API (החלפת דומיין ברירת המחדל של הפלייסהולדר בכתובת ה-URL של המכונה של ServiceNow).
    • שם משתמש
    • סיסמה
    • מזהה לקוח
    • סוד לקוח
  5. מסמנים את התיבה Use Oauth Authentication.
  6. מדביקים את מחרוזת הטוקן שקיבלתם מתהליך העבודה בקטע יצירת טוקן רענון בשדה Refresh Token.
  7. לוחצים על Test כדי לאמת את הפרמטרים של החיבור. אם הבדיקה הצליחה, לוחצים על Save.

יצירת טוקן רענון (Google SecOps)

כדי ליצור את טוקן הרענון, צריך להגדיר באופן זמני את השילוב כך שיפעיל פעולת עזר.

  1. ב-Google SecOps, עוברים אל Automation > Integrations Setup.
  2. מוודאים שהתיבה Use Oauth Authentication לא מסומנת בשלב ההגדרה הראשוני הזה.
  3. מגדירים מופע זמני של שילוב ServiceNow באמצעות Api Root, Username,‏ Password,‏ Client ID ו-Client Secret, ולוחצים על Save.
  4. מדמים פנייה או פותחים פנייה קיימת.
  5. מריצים את הפעולה Get Oauth Token של ServiceNow באופן ידני בבקשת התמיכה.
  6. מעתיקים את הערך של refresh_token מתוצאת ה-JSON של הפעולה, כדי להשתמש בו בשדה טוקן רענון כשמגדירים את מופע האינטגרציה הסופי.

פרמטרים של שילוב

כדי לשלב את ServiceNow, צריך להגדיר את הפרמטרים הבאים:

פרמטר תיאור
Api Root

חובה.

שורש ה-API של המכונה של ServiceNow.

ערך ברירת המחדל הוא https://INSTANCE.service-now.com/api/now/v1/.

Username

חובה.

שם המשתמש של חשבון ServiceNow.

Password

חובה.

הסיסמה של חשבון ServiceNow.

Incident Table

זה שינוי אופציונלי.

שם הטבלה או הנתיב ב-API שמשמשים לפעולות שקשורות לאירועים ולאחזור רשומות.

כברירת מחדל, השילוב משתמש בנתיב table/incident.

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, צריך להגדיר את פרטי הכניסה של הלקוח (Client ID ו-Client Secret) או את Refresh Token.

מושבתת כברירת מחדל.

איך מגדירים שילובים ב-Google SecOps

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

פעולות

מידע נוסף על פעולות זמין במאמרים מענה לפעולות בהמתנה משולחן העבודה והפעלה ידנית של פעולה בבקשת התמיכה.

צירוף קובץ

כדי להוסיף קבצים מצורפים לרשומה בטבלה ב-ServiceNow, משתמשים בפעולה Add Attachment.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה הוספת קובץ מצורף דורשת את הפרמטרים הבאים:

פרמטר תיאור
Table Name

חובה.

שם הטבלה שמכילה את הרשומה שאליה מוסיפים את הקובץ המצורף.

Record Sys ID

חובה.

מזהה המערכת (sys_id) של הרשומה שבה נוסף הקובץ המצורף.

File Path

חובה.

רשימה מופרדת בפסיקים של נתיבים מוחלטים לקבצים שרוצים לצרף.

Mode

זה שינוי אופציונלי.

ההתנהגות של הפעולה כשכבר קיים קובץ עם אותו שם ברשומה.

הערכים האפשריים הם:

  • ‫Add New Attachment: הפעולה מוסיפה את הקובץ כקובץ מצורף חדש ונפרד. מותר להעלות קבצים עם אותו שם.
  • ‫Overwrite Existing Attachment: הפעולה מחליפה את הקובץ המצורף הקיים עם אותו שם.

ערך ברירת המחדל הוא Add New Attachment.

פלט של פעולות

הפעולה הוספת קובץ מצורף מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית לא זמין
טבלת העשרה לא זמין
תוצאת 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"
    }
}
הודעות פלט

הפעולה הוספת קובץ מצורף יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully added the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

Action wasn't able to add the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

No attachments were added to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

הפעולה בוצעה בהצלחה.
Error executing action "Add Attachment". Reason: ERROR_REASON

הפעולה נכשלה.

בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה הוספת קובץ מצורף:

שם תוצאת הסקריפט ערך
is_success true או false

הוסף הערה

משתמשים בפעולה הוספת תגובה כדי להוסיף תגובה לאירוע ב-ServiceNow.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה הוספת תגובה דורשת את הפרמטרים הבאים:

פרמטר תיאור
Incident Number

חובה.

מספר האירוע שאליו רוצים להוסיף את ההערה, בפורמט INCINCIDENT_NUMBER.

Comment

חובה.

התגובה שרוצים להוסיף לאירוע.

פלט של פעולות

הפעולה הוספת תגובה מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית לא זמין
טבלת העשרה לא זמין
תוצאת JSON לא זמין
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה הוספת תגובה:

שם תוצאת הסקריפט ערך
is_success true או false

הוספת תגובה והמתנה לתשובה

משתמשים בפעולה Add Comment and Wait for Reply כדי להוסיף תגובה לאירוע ב-ServiceNow, ואז משהים את הפעלת הפלייבוק עד שנוספת תגובה חדשה או תשובה לאירוע הזה. הפלט של הפעולה הוא התוכן של התגובה החדשה.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה הוספת הערה והמתנה לתשובה דורשת את הפרמטרים הבאים:

פרמטר תיאור
Incident Number

חובה.

מספר האירוע שאליו רוצים להוסיף את ההערה, בפורמט INCINCIDENT_NUMBER.

Comment

חובה.

התגובה שרוצים להוסיף לאירוע.

פלט של פעולות

הפעולה הוספת תגובה והמתנה לתשובה מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית לא זמין
טבלת העשרה לא זמין
תוצאת JSON לא זמין
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט התוצאה של הסקריפט כשמשתמשים בפעולה הוספת תגובה והמתנה לתשובה:

שם תוצאת הסקריפט ערך
new_comment

הוספת הערה לרשומה

משתמשים בפעולה Add Comment To Record כדי להוסיף תגובה או הערת עבודה לרשומה ספציפית בטבלה ב-ServiceNow.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה הוספת הערה לרשומה דורשת את הפרמטרים הבאים:

פרמטר תיאור
Table Name

חובה.

שם הטבלה שרוצים להוסיף לה את התגובה או ההערה.

Type

חובה.

סוג התגובה או ההערה שרוצים להוסיף.

הערכים האפשריים הם:

  • Comment
  • Work Note

ערך ברירת המחדל הוא Comment.

Record Sys ID

חובה.

מזהה המערכת (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

חובה.

מספר האירוע הראשי, בפורמט INCINCIDENT_NUMBER (לדוגמה, INC0000051).

הפעולה מוסיפה את כל האירועים ב-Child Incident Numbers כצאצאים של האירוע הראשי.

Child Incident Numbers

חובה.

רשימה מופרדת בפסיקים של מספרי אירועים שיוגדרו כאירועים משניים של האירוע הראשי שצוין, בפורמט INCINCIDENT_NUMBER (לדוגמה, INC0000051).

פלט של פעולות

הפעולה 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

חובה.

מספר האירוע שרוצים לסגור, בפורמט INCINCIDENT_NUMBER.

Close Reason

חובה.

הסיבה לסגירת האירוע.

Resolution Code

חובה.

קוד הפתרון של האירוע.

הערכים האפשריים הם:

  • Duplicate
  • Known error
  • No resolution provided
  • Resolved by caller
  • Resolved by change
  • Resolved by problem
  • Resolved by request
  • Solution provided
  • Workaround provided
  • User error

ערך ברירת המחדל הוא Solution provided.

Close Notes

חובה.

הערות הסגירה של האירוע.

פלט של פעולות

הפעולה Close Incident מספקת את הפלט הבא:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית לא זמין
טבלת העשרה לא זמין
תוצאת JSON לא זמין
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה Close Incident:

שם תוצאת הסקריפט ערך
is_success true או false

יצירת אירוע התראה

משתמשים בפעולה Create Alert Incident כדי ליצור אירוע חדש ב-ServiceNow על סמך פרטי ההתראה שמפעילה את הפעלת הפלייבוק.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה יצירת אירוע התראה דורשת את הפרמטרים הבאים:

פרמטר תיאור
Impact

חובה.

רמת ההשפעה של האירוע.

הערכים האפשריים הם:

  • ‫1 לאיכות גבוהה
  • ‫2 ל-Medium
  • ‫3 לרמה נמוכה

ערך ברירת המחדל הוא 1.

Urgency

חובה.

רמת הדחיפות של האירוע.

הערכים האפשריים הם:

  • ‫1 לאיכות גבוהה
  • ‫2 ל-Medium
  • ‫3 לרמה נמוכה

ערך ברירת המחדל הוא 1.

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

חובה.

רמת ההשפעה של האירוע.

הערכים האפשריים הם:

  • ‫1 לאיכות גבוהה
  • ‫2 ל-Medium
  • ‫3 לרמה נמוכה

ערך ברירת המחדל הוא 1.

Urgency

חובה.

רמת הדחיפות של האירוע.

הערכים האפשריים הם:

  • ‫1 לאיכות גבוהה
  • ‫2 ל-Medium
  • ‫3 לרמה נמוכה

ערך ברירת המחדל הוא 1.

Category

זה שינוי אופציונלי.

הקטגוריה של האירוע.

Assignment Group ID

זה שינוי אופציונלי.

השם המלא של הקבוצה שאליה רוצים להקצות את האירוע.

Assigned User ID

זה שינוי אופציונלי.

השם המלא של המשתמש שרוצים להקצות לו את האירוע.

Description

זה שינוי אופציונלי.

תיאור האירוע.

Custom Fields

זה שינוי אופציונלי.

מחרוזת בפורמט JSON שמכילה את שמות השדות והערכים התואמים שלהם לעדכון (לדוגמה, {"location":"London", "category":"database"}).

אפשר להשתמש בפרמטר הזה כדי לשנות שדות שלא הוגדרו במפורש כקלט של פעולה.

פלט של פעולות

הפעולה 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 שבה נוצרת הרשומה החדשה (לדוגמה, incident).

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 שמכילה את הרשומה שממנה רוצים להוריד קבצים מצורפים (למשל incident).

Record Sys ID

חובה.

מזהה המערכת (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"
        }
    ]
}
הודעות פלט

הפעולה הורדת קבצים מצורפים יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully downloaded the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

הפעולה בוצעה בהצלחה.
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

חובה.

מספר האירוע הראשי שממנו רוצים לאחזר את פרטי האירוע המשני, בפורמט INCINCIDENT_NUMBER.

Max Child Incident To Return

זה שינוי אופציונלי.

מספר האירועים הצאצאים המקסימלי שהפעולה מחזירה מהאירוע ההורה.

ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה 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 יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully retrieved information about child incidents related to the PARENT_INCIDENT_NUMBER incident in ServiceNow.

Action wasn't able to retrieve information about the child incidents in ServiceNow. Reason: incident PARENT_INCIDENT_NUMBER was not found.

No child incidents were found.

הפעולה בוצעה בהצלחה.
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 שממנה רוצים לאחזר רשומות, למשל cmdb_ci_appl.

מידע נוסף על שמות של מחלקות זמין במאמר הצגה ועריכה של הגדרות ומטא-נתונים של מחלקות.

Sys ID

חובה.

רשימה מופרדת בפסיקים של מזהי המערכת (sys_id) של רשומות ה-CMDB שרוצים לאחזר את הפרטים שלהן.

Max Records To Return

זה שינוי אופציונלי.

המספר המקסימלי של קשרי רשומות שיוחזרו לכל סוג קשר (כמו relates to או depends on).

ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה 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 יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully returned details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST.

Action wasn't able to return details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST

Action wasn't able to return details for CMDB records in the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found.

Action wasn't able to return details for CMDB record with Sys ID SYS_ID in the Class CLASS_NAME in Service Now. Reason: Record with Sys ID SYS_ID was not found in Class CLASS_NAME.

Information about the provided Sys IDs was not found.

הפעולה בוצעה בהצלחה.
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 שרוצים לאחזר, בפורמט INCINCIDENT_NUMBER.

פלט של פעולות

הפעולה 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 שמכילה את הרשומה שממנה רוצים לאחזר מידע (למשל incident).

Record Sys ID

חובה.

מזהה המערכת (sys_id) של רשומת ServiceNow הספציפית שרוצים לאחזר את הפרטים שלה.

Fields

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של שדות (עמודות) ספציפיים שיוחזרו מהרשומה שאוחזרה (למשל sys_id,number,short_description).

אם לא מציינים ערך, הפעולה מחזירה את שדות ברירת המחדל של הרשומה.

פלט של פעולות

הפעולה 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 יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully retrieved information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow.

Action wasn't able to retrieve information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Reason: ERROR_REASON.

הפעולה בוצעה בהצלחה.
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

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של מזהי המערכת שתואמים למשתמשים שרוצים לאחזר את הפרטים שלהם (למשל sys_id_1,sys_id_2).

Emails

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של כתובות אימייל שמתאימות למשתמשים שרוצים לאחזר את הפרטים שלהם (למשל email1@example.com,email2@example.com).

פלט של פעולות

הפעולה קבלת פרטי משתמש מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית יש גישה
טבלת העשרה לא זמין
תוצאת 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 יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully retrieved information about users from ServiceNow with the following Sys IDs: SYS_ID_LIST.

Action wasn't able to retrieve information about the users in ServiceNow with the following Sys IDs: SYS_ID_LIST.

Information about the users with specified Sys IDs was not found in ServiceNow.

הפעולה בוצעה בהצלחה.
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 שממנה רוצים לאחזר רשומות, למשל cmdb_ci_appl.

מידע נוסף על שמות המחלקות ב-ServiceNow זמין במאמר הצגה ועריכה של הגדרות ומטא-נתונים של מחלקות.

Query Filter

זה שינוי אופציונלי.

מחרוזת השאילתה המקודדת שמשמשת לסינון הרשומות שמוחזרות (למשל sys_idLIKE1^sys_idSTARTSWITH0).

אפשר ליצור מחרוזות שאילתה תקינות באמצעות האפשרות Copy query בתצוגות הרשימה של ServiceNow. מידע נוסף זמין במאמר מחרוזות של שאילתות מקודדות.

Max Records To Return

זה שינוי אופציונלי.

המספר המקסימלי של רשומות לאחזור, על סמך המסננים שהוחלו.

ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה 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 יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully listed CMDB records for the Class CLASS_NAME in ServiceNow.

Action wasn't able to list CMDB records for the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found in Service Now.".format(Class name)

הפעולה בוצעה בהצלחה.
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 שמכילה את הרשומה שרוצים להציג את התגובות שלה (למשל incident).

Record Sys ID

חובה.

מזהה המערכת (sys_id) של הרשומה שרוצים להציג את התגובות שלה.

Type

חובה.

סוג התגובות או ההערות שרוצים לאחזר.

הערכים האפשריים הם:

  • Comment
  • Work Note

ערך ברירת המחדל הוא Comment.

Max Results To Return

זה שינוי אופציונלי.

המספר המקסימלי של תגובות או הערות עבודה שיוחזרו.

ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה הצגת רשימה של תגובות לרשומה מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית לא זמין
טבלת העשרה לא זמין
תוצאת 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 יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No CONTENT_TYPE were found for TABLE_NAME with Sys ID SYS_ID in ServiceNow.

הפעולה בוצעה בהצלחה.
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 שבה מחפשים רשומות קשורות (למשל, incident).

Usernames

חובה.

רשימה מופרדת בפסיקים של שמות משתמשים שרוצים לאחזר את הרשומות שקשורות אליהם.

Max Days Backwards

חובה.

מספר הימים אחורה מהתאריך הנוכחי שבהם יתבצע חיפוש של רשומות קשורות.

ערך ברירת המחדל הוא 1.

Max Records To Return

זה שינוי אופציונלי.

מספר הרשומות המקסימלי שיוחזרו לכל משתמש.

ערך ברירת המחדל הוא 50.

פלט של פעולות

הפעולה 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 יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully retrieved related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

Action wasn't able to retrieve related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

No related table records were retrieved for the provided users.

הפעולה בוצעה בהצלחה.
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 שרוצים לעדכן, בפורמט INCINCIDENT_NUMBER.

Short Description

זה שינוי אופציונלי.

תיאור קצר של האירוע.

Impact

זה שינוי אופציונלי.

רמת ההשפעה של האירוע.

הערכים האפשריים הם:

  • ‫1 לאיכות גבוהה
  • ‫2 ל-Medium
  • ‫3 לרמה נמוכה

ערך ברירת המחדל הוא 1.

Urgency

זה שינוי אופציונלי.

רמת הדחיפות של האירוע.

הערכים האפשריים הם:

  • ‫1 לאיכות גבוהה
  • ‫2 ל-Medium
  • ‫3 לרמה נמוכה

ערך ברירת המחדל הוא 1.

Category

זה שינוי אופציונלי.

קטגוריה לאירוע.

Assignment Group ID

זה שינוי אופציונלי.

השם המלא של הקבוצה שאליה רוצים להקצות את האירוע.

Assigned User ID

זה שינוי אופציונלי.

השם המלא של המשתמש שרוצים להקצות לו את האירוע.

Description

זה שינוי אופציונלי.

תיאור האירוע.

Incident State

זה שינוי אופציונלי.

הערך הבסיסי של ServiceNow לסטטוס האירוע (לדוגמה, 1 או in_progress) במקום התווית (לדוגמה, New או In Progress).

Custom Fields

זה שינוי אופציונלי.

מחרוזת בפורמט JSON שמכילה את שמות השדות והערכים התואמים שלהם לעדכון (לדוגמה, {"location":"London", "category":"database"}).

אפשר להשתמש בפרמטר הזה כדי לשנות שדות שלא הוגדרו במפורש כקלט של פעולה.

פלט של פעולות

הפעולה 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 שמכילה את הרשומה שרוצים לעדכן (למשל incident).

Object Json Data

חובה.

אובייקט JSON שמכיל את צמדי השדה-ערך שצריך להחיל על הרשומה (כמו {"short_description": "Updated description"}).

Record Sys ID

חובה.

מזהה המערכת (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 שמכילה את הרשומה שממנה ממתינים לתגובות (למשל incident).

Record Sys ID

חובה.

מזהה המערכת (sys_id) של הרשומה שרוצים לעקוב אחרי התגובות שלה.

Type

חובה.

סוג התגובות או ההערות שהפעולה צריכה להמתין להן.

הערכים האפשריים הם:

  • Comment
  • Work Note

ערך ברירת המחדל הוא Comment.

Wait Mode

חובה.

התנאי שקובע מתי הפעולה מפסיקה להמתין וממשיכה.

הערכים האפשריים הם:

  • ‫Until Timeout: הפעולה ממתינה עד לסיום תקופת הזמן הקצוב לתפוגה, ואז מחזירה את כל התגובות שנצברו.
  • ‫Until First Message: הפעולה ממתינה עד לפרסום התגובה החדשה הראשונה או הערת העבודה הראשונה אחרי שהפעולה מתחילה.
  • ‫Until Specific Text: הפעולה ממתינה עד שמתפרסמת תגובה או הערת עבודה שמכילה את הטקסט שצוין ב-Text.

ערך ברירת המחדל הוא Until Timeout.

Text

זה שינוי אופציונלי.

מחרוזת הטקסט הספציפית שהפעולה ממתינה לה בתגובה חדשה או בהערה חדשה על העבודה.

הפרמטר הזה משמש רק כשבוחרים באפשרות Until Specific Text בתור הערך של Wait Mode.

פלט של פעולות

הפעולה המתנה לתגובות מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית לא זמין
טבלת העשרה לא זמין
תוצאת 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"
}
הודעות פלט

הפעולה המתנה לתגובות יכולה להחזיר את הודעות הפלט הבאות:

הודעת פלט תיאור ההודעה

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No new CONTENT_TYPE were added during the timeframe of action execution to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

הפעולה בוצעה בהצלחה.
Error executing action "Wait For Comments". Reason: ERROR_REASON

הפעולה נכשלה.

בודקים את החיבור לשרת, את הפרמטרים של הקלט או את פרטי הכניסה.

תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט תוצאת הסקריפט כשמשתמשים בפעולה המתנה לתגובות:

שם תוצאת הסקריפט ערך
is_success true או false

המתנה לעדכון השדה

משתמשים בפעולה Wait for Field Update כדי להשהות את הפעלת הפלייבוק עד ששדה ספציפי ברשומת נתונים של ServiceNow מתעדכן לאחד מהערכים הצפויים.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה המתנה לעדכון שדה דורשת את הפרמטרים הבאים:

פרמטר תיאור
Table Name

חובה.

השם של הטבלה ב-ServiceNow שמכילה את הרשומה למעקב (למשל incident).

Record Sys ID

חובה.

מזהה המערכת (sys_id) של הרשומה שבה רוצים לעקוב אחרי עדכון השדה.

Field - Column Name

חובה.

שם העמודה (השדה) שהפעולה עוקבת אחרי השינויים בה.

Field - Values

חובה.

רשימה מופרדת בפסיקים של ערכים שאם הם נמצאים בשדה המנוטר, הפעולה מפסיקה להמתין וממשיכה (למשל In Progress,Resolved).

פלט של פעולות

הפעולה המתנה לעדכון שדה מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית לא זמין
טבלת העשרה לא זמין
תוצאת JSON לא זמין
הודעות פלט יש גישה
תוצאת הסקריפט יש גישה
תוצאת הסקריפט

בטבלה הבאה מפורטים הערכים של פלט הסקריפט כשמשתמשים בפעולה המתנה לעדכון שדה:

שם תוצאת הסקריפט ערך
updated_field UPDATED_FIELD

המתנה לעדכון סטטוס

משתמשים בפעולה Wait for Status Update כדי להשהות את הפעלת הפלייבוק עד שסטטוס האירוע הספציפי ב-ServiceNow מתעדכן לאחד מהערכים הצפויים.

הפעולה הזו לא פועלת על ישויות של Google SecOps.

קלט של הפעולה

הפעולה המתנה לעדכון סטטוס דורשת את הפרמטרים הבאים:

פרמטר תיאור
Incident Number

חובה.

המזהה הייחודי של אירוע ServiceNow למעקב, בפורמט INCINCIDENT_NUMBER.

Statuses

חובה.

רשימה מופרדת בפסיקים של סטטוסים (מצבים) של אירועים, שאם הם מתרחשים, הפעולה מפסיקה להמתין וממשיכה (למשל In Progress,Resolved).

פלט של פעולות

הפעולה המתנה לעדכון סטטוס מספקת את הפלטים הבאים:

סוג הפלט של הפעולה זמינות
חיבור הקייס לקיר לא זמין
קישור לקיר של התיק לא זמין
שולחן קיר עם ארונית לא זמין
טבלת העשרה לא זמין
תוצאת 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

חובה.

שם השדה שבו מאוחסן שם המוצר.

שם המוצר משפיע בעיקר על המיפוי. כדי לייעל ולשפר את תהליך המיפוי של המחבר, ערך ברירת המחדל הופך לערך חלופי שאליו מתייחס הקוד. כל קלט לא חוקי בפרמטר הזה יוחלף בערך חלופי כברירת מחדל.

ערך ברירת המחדל הוא Product Name.

Event Field Name

חובה.

שם השדה שקובע את שם האירוע (סוג משנה).

ערך ברירת המחדל הוא sys_class_name.

Rule Generator

זה שינוי אופציונלי.

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

Api Root

חובה.

שורש ה-API של המכונה של ServiceNow.

ערך ברירת המחדל הוא https://INSTANCE.service-now.com/api/now/v1/.

Username

חובה.

שם המשתמש של חשבון ServiceNow.

Password

חובה.

הסיסמה של חשבון ServiceNow.

Verify SSL

זה שינוי אופציונלי.

אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow.

מופעלת כברירת מחדל.

Use sys_domain Environment

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, המחבר משתמש בשדה sys_domain של ServiceNow כסביבה של הבקשה שהועברה.

אם השדה הזה חסר או לא זמין, המחבר משתמש כברירת מחדל בערך שצוין בפרמטר Environment.

Days Backwards

זה שינוי אופציונלי.

מספר הימים אחורה מהשעה הנוכחית לאחזור רשומות.

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

ערך ברירת המחדל הוא 5.

Disable Overflow

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, המחבר מתעלם ממנגנון ההצפה של Google SecOps.

Max Incidents Per Cycle

זה שינוי אופציונלי.

מספר האירועים המקסימלי שאפשר לאחזר בכל איטרציה של המחבר.

ערך ברירת המחדל הוא 10.

Environments Whitelist

זה שינוי אופציונלי.

רשימה מופרדת בפסיקים של סביבות (דומיינים) שהמחבר יטמיע ב-Google SecOps, למשל env1,env2.

Use whitelist as a blacklist

זה שינוי אופציונלי.

אם בוחרים באפשרות הזו, המחבר משתמש ברשימה הדינמית כרשימת חסימה.

מושבתת כברירת מחדל.

PythonProcessTimeout

חובה.

מגבלת הזמן הקצוב לתפוגה, בשניות, של תהליך Python שמריץ את הסקריפט הנוכחי.

ערך ברירת המחדל הוא 60.

Incident Table

זה שינוי אופציונלי.

שם הטבלה או הנתיב ב-API שמשמשים לפעולות שקשורות לאירועים ולאחזור רשומות.

כברירת מחדל, השילוב משתמש בנתיב table/incident.

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, צריך להגדיר את פרטי הכניסה של הלקוח (Client ID ו-Client Secret) או את Refresh Token.

מושבתת כברירת מחדל.

Server Time Zone

זה שינוי אופציונלי.

אזור הזמן שמוגדר בשרת ServiceNow (למשל UTC או Asia/Jerusalem).

ערך ברירת המחדל הוא UTC.

Table Name

זה שינוי אופציונלי.

שם הטבלה שממנה רוצים לאחזר רשומות, למשל incident.

Event Name

זה שינוי אופציונלי.

שם האירוע ב-Google SecOps שנוצר כשמתבצעת הטמעה של רשומה (למשל ServiceNowEvent).

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. ברירת המחדל היא https://INSTANCE.service-now.com/api/now/v1/.

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, צריך להגדיר את פרטי הכניסה של הלקוח (Client ID ו-Client Secret) או את Refresh Token. מושבתת כברירת מחדל.

Max Hours Backwards אופציונלי

מספר השעות אחורה מהשעה הנוכחית שבהן המערכת תחפש אירועים סגורים ותסנכרן אותם. ברירת המחדל היא 24.

Table Name חובה

השם של טבלת מסד הנתונים שבה מחפשים אירועים סגורים (לדוגמה, incident).

‫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. ברירת המחדל היא https://INSTANCE.service-now.com/api/now/v1/.

Username אופציונלי

שם המשתמש של המכונה ב-ServiceNow.

הפרמטר הזה נדרש כשמבצעים אימות באמצעות סיסמה בסיסית.

Password אופציונלי

הסיסמה של המכונה ב-ServiceNow.

הפרמטר הזה נדרש כשמבצעים אימות באמצעות סיסמה בסיסית.

Sync Level חובה

הרמה שבה המשימה מסנכרנת נתונים. ערכים אפשריים: Case,‏ Alert. ברירת המחדל היא Case.

Max Hours Backwards חובה

מספר השעות המקסימלי אחורה מהשעה הנוכחית לחיפוש פניות לסנכרון. ברירת המחדל היא 24.

Verify SSL אופציונלי

אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow. מופעלת כברירת מחדל.

Use OAuth Authentication אופציונלי

אם בוחרים באפשרות הזו, המשימה משתמשת באימות OAuth במקום באימות בסיסי. כשבוחרים באפשרות הזו, הפרמטרים Client ID,‏ Client Secret ו-Refresh Token נדרשים. מושבתת כברירת מחדל.

Client ID אופציונלי

מזהה הלקוח של אפליקציית ServiceNow. חובה אם נבחרה האפשרות Use OAuth Authentication.

Client Secret אופציונלי

סוד הלקוח של אפליקציית ServiceNow. חובה אם נבחרה האפשרות Use OAuth Authentication.

Refresh Token אופציונלי

טוקן הרענון של אפליקציית ServiceNow. חובה אם נבחרה האפשרות Use OAuth Authentication.

סנכרון הערות ברשומות של טבלאות

כדי לסנכרן תגובות בין רשומות בטבלה של ServiceNow לבין תיקים ב-Google SecOps, משתמשים במשימה Sync Table Record Comments.

פרמטרים של משימות

למשימה Sync Table Record Comments נדרשים הפרמטרים הבאים:

פרמטר תיאור
API Root חובה

שורש ה-API של המכונה של ServiceNow. ברירת המחדל היא https://INSTANCE.service-now.com/api/now/v1/.

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, צריך להגדיר את פרטי הכניסה של הלקוח (Client ID ו-Client Secret) או את Refresh Token. מושבתת כברירת מחדל.

Table Name חובה

שם הטבלה ב-ServiceNow שבה מחפשים רשומות כדי לסנכרן מהן תגובות (לדוגמה, incident).

סנכרון הערות של רשומות בטבלה לפי תג

כדי לסנכרן את ההערות בין הרשומות בטבלה של 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. ברירת המחדל היא https://INSTANCE.service-now.com/api/now/v1/.

Username חובה

שם המשתמש של המכונה ב-ServiceNow.

Password Mandatory

הסיסמה של המכונה ב-ServiceNow.

Table Name חובה

שם הטבלה במסד הנתונים שרוצים לחפש בה, למשל incident.

Verify SSL אופציונלי

אם האפשרות הזו נבחרת, השילוב מאמת את אישור ה-SSL כשמתחברים לשרת של ServiceNow. מופעלת כברירת מחדל.

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