ServiceNow: 配置与XOps事件的集成

在Cato管理应用程序中，创建字段以便在工单记载时填充。

要创建自定义字段：

1. 登录到ServiceNow平台。

2. 打开任何事件。

3. 从顶部横幅，右键单击并导航到配置 > 表单生成器。

4. 如果需要，请同意试用Form Builder，并选择默认视图。

5. 点击 在事件表中添加新字段。

6. 添加这些字段：

   • CMA账户ID

     • 类型：整数

     • 属性：只读、必填、活跃

   • CMA事件ID

     • 类型：字符串

     • 属性：只读、必填、活跃

服务API密钥启用与外部工具和服务的可扩展集成，格式如下：R=<...>|K=<...>。 欲了解有关如何创建服务API密钥的更多信息，请参见为Cato API生成API密钥。

创建服务API密钥后，将其复制并保存，以便可输入到ServiceNow平台。

在ServiceNow平台中，创建一个安全的系统属性以存储API密钥。

要创建一个安全的系统属性：

1. 导航到 https://<your instance>.service-now.com/sys_properties_list.do

2. 新建集成 面板打开。

3. 在 系统属性新记录 表单中，添加以下详细信息：

   

   • 名称：cma_prod_api_key

   • 类型：密码2

   • 值：您在步骤2中创建的服务API密钥

4. 点击 提交。

创建一个REST消息以发送ServiceNow事件的详细信息到Cato：

要创建REST消息：

1. 在您的ServiceNow平台中，导航到 全部>系统Web服务 > 出站 > REST 消息。

2. 新建集成 面板打开。

3. 在 REST 消息 表单中，添加以下详细信息：

   • 名称：为REST消息添加一个名称

   • 端点：https://<您的Cato账户名称>.cc.catonetworks.com/api/v1/graphql2

   • 认证类型：无认证

   • HTTP方法：点击 新建 并添加以下详细信息：

     • 名称：添加一个名称

     • HTTP方法：POST

     • 端点：https://<您的Cato账户名称>.cc.catonetworks.com/api/v1/graphql2

4. 点击提交。

创建一个触发REST消息的业务规则。

要创建业务规则：

1. 在您的ServiceNow平台中，导航到 全部 > 系统定义 > 业务规则。

2. 单击 新建。

3. 在 业务规则新记录 表单中，添加以下详细信息：

   

   • 名称：为业务规则添加一个名称

   • 表：事件

   • 时间：之后

   • 更新：为真（选中复选框）

   • 过滤条件：备注变更

4. 在 高级 标签上，添加此脚本：

   (function executeRule(current, previous) {
     try {
       var lastComment = current.comments.getJournalEntry(1) || '';
       lastComment = stripJournalHeader(lastComment);
       if (!lastComment) {
         gs.info("GraphQL webhook: Empty comment, skipping " + current.number);
         return;
       }
       var accountId = current.u_cma_account_id;
       var storyId = current.u_cma_story_id;
           gs.info("GraphQL webhook: accountId " + accountId + " story " + storyId);
       if (!accountId || !storyId) {
         gs.error("GraphQL webhook: Missing accountId/storyId for " + current.number);
         return;
       }
       var gqlQuery =
         "mutation CreateStoryComment($accountId: ID!, $input: AddStoryCommentInput!) {" +
         "  xdr(accountId: $accountId) {" +
         "    addStoryComment(input: $input) {" +
         "      comment { id type __typename }" +
         "      __typename" +
         "    }" +
         "    __typename" +
         "  }" +
         "}";
       var body = {
         query: gqlQuery,
         variables: {
           accountId: accountId.toString(),
           input: {
             type: "USER",
             storyId: storyId.toString(),
             text: lastComment
           }
         }
       };
           var apiKey = gs.getProperty('cma_prod_api_key');
       var r = new sn_ws.RESTMessageV2('Update XDR story comments CMA Prod', 'post');
       r.setRequestHeader('Content-Type', 'application/json');
       r.setRequestHeader('Accept', 'application/json');
           r.setRequestHeader('x-api-key', apiKey);
       r.setRequestBody(JSON.stringify(body));
       //var response = r.execute(); // can be changed to Async - only for debug purposes
           var eccSysId = r.executeAsync();
       gs.info("GraphQL webhook queued, ECC sys_id=" + eccSysId);
       var status = response.getStatusCode();
       var responseBody = response.getBody();
     // Safe logging (see next section for masking)
        gs.info("GraphQL webhook: status=" + status);
        gs.info("GraphQL webhook: responseBody=" + responseBody);
     } catch (ex) {
       gs.info("GraphQL webhook: Failed: " + ex.message);
     }
     function stripJournalHeader(text) {
       text = text || '';
       if (text.indexOf('\n') > -1) {
         return text.split('\n').slice(1).join('\n').trim();
       }
       return text.trim();
     }
   })(current, previous);

5. 点击 提交。