ConnectWise

集成版本：17.0

配置 ConnectWise 集成以与 Google Security Operations 搭配使用

在 ConnectWise Manage 中设置公钥和私钥

如需在 ConnectWise Manage 与 Google SecOps 之间创建集成，您需要提供 API 密钥。API 密钥是由 ConnectWise Manage 为集成账号生成的公钥和私钥。

如需在 ConnectWise Manage 中创建 API 密钥，请执行以下操作：

1. 在 ConnectWise Manage 中，依次点击系统 > 成员，然后选择现有成员或创建新成员。确保所选成员拥有设置集成所需的所有权限。
2. 在“会员维护”界面上，点击 API 密钥标签页，然后点击新项。
3. 在说明字段中，输入新创建的密钥的说明。例如，Google SecOps 集成。
4. 点击保存以保存新商品。

系统会生成这两个 API 密钥，并将其显示在“公钥”和“私钥”字段中。私钥仅在创建时显示。

在 Google SecOps 中配置 ConnectWise 集成

有关如何在 Google SecOps 中配置集成的详细说明，请参阅配置集成。

集成参数

使用以下参数配置集成：

参数显示名称	类型	默认值	是否为必需属性	说明
API 根	字符串	https://{CompanyURL}/v4_6_Release/apis/3.0/	是	ConnectWise 实例的地址。
公司名称	字符串	不适用	是
公钥	字符串	不适用	是
私钥	字符串	不适用	是
客户端 ID	字符串	不适用	是	ConnectWise 应用的客户端 ID。

注意： 如果需要，您可以在稍后阶段进行更改。配置完成后，您可以在 playbook 中使用实例。如需详细了解如何配置和支持多个实例，请参阅支持多个实例。

操作

向工单添加评论

说明

向 ConnectWise 中的工单添加新评论。

参数

参数名称	类型	默认值		说明
工单 ID	字符串	不适用	是	ConnectWise 工单 ID。 示例：608718
评论	字符串	不适用	是	要附加到工单的评论内容。
内部	复选框	尚未核查	是	如果选中，则将注释放在内部部分。

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
ticket_id	不适用	不适用

JSON 结果

N/A

关闭工单

说明

关闭 ConnectWise 工单。

参数

参数名称	类型	默认值	是否为必需属性	说明
工单 ID	字符串	不适用	是	ConnectWise 工单 ID。 示例：608718。
自定义关闭状态	字符串	不适用	否	如果特定系统使用自定义的关闭状态，例如“已完成”。

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
ticket_id	True/False	ticket_id:False

JSON 结果

N/A

实体扩充

不适用

数据分析

不适用

创建提醒工单

说明

为每个新的 Google SecOps 提醒创建 ConnectWise 工单。

参数

参数名称	类型	默认值	是否为必需属性	说明
公司	字符串	不适用	是	公司名称。
桌面	字符串	不适用	是	Jamboard 名称。
状态	字符串	不适用	是	示例：未分配
优先级	字符串	不适用	是	示例：优先级 3 - 正常响应
初始说明	字符串	不适用	是	不适用
所有者姓名	字符串	不适用	否	要将此支持请求分配给的 ConnectWise 会员名称。 示例：connectwise_user_1。

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
ticket_id	不适用	不适用

JSON 结果

N/A

创建工单

说明

创建 ConnectWise 工单。

参数

参数名称	类型	默认值	是否为必需属性	说明
公司	字符串	不适用	是	公司名称。
桌面	字符串	不适用	是	Jamboard 名称
摘要	字符串	不适用	是	不适用
状态	字符串	不适用	是	例如，未分配。
优先级	字符串	不适用	是	示例：优先级 3 - 正常响应
所有者姓名	字符串	不适用	否	要将此支持请求分配给的 ConnectWise 会员名称。示例：connectwise_user_1

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
ticket_id	True/False	ticket_id:False

JSON 结果

N/A

删除车票

说明

按 ID 删除 ConnectWise 工单。

参数

参数名称	类型	默认值	是否为必需属性	说明
工单 ID	字符串	不适用	是	要删除的支持请求的 ID。 示例：607167

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
is_success	True/False	is_success:False

JSON 结果

N/A

获取工单

说明

按 ID 获取 ConnectWise 支持请求，并将支持请求 JSON 作为文件附加。

参数

参数名称	类型	默认值	是否为必需属性	说明
工单 ID	字符串	不适用	是	根据 ID 提取支持请求。

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
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": "[e-mail]",
     "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": ""
            }
     }
}

Ping

说明

测试连接。

参数

不适用

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
is_success	True/False	is_success:False

JSON 结果

N/A

更新票券

说明

在 ConnectWise 中更新工单详细信息。

参数

参数名称	类型	默认值	是否为必需属性	说明
参数	类型	默认值	是必填字段	说明
工单 ID	字符串	不适用	是	要更新的支持请求的 ID。 示例：609620
摘要	字符串	不适用	否	更新了摘要。
类型名称	字符串	不适用	否	示例：应用
子类型名称	字符串	不适用	否	示例：Adobe
内容名称	字符串	不适用	否	示例：开发
状态	字符串	不适用	否	新工单状态。 示例：In Progress (plan of action)

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
ticket_id	True/False	ticket_id:False

JSON 结果

N/A

向工单添加附件

说明

在 ConnectWise 中向工单添加附件。

参数

参数名称	类型	默认值	是否为必需属性	说明
工单 ID	字符串	不适用	是	指定需要添加文档的工单的 ID。
Base64 编码的文件	字符串	不适用	是	指定需要添加为附件的 base64 编码文件。
文件名	字符串	{filename}.{extension}	是	指定附件后面的文件名。此值也用作标题。 注意：操作需要为文件提供正确的扩展名。
在客户门户中显示	复选框	勾选	否	启用后，附件会显示在客户门户中。
仅允许所有者更新	复选框	勾选	否	如果启用，则该操作仅允许所有者更新附件。

运行于

此操作会在所有实体上运行。

操作执行结果

脚本结果

脚本结果名称	值选项	示例
is_success	True/False	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"
    }
}

案例墙

结果类型	值 / 说明	类型
输出消息*	操作不应失败，也不应停止 playbook 执行： 如果报告了 201 状态代码 (is_success=true)： “已成功将文件添加为 ConnectWise 中工单 {ticket_id} 的附件。” 操作应失败并停止 playbook 执行： 如果报告了严重错误： “执行操作‘向支持请求添加附件’时出错。原因：{0}''.format(error.Stacktrace)。 如果报告了 400 状态代码：“执行操作‘将附件添加到支持请求’时出错。原因：{errors/message}。'' 如果提供的“文件名”格式无效：“执行操作‘向工单添加附件’时出错。原因：“文件名”值不符合所需格式。格式：{filename}.{extension}。	常规

作业

同步已关闭的工单和已关闭的通知

说明

同步 ConnectWise 中已关闭的工单和 Google SecOps 中已关闭的提醒。

参数

参数名称	类型	默认值	说明
API 根	字符串	不适用	不适用
公司名称	字符串	不适用	不适用
API 公钥	字符串	不适用	不适用
API 私钥	字符串	不适用	不适用
脚本名称	字符串	不适用	不适用

同步评论

说明

在 Google SecOps 支持请求与 ConnectWise 工单之间同步评论。

参数

参数名称	类型	默认值	说明
API 根	字符串	https://<主机名>/v4_6_Release/apis/3.0/	不适用
公司名称	字符串	不适用	不适用
API 公钥	字符串	不适用	不适用
API 私钥	字符串	不适用	不适用
脚本名称	字符串	不适用	不适用

需要更多帮助？从社区成员和 Google SecOps 专业人士那里获得解答。