ServiceDesk Plus
集成版本：5.0
配置 ServiceDesk Plus 以与 Google Security Operations 搭配使用
- 如需生成 API 密钥，请在用户块下依次前往管理 > 技术人员。
- 如需为现有技术人员生成 API 密钥，请点击该技术人员旁边的“修改”图标。另一方面，如果您想为新技术人员生成 API 密钥，请点击添加新技术人员链接，然后输入技术人员的详细信息并提供登录权限。
- 点击 API 密钥详细信息块下的生成链接。您可以使用日历图标选择密钥的过期时间范围，也可以永久保留同一密钥。
- 如果已为技术人员生成密钥，系统会显示重新生成链接。
在 Google SecOps 中配置 ServiceDesk Plus 集成
有关如何在 Google SecOps 中配置集成的详细说明，请参阅配置集成。
集成参数
使用以下参数配置集成：
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| API 根 | 字符串 | http://{IP 或 FQDN}:8080/api/v3/ | ServiceDesk Plus 的 API 根地址。 |
操作
添加备注
说明
如果您想根据自己的观察结果向特定请求添加更多信息（包括技术信息），可以使用“添加备注”功能。您还可以使用备注来更新请求的状态。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 请求 ID | 字符串 | 不适用 | 相应请求的 ID。 |
| 注意 | 字符串 | 不适用 | 笔记的内容。 |
| 是否公开 | 复选框 | 尚未核查 | 是否公开注释。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
N/A
添加备注并等待回复
说明
添加备注，然后等待新备注添加到相应请求中。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 请求 ID | 字符串 | 不适用 | 相应请求的 ID。 |
| 注意 | 字符串 | 不适用 | 笔记的内容。 |
| 是否公开 | 复选框 | 不适用 | 是否公开注释。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| new_notes | 不适用 | 不适用 |
JSON 结果
N/A
关闭请求
说明
当请求者完全满意其请求已得到处理且报告的问题已解决时，可以关闭该请求
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 请求 ID | 字符串 | 不适用 | 相应请求的 ID。 |
| 评论 | 字符串 | 不适用 | 结束评论。 |
| 问题已确认 | 复选框 | 不适用 | 是否已确认请求的解决情况。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
N/A
创建提醒请求
说明
创建与 Google SecOps 提醒相关的请求。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 主题 | 字符串 | 不适用 | 请求的主题。 |
| 请求者 | 字符串 | 不适用 | 请求的请求者。如果未指定，则设置为 API 密钥的用户。 |
| 状态 | 字符串 | 不适用 | 请求的状态。 |
| 技术人员 | 字符串 | 不适用 | 分配给相应请求的技术人员的姓名。 |
| 优先级 | 字符串 | 不适用 | 请求的优先级。 |
| 紧急情况 | 字符串 | 不适用 | 请求的紧急程度。 |
| 类别 | 字符串 | 不适用 | 请求的类别。 |
| 请求模板 | 字符串 | 不适用 | 请求的模板。 |
| 请求类型 | 字符串 | 不适用 | 请求的类型。示例：突发事件、服务请求 |
| 截止时间（毫秒） | 字符串 | 不适用 | 请求的截止日期（以毫秒为单位）。 |
| 模式 | 字符串 | 不适用 | 请求的模式。 |
| 级别 | 字符串 | 不适用 | 请求的级别。 |
| 网站 | 字符串 | 不适用 | 请求的网站。 |
| 群组 | 字符串 | 不适用 | 请求的组。 |
| 影响 | 字符串 | 不适用 | 请求的影响。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
N/A
创建请求
说明
如果您的系统出现故障或问题，请提出问题，即向 IT 帮助台团队发送请求。您可以通过多种方式提交请求，例如使用基于 Web 的表单、发送电子邮件通知和拨打电话。ServiceDesk Plus 提供了多种选项，可用于记录以任何上述形式发起的请求的详细信息。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 主题 | 字符串 | 不适用 | 请求的主题。 |
| 请求者 | 字符串 | 不适用 | 请求的请求者。如果未指定，则设置为 API 密钥的用户。 |
| 说明 | 字符串 | 不适用 | 请求的说明。 |
| 状态 | 字符串 | 不适用 | 请求的状态。 |
| 技术人员 | 字符串 | 不适用 | 分配给相应请求的技术人员的姓名。 |
| 优先级 | 字符串 | 不适用 | 请求的优先级。 |
| 紧急情况 | 字符串 | 不适用 | 请求的紧急程度。 |
| 类别 | 字符串 | 不适用 | 请求的类别。 |
| 请求模板 | 字符串 | 不适用 | 请求的模板。 |
| 请求类型 | 字符串 | 不适用 | 请求的类型。示例：突发事件、服务请求 |
| 截止时间（毫秒） | 字符串 | 不适用 | 请求的截止日期（以毫秒为单位）。 |
| 模式 | 字符串 | 不适用 | 请求的模式。 |
| 级别 | 字符串 | 不适用 | 请求的级别。 |
| 网站 | 字符串 | 不适用 | 请求的网站。 |
| 群组 | 字符串 | 不适用 | 请求的组。 |
| 影响 | 字符串 | 不适用 | 请求的影响。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| request_id | 不适用 | 不适用 |
JSON 结果
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Get 请求
说明
检索有关请求的信息。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 请求 ID | 字符串 | 不适用 | 请求的 ID。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Ping
说明
测试与 ServiceDesk Plus 实例的连接。
参数
不适用
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 结果
N/A
更新请求
说明
更新请求。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 请求 ID | 字符串 | 不适用 | 要更新的请求的 ID。 |
| 请求者 | 字符串 | 不适用 | 请求的请求者。如果未指定，则设置为 API 密钥的用户。 |
| 说明 | 字符串 | 不适用 | 请求的说明。 |
| 状态 | 字符串 | 不适用 | 请求的状态。 |
| 技术人员 | 字符串 | 不适用 | 分配给相应请求的技术人员的姓名。 |
| 优先级 | 字符串 | 不适用 | 请求的优先级。 |
| 紧急情况 | 字符串 | 不适用 | 请求的紧急程度。 |
| 类别 | 字符串 | 不适用 | 请求的类别。 |
| 请求模板 | 字符串 | 不适用 | 请求的模板。 |
| 请求类型 | 字符串 | 不适用 | 请求的类型。示例：突发事件、服务请求 |
| 截止时间（毫秒） | 字符串 | 不适用 | 请求的截止日期（以毫秒为单位）。 |
| 模式 | 字符串 | 不适用 | 请求的模式。 |
| 级别 | 字符串 | 不适用 | 请求的级别。 |
| 网站 | 字符串 | 不适用 | 请求的网站。 |
| 群组 | 字符串 | 不适用 | 请求的组。 |
| 影响 | 字符串 | 不适用 | 请求的影响。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| 成功 | True/False | success:False |
JSON 结果
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
等待字段更新
说明
等待请求字段更改为所需值。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 请求 ID | 字符串 | 不适用 | 请求的 ID。 |
| 字段名称 | 字符串 | 不适用 | 要更新的字段的名称。 |
| 值 | 字符串 | 不适用 | 相应字段的所需值。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| new_value | 不适用 | 不适用 |
JSON 结果
N/A
等待状态更新
说明
等待请求的状态更新为所需状态。
参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| 请求 ID | 字符串 | 不适用 | 请求的 ID。 |
| 状态 | 字符串 | 不适用 | 所需的请求状态，以英文逗号分隔。 |
运行于
此操作会在所有实体上运行。
操作执行结果
实体扩充
不适用
数据分析
不适用
脚本结果
| 脚本结果名称 | 值选项 | 示例 |
|---|---|---|
| new_status | 不适用 | 不适用 |
JSON 结果
N/A
需要更多帮助？从社区成员和 Google SecOps 专业人士那里获得解答。