创建失败状况检查的工单

概况

为了跟踪失败的检查并使用现有工作流进行整改，请在您的票务平台中直接从失败的SaaS安全状况或账户状况检查中创建工单。这可以在Cato管理应用程序（CMA）中完成。工单包括开始整改所需的信息，无需手动复制详细信息。这简化了使用Cato管理应用程序和票务平台的团队之间的沟通。

在您创建工单后，其ID将出现在CMA中的状况检查审阅抽屉中。

工单是通过与预定义模板集成的webhook创建的。您只需配置一次集成。配置完成后，您可以使用集成创建工单。

了解工单内容

当工单从CMA中创建时，检查的名称会被用作工单标题。工单描述包括：

检查名称、描述、状态和严重程度
您的Cato账户名称和账户ID
检查的推荐操作
受影响的发现和发现的总数
在Cato管理应用程序中用于检查的链接

支持的票务平台

支持以下票务平台：

Jira
ServiceNow

创建Webhook集成

要配置Webhook集成，您需要：

在票务系统中配置必需的设置
在CMA中配置Webhook

为Jira创建Webhook集成

Prerequisites

具有 浏览空间 和 创建项目 权限的用户

步骤1：在Jira中配置必需的设置

要配置Jira中的设置：

在您的Atlassian账户中，点击右上角的个人资料，然后选择账户设置。
在安全性 标签页内的API令牌部分，点击创建和管理API令牌。
您可以创建一个具有或不具有范围的API令牌：
1. 要创建具有范围的API令牌：
  1. 点击创建具有范围的API令牌。
  2. 添加名称和到期日期。
    注意： 我们建议选择365天的最长到期日期。
  3. 点击下一步并选择Jira应用
  4. 点击下一步并选择write:jira-work范围
  5. 点击创建。
2. 创建无范围的API令牌：
  1. 点击创建API令牌。
  2. 添加名称和到期日期。
    注意： 我们建议选择365天的最长到期日期。
  3. 点击创建。
复制并保存令牌，以便输入到CMA中。
在您的Atlassian账户中，侧边栏上，点击Spaces旁边的三个点。
点击管理空格。
复制并保存您希望创建票据的空格的密钥，以便可以输入到CMA中。
如果您创建了一个具有范围的令牌，在网络浏览器中输入https://<your-site>.atlassian.net/_edge/tenant_info并复制cloudId值，以便可以输入到CMA中。
如果您没有创建范围令牌，则此步骤不必要。

步骤二：在CMA中配置Webhook

在CMA中配置Webhook：

在CMA中，导航到账户 > 订阅。
在Webhooks标签页上，点击新建。
添加名称。
从从模板开始下拉菜单中选择Jira创建姿势检查工单。
在网址字段中：
1. 对于具有范围的API令牌：https://api.atlassian.com/ex/jira/<cloudId>/rest/api/2/issue，其中<cloudId>是您在步骤1中复制的cloudId。
2. 对于无范围的API令牌：https://<your-site>.atlassian.net/rest/api/2/issue，其中<your-site>是您的Jira站点名称。
添加在步骤 1 中创建 API 令牌的用户名。
在密码字段中，输入您在步骤 1 中创建的 API 密钥。
在自定义正文部分中，将 <YOUR-SPACE-KEY> 替换为您在步骤 1 中复制的空间密钥。
（可选）如果您的空间未使用任务工作类型，或者需要新的工作项的额外字段，请相应地编辑正文。
点击测试。
在 Jira 空间中创建了一个测试工作项目，显示信息：测试成功通过。事后可删除测试工作项目。
点击保存。

创建ServiceNow的Webhook集成

Prerequisites

用户具有itil角色

步骤 1：在 ServiceNow 中配置所需设置

要配置 ServiceNow 中的设置：

以管理员身份登录您的 ServiceNow 账户，并导航至 用户管理> 用户。
点击新建。
输入用户ID和电子邮件地址，并选择仅限网络服务访问。
点击提交。
打开您创建的用户记录：
1. 点击 设置密码 然后 生成密码。复制并保存密码，以便输入到 CMA 中。
2. 点击 保存密码。
3. 在角色标签页上，点击编辑并添加itil角色。
4. 点击保存

步骤 2：在 CMA 中配置 Webhook

在 CMA 中配置 Webhook：

在 CMA 中，导航至 账户> 订阅。
在 Webhooks 标签页上，点击新建。
添加一个名称。
从 从模板开始 下拉菜单中，选择 ServiceNow 创建姿态检查工单。
在网址字段中，将<YOUR-INSTANCE-NAME>替换为您的ServiceNow实例名称，使网址为https://<instance>.service-now.com/api/now/table/incident。期间Always-On和防篡改被禁用多久。
您的实例名称是 ServiceNow 网址的第一部分。例如，如果您登录 https://acme.service-now.com，那么实例名称为 acme，网址为 https:// acme.service-now.com/api/now/table/incident。
在 用户名 字段中，输入您在步骤 1 中创建的 ServiceNow 用户的用户 ID。
在密码字段中，输入您在步骤 1 中创建的 ServiceNow 用户的密码。
（可选）在 自定义正文 部分，修改事件的默认 优先级、紧急程度 和影响，或添加字段，例如 分配组。
点击测试。
测试事件会在 ServiceNow 中创建，并显示消息“测试成功通过”。之后，您可以解决或关闭测试工作项。
点击保存。

为失败的姿态检查创建工单

创建 Webhook 集成后，您可以在 CMA 中的 姿态检查审查 抽屉中创建工单。工单最多包括 100 个发现及基本详情。如果检查包含超过100个发现或需要包含完整详情，请选择“添加链接到完整发现列表（CSV）”复选框并下载完整的发现文件为CSV格式。要在工单中包含CSV，请将其上传到共享位置，例如SharePoint，并在CMA中添加共享链接。

要为失败的姿态检查创建工单：

在CMA中，导航到主页 > 姿态。
点击您要创建工单的失败检查。
点击 创建工单。
在集成下拉菜单中，选择要用于创建工单的 Webhook 集成。
（可选）如果检查有超过 100 个发现，您可以下载 CSV 文件添加链接到共享位置。
点击 创建工单。

查看创建工单

从CMA创建工单后，工单 ID 在检查的状态检查评审抽屉中显示。

注意：工单在通过状态检查后不会自动更新。

故障排除

如果工单创建失败，错误信息显示工单系统返回的状态：

401 (未经授权)：凭据不正确或令牌已过期。检查webhook的用户名和密码字段，然后点击测试。对于Jira，使用用户的电子邮件地址和API令牌。如果令牌已过期，请创建新令牌并更新webhook的密码字段。
403 (禁止访问)：用户没有所需权限。对于Jira，确认用户在相关空间中拥有浏览空间和创建工作条目的权限。对于ServiceNow，确认用户具有itil角色。
400 (错误请求)：工单系统拒绝请求主体。检查自定义正文中是否有不正确的空间密钥或缺少必填字段。
工单 ID 缺失：工单已创建，但Cato无法从响应中读取其 ID。验证webhook的响应映射是否匹配模板。