ConnectWise

במסמך הזה מוסבר איך לשלב את ConnectWise עם Google Security Operations.

הגדרת שילוב של ConnectWise לעבודה עם Google Security Operations

הגדרה של מפתחות ציבוריים ופרטיים ב-ConnectWise Manage

כדי ליצור שילוב בין ConnectWise Manage לבין Google SecOps, צריך לספק מפתחות API. מפתחות API הם מפתחות ציבוריים ופרטיים שנוצרים על ידי ConnectWise Manage עבור חשבון האינטגרציה.

כדי ליצור מפתחות API ב-ConnectWise Manage:

  1. ב-ConnectWise Manage, לוחצים על System (מערכת) > Members (חברים) ובוחרים חבר קיים או יוצרים חבר חדש. חשוב לוודא שלמשתמש שבחרתם יש את כל ההרשאות הנדרשות להגדרת השילוב.
  2. במסך Member Maintenance (תחזוקת חברים), לוחצים על הכרטיסייה API Keys (מפתחות API) ואז על New Item (פריט חדש).
  3. בשדה Description (תיאור), מזינים את התיאור של המפתחות החדשים שנוצרו. לדוגמה, Google SecOps Integration.
  4. לוחצים על שמירה כדי לשמור את הפריט החדש.

שני מפתחות ה-API נוצרים ומוצגים בשדות Public Key (מפתח ציבורי) ו-Private Key (מפתח פרטי). המפתח הפרטי מוצג רק בזמן שהוא נוצר.

הגדרת שילוב של ConnectWise ב-Google SecOps

הוראות מפורטות להגדרת שילוב ב-Google SecOps מופיעות במאמר הגדרת שילובים.

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

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

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
הבסיס של ה-API String https://{CompanyURL}/v4_6_Release/apis/3.0/ כן הכתובת של המופע של ConnectWise.
שם החברה String לא רלוונטי כן
מפתח ציבורי String לא רלוונטי כן
מפתח פרטי String לא רלוונטי כן
מזהה לקוח String לא רלוונטי כן מזהה הלקוח של אפליקציית ConnectWise.

פעולות

הוספת תגובה לכרטיס

תיאור

הוספת תגובה חדשה לכרטיס ב-ConnectWise.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל תיאור
מזהה הכרטיס String לא רלוונטי כן

מזהה הפנייה ב-ConnectWise.

דוגמה: 608718
תגובה String לא רלוונטי כן תוכן התגובה לצירוף לכרטיס.
פנימי תיבת סימון התיבה לא מסומנת כן אם תיבת הסימון הזו מסומנת, התגובה מופיעה בקטע הפנימי.

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
ticket_id לא רלוונטי לא רלוונטי
תוצאת JSON
N/A

סגירת הכרטיס

תיאור

סגירת כרטיס ConnectWise.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
מזהה הכרטיס String לא רלוונטי כן

מזהה הפנייה ב-ConnectWise.

דוגמה: 608718.
סטטוס סגירה מותאם אישית String לא רלוונטי לא אם המערכת הספציפית משתמשת בסטטוס סגור בהתאמה אישית, למשל 'הושלם'.

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאות הסקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
ticket_id נכון/לא נכון ticket_id:False
תוצאת JSON
N/A
העשרה של ישויות

לא רלוונטי

תובנות

לא רלוונטי

יצירת כרטיס תמיכה בנושא התראות

תיאור

יצירה של כרטיס ב-ConnectWise לכל התראה חדשה ב-Google SecOps.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
חברה String לא רלוונטי כן שם החברה.
לוח String לא רלוונטי כן השם של ה-Jamboard.
סטטוס String לא רלוונטי כן דוגמה: לא הוקצה
עדיפות String לא רלוונטי כן דוגמה: עדיפות 3 – תגובה רגילה
התיאור הראשוני String לא רלוונטי כן לא רלוונטי
שם הבעלים String לא רלוונטי לא

השם של חבר ב-ConnectWise שאליו רוצים להקצות את הכרטיס.

דוגמה: connectwise_user_1.

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
ticket_id לא רלוונטי לא רלוונטי
תוצאת JSON
N/A

יצירת כרטיס

תיאור

יצירת כרטיס ב-ConnectWise.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
חברה String לא רלוונטי כן שם החברה.
לוח String לא רלוונטי כן השם של ה-Jamboard
סיכום String לא רלוונטי כן לא רלוונטי
סטטוס String לא רלוונטי כן לדוגמה, 'לא הוקצתה'.
עדיפות String לא רלוונטי כן דוגמה: עדיפות 3 – תגובה רגילה
שם הבעלים String לא רלוונטי לא שם החבר ב-ConnectWise שאליו רוצים להקצות את הכרטיס הזה. דוגמה: connectwise_user_1

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
ticket_id נכון/לא נכון ticket_id:False
תוצאת JSON
N/A

מחיקת כרטיס

תיאור

מחיקת כרטיס ConnectWise לפי המזהה.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
מזהה הכרטיס String לא רלוונטי כן

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

דוגמה: 607167

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
N/A

רכישת כרטיס

תיאור

קבלת כרטיס ConnectWise לפי מזהה וצירוף ה-JSON של הכרטיס כקובץ.

פרמטרים

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

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
ticket_json לא רלוונטי לא רלוונטי
תוצאת JSON
{
  "773256":
   {
     "customerUpdatedFlag": false,
     "estimatedTimeCost": 0.0,
     "recordType": "ServiceTicket",
     "siteName": "Main",
     "billTime": "NoDefault",
     "site":
       {
         "_info":
           {
             "site_href": "",
             "mobileGuid": "c5e7be2e-af3b-461f-a637-1b3e7e24bdc6"
           },
         "id": 23188, "name": "Main"
        },
     "currency":
       {
         "symbol": "$",
         "isoCode": "USD",
         "_info": {
                   "currency_href": ""
                   },
         "name": "US Dollars", "id": 7
        },
     "estimatedProductCost": 0.0,
     "estimatedExpenseRevenue": 0.0,
     "contactName": "user name",
     "addressLine1": "110 Fifth Avenue ",
     "billingMethod": "ActualRates",
     "id": 773256,
     "impact": "Medium",
     "city": "New York",
     "billProducts": "NoDefault",
     "businessUnitId": 20,
     "zip": "10011",
     "estimatedExpenseCost": 0.0,
     "mobileGuid": "f7b5a0eb-6038-4e14-a661-05c393917841",
     "closedFlag": false,
     "enteredBy": "Siemplify",
     "priority":
        {
          "sort": 6,
          "_info":
             {
               "image_href": "",
               "priority_href": ""
             },
          "id": 4,
          "name": "Priority 3 - Normal Response"
         },
     "source":
         {
           "_info":
             {
                "source_href": ""
              },
           "id": 2,
           "name": "Customer Phone Call"
          },
      "automaticEmailCcFlag": false,
      "board":
         {
           "_info":
             {
                "board_href": ""
             },
          "id": 70,
          "name": "Siemplify - T&M"
          },
     "customFields":
        [{
           "numberOfDecimals": 0,
           "caption": "2nd Shift",
           "type": "Checkbox",
           "id": 20,
           "entryMethod": "EntryField"
         },
         {
            "numberOfDecimals": 0,
            "caption": "3rd Shift",
            "type": "Checkbox",
            "id": 21,
            "entryMethod": "EntryField"
           },
          {
            "numberOfDecimals": 0,
            "caption": "Huddle Rvw",
            "type": "Checkbox",
            "id": 22,
            "entryMethod": "EntryField"
           }],
     "contactEmailAddress": "john_doe@example.com",
     "Status":
          {
            "_info": {"status_href": ""},
            "id": 1351,
            "name": "Unassigned"
           },
     "contactPhoneNumber": "(800) 555‑0175",
     "dateResponded": "2019-01-17T09:21:03Z",
     "isInSla": false,
     "company":
           {
             "_info":
                 {"mobileGuid": "42fcabed-a0f6-4171-bd7a-ca563ba45f7c",
                  "company_href": ""},
             "identifier": "Siemplify",
             "id": 18304,
             "name": "Siemplify"
           },
     "automaticEmailContactFlag": false,
     "hasChildTicket": false,
     "billExpenses": "NoDefault",
     "estimatedTimeRevenue": 0.0,
     "locationId": 119,
     "estimatedProductRevenue": 0.0,
     "automaticEmailResourceFlag": false,
     "dateEntered": "2019-01-17T09:21:03Z",
     "approved": true,
     "severity": "Medium",
     "resolveMinutes": 0,
     "serviceLocation":
           {
              "_info":
                   {"location_href": ""},
              "id": 6,
              "name": "Remote"
            },
     "resPlanMinutes": 0,
     "stateIdentifier": "NY",
     "dateResplan": "2019-01-17T09:21:03Z",
     "subBillingMethod": "ActualRates",
     "Country":
           {
              "_info":
                   {"country_href": ""},
              "id": 1,
              "name": "United States"
            },
     "respondMinutes": 0,
     "allowAllClientsPortalView": false,
     "hasMergedChildTicketFlag": false,
     "summary": "TikcetApiTest",
     "contact":
           {
             "_info":
                  {"contact_href": "",
                   "mobileGuid": "c86377ec-7726-4057-aca2-e992b550140f"
                  },
            "id": 59249,
            "name": "user name"
            },
     "team":
           {
             "_info":
                  {"team_href": ""},
             "id": 78,
             "name": "Siemplify"
           },
     "addressLine2": "5th Floor",
     "_info":
           {
             "configurations_href": "",
             "tasks_href": "",
             "updatedBy": "Siemplify",
             "expenseEntries_href": "",
             "lastUpdated": "2019-01-17T09:21:03Z",
             "products_href": "",
             "activities_href": "",
             "Timeentries_href":"",
             "notes_href": "",
             "documents_href": "",
             "scheduleentries_href": ""
            }
     }
}

פינג

תיאור

בדיקת הקישוריות.

פרמטרים

לא רלוונטי

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
N/A

עדכון כרטיס

תיאור

עדכון פרטי הכרטיס ב-ConnectWise.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
פרמטר סוג ערך ברירת המחדל חובה תיאור
מזהה הכרטיס String לא רלוונטי כן

המזהה של הכרטיס שצריך לעדכן.

דוגמה: 609620
סיכום String לא רלוונטי לא סיכום מעודכן.
שם הסוג String לא רלוונטי לא דוגמה: אפליקציה
שם תת-הסוג String לא רלוונטי לא דוגמה: Adobe
שם הפריט String לא רלוונטי לא דוגמה: פיתוח
סטטוס String לא רלוונטי לא

הסטטוס החדש של הפנייה.

לדוגמה: In Progress (plan of action)

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
ticket_id נכון/לא נכון ticket_id:False
תוצאת JSON
N/A

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

תיאור

מוסיפים קובץ מצורף לכרטיס ב-ConnectWise.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
מזהה הכרטיס String לא רלוונטי כן מציינים את המזהה של הכרטיס שאליו צריך להוסיף את המסמך.
קובץ בקידוד Base64 String לא רלוונטי כן מציינים את הקובץ בקידוד Base64 שצריך להוסיף כקובץ מצורף.
שם קובץ String ‫{filename}.{extension} כן

מציינים את שם הקובץ שמאחורי הקובץ המצורף. הערך הזה משמש גם ככותרת.

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

ריצה

הפעולה הזו מופעלת על כל הישויות.

תוצאות הפעולה

תוצאת סקריפט
שם תוצאת התסריט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False
תוצאת JSON
{
    "id": 280,
    "title": "QWEqqqq",
    "fileName": "s.json",
    "serverFileName": "24e7db8d-41b5-4bd0-9db3-a60d46143afe.json",
    "owner": "Admin1",
    "linkFlag": false,
    "imageFlag": false,
    "publicFlag": false,
    "htmlTemplateFlag": false,
    "readOnlyFlag": true,
    "size": 22131,
    "urlFlag": false,
    "guid": "b9fc3fc6-f368-40bb-bc06-233f4d6a299c",
    "_info": {
        "lastUpdated": "2022-05-10T14:02:23Z",
        "updatedBy": "Admin1"
    }
}
Case Wall
סוג התוצאה ערך / תיאור סוג
הודעת פלט*

הפעולה לא אמורה להיכשל או לעצור את ההרצה של חוברת ההדרכה:

אם מדווח קוד הסטטוס 201 (is_success=true): 'הקובץ נוסף בהצלחה כקובץ מצורף לכרטיס {ticket_id} ב-ConnectWise'.

הפעולה צריכה להיכשל ולהפסיק את ההרצה של מדריך ההפעלה:

אם מדווחת שגיאה קריטית: "Error executing action "Add Attachment To Ticket". הסיבה: {0}''.format(error.Stacktrace)."

אם מדווח על קוד סטטוס 400: 'שגיאה בהפעלת הפעולה 'הוספת קובץ מצורף לכרטיס'. הסיבה: {errors/message}.''

אם צוין פורמט לא תקין של שם הקובץ: "שגיאה בהפעלת הפעולה 'הוספת קובץ מצורף לכרטיס'". הסיבה: הערך של 'שם הקובץ' לא תואם לפורמט הנדרש. פורמט: {filename}.{extension}.''

 כללי

תעסוקה

סנכרון של כרטיסים סגורים וכרטיסים שהוסרו

תיאור

סנכרון של כרטיסים סגורים ב-ConnectWise והתראות שבוטלו ב-Google SecOps.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל תיאור
ספריית הבסיס של ה-API String לא רלוונטי לא רלוונטי
שם החברה String לא רלוונטי לא רלוונטי
מפתח ציבורי של API String לא רלוונטי לא רלוונטי
מפתח פרטי של API String לא רלוונטי לא רלוונטי
שם הסקריפט String לא רלוונטי לא רלוונטי

סנכרון התגובות

תיאור

סנכרון תגובות בין בקשות תמיכה ב-Google SecOps לבין כרטיסי תמיכה ב-ConnectWise.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל תיאור
ספריית הבסיס של ה-API String https://<Host Name>/v4_6_Release/apis/3.0/ לא רלוונטי
שם החברה String לא רלוונטי לא רלוונטי
מפתח ציבורי של API String לא רלוונטי לא רלוונטי
מפתח פרטי של API String לא רלוונטי לא רלוונטי
שם הסקריפט String לא רלוונטי לא רלוונטי

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