本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

正在连接 ServiceNow

本教程指导您如何将 ServiceNow 实例连接到 AWS DevOps Agent，使其能够在创建票证时自动启动事件响应调查，并将其关键发现发布到原始票证中。它还包含有关如何配置您的 ServiceNow 实例以仅向代理空间发送特定票证以及如何协调跨多个 DevOps DevOps 代理空间的票证路由的示例。

初始设置

第一步是在 AWS DevOps 可用于访问您的 ServiceNow ServiceNow 实例的 OAuth 应用程序客户端中创建。

创建 ServiceNow OAuth 应用程序客户端

将您的 ServiceNow OAuth 客户端连接到 AWS DevOps 代理人

每个注册都连接到一个 ServiceNow 实例。要连接其他实例，请对每个实例重复此过程。

配置您的 ServiceNow 业务规则

建立连接后，您需要在中配置业务规则， ServiceNow 以便将票证发送到 DevOps 代理空间。

(function executeRule(current, previous /*null when async*/ ) {

    var WEBHOOK_CONFIG = {
        webhookSecret: GlideStringUtil.base64Encode('<<< INSERT WEBHOOK SECRET HERE >>>'),
        webhookUrl: '<<< INSERT WEBHOOK URL HERE >>>'
    };

    function generateHMACSignature(payloadString, secret) {
        try {
            var mac = new GlideCertificateEncryption();
            var signature = mac.generateMac(secret, "HmacSHA256", payloadString);
            return signature;
        } catch (e) {
            gs.error('HMAC generation failed: ' + e);
            return null;
        }
    }

    function callWebhook(payload, config) {
        try {
            var timestamp = new Date().toISOString();
            var payloadString = JSON.stringify(payload);
            var payloadWithTimestamp =`${timestamp}:${payloadString}`;

            var signature = generateHMACSignature(payloadWithTimestamp, config.webhookSecret);

            if (!signature) {
                gs.error('Failed to generate signature');
                return false;
            }

            gs.info('Generated signature: ' + signature);

            var request = new sn_ws.RESTMessageV2();
            request.setEndpoint(config.webhookUrl);
            request.setHttpMethod('POST');

            request.setRequestHeader('Content-Type', 'application/json');
            request.setRequestHeader('x-amzn-event-signature', signature);
            request.setRequestHeader('x-amzn-event-timestamp', timestamp);

            request.setRequestBody(payloadString);

            var response = request.execute();
            var httpStatus = response.getStatusCode();
            var responseBody = response.getBody();

            if (httpStatus >= 200 && httpStatus < 300) {
                gs.info('Webhook sent successfully. Status: ' + httpStatus);
                return true;
            } else {
                gs.error('Webhook failed. Status: ' + httpStatus + ', Response: ' + responseBody);
                return false;
            }

        } catch (ex) {
            gs.error('Error sending webhook: ' + ex.getMessage());
            return false;
        }
    }

    function createReference(field) {
        if (!field || field.nil()) {
            return null;
        }

        return {
            link: field.getLink(true),
            value: field.toString()
        };
    }

    function getStringValue(field) {
        if (!field || field.nil()) {
            return null;
        }
        return field.toString();
    }

    function getIntValue(field) {
        if (!field || field.nil()) {
            return null;
        }
        var val = parseInt(field.toString());
        return isNaN(val) ? null : val;
    }

    var eventType = (current.operation() == 'insert') ? "create" : "update";

    var incidentEvent = {
        eventType: eventType.toString(),
        sysId: current.sys_id.toString(),
        priority: getStringValue(current.priority),
        impact: getStringValue(current.impact),
        active: getStringValue(current.active),
        urgency: getStringValue(current.urgency),
        description: getStringValue(current.description),
        shortDescription: getStringValue(current.short_description),
        parent: getStringValue(current.parent),
        incidentState: getStringValue(current.incident_state),
        severity: getStringValue(current.severity),
        problem: createReference(current.problem),
        additionalContext: {}
    };

    incidentEvent.additionalContext = {
        number: current.number.toString(),
        opened_at: getStringValue(current.opened_at),
        opened_by: current.opened_by.nil() ? null : current.opened_by.getDisplayValue(),
        assigned_to: current.assigned_to.nil() ? null : current.assigned_to.getDisplayValue(),
        category: getStringValue(current.category),
        subcategory: getStringValue(current.subcategory),
        knowledge: getStringValue(current.knowledge),
        made_sla: getStringValue(current.made_sla),
        major_incident: getStringValue(current.major_incident)
    };

    for (var key in incidentEvent.additionalContext) {
        if (incidentEvent.additionalContext[key] === null) {
            delete incidentEvent.additionalContext[key];
        }
    }

    gs.info(JSON.stringify(incidentEvent, null, 2)); // Pretty print for logging only

    if (WEBHOOK_CONFIG.webhookUrl && WEBHOOK_CONFIG.webhookSecret) {
        callWebhook(incidentEvent, WEBHOOK_CONFIG);
    } else {
        gs.info('Webhook not configured.');
    }

})(current, previous);

如果您从 “能力提供者” 页面注册了 ServiceNow 连接，请导航到要调查 ServiceNow 事件单的 DevOps 代理空间。选择能力，然后选择通信，然后选择您在能力提供者页面上注册的 ServiceNow 实例。单个 DevOps 代理空间可以使用多个 ServiceNow 注册。要添加另一个实例，请重复此步骤。现在，一切都应该设置完毕，所有将呼叫者设置为 “问题管理员”（模仿您授予 AWS DevOps OAuth客户端的权限）的事件都将在配置 DevOps 的代理空间中触发事件响应调查。您可以通过在中创建新事件 ServiceNow 并将事件的 “来电者” 字段设置为 “问题管理员” 来对此进行测试。

ServiceNow 门票更新

在所有触发的事件响应调查中，您的 DevOps 代理将在原始通知单中提供其主要调查结果、根本原因分析和缓解计划的最新信息。特工调查结果将发布到事件评论中，我们目前仅发布类型为finding、causeinvestigation_summarymitigation_summary、和的特工记录和调查状态更新（例如AWS DevOps Agent started/finished its investigation）。

票务路由和编排示例

场景：筛选哪些事件被发送到 DevOps 代理空间

这是一个简单的场景，但需要进行一些配置 ServiceNow 才能在中创建 ServiceNow 用于跟踪事件源的字段。出于本示例的目的，使用 SNOW 表单生成器创建新的来源 (u_source) 字段。这将允许跟踪事件来源，并使用它来将请求从特定来源路由到 DevOps 代理空间。路由是通过创建 “立即服务” 业务规则并在 “何时运行” 选项卡中设置 “何时” 触发器和 “筛选条件” 来完成的。在此示例中，过滤条件设置如下：

场景：跨多个 DevOps 代理空间路由事件

此示例说明如何在紧急程度为1、类别为或服务为时在 DevOps 代理空间 B 中触发调查AWS，并在服务为、来源为时在 DevOps 代理空间 A 中触发调查Dynatrace。Software AWS

这个场景可以通过两种方式来实现。可以更新 webhook 脚本本身以包含此业务逻辑。在本场景中，我们将展示如何使用 ServiceNow 业务规则来实现这一目标，以提高透明度并简化调试。路由是通过创建两个 “立即服务” 业务规则来完成的。

现在，当您创建符合指定条件的新事件时，它将触发对 DevOps 代理空间 A 或 DevOps 代理空间 B 的调查，从而为您提供对事件路由的精细控制。