Resumen

ServiceNowLa integración le permite:

  • Automáticamentecrear un incidente en ServiceNowal crear un incidente en Rootly.
  • Automáticamenteactualizar un incidente existente en ServiceNowal actualizar un incidente en Rootly.
  • Automáticamentecrear un incidente en Rootlyal crear un incidente en ServiceNow.
  • Automáticamenteactualizar un incidente existente en Rootlyal actualizar un incidente en ServiceNow.
  • Automáticamentenotificar al usuario de guardiaal crear un incidente en ServiceNow.

Establecer acceso de escritura a ServiceNow

Rootly se integra con ServiceNow a través de OAuth, permitiendo a Rootly crear y actualizar la tabla INC en ServiceNow.

Se recomienda realizar esta integración utilizando una cuenta de servicio para garantizar una conexión ininterrumpida, en caso de que el usuario que realiza la integración abandone la empresa.

Inicie sesión en su organización de Rootlycomo usuario Administrador y navegue aConfiguraciones>Integraciones>ServiceNow.

Haga clic enConfigurarpara abrir el modal de configuración.

Inicie sesión en su instancia de ServiceNowcomo usuario Administrador y navegue a **System OAuth **>Application Registry.

Haga clic enNuevopara iniciar la creación de una nueva aplicación.

Seleccione la opciónCrear un punto final de API OAuth para clientes externos.

Copie y pegue los siguientes valores en los campos correspondientes en ServiceNow y luego haga clic enEnviar.

Campo de ServiceNowValor
NameRootly
Redirect URLhttps://rootly.com/auth/service_now/callback

Localice y abra la nueva aplicación que acaba de crear en ServiceNow. Es posible que tenga que buscarla por Nombre si ya tiene muchas aplicaciones.

Copie los siguientes campos de ServiceNow.

Al copiar elClient Secret, es posible que tenga que desenmascararlo (haciendo clic en el icono del candado) y realizar un arrastre manual > clic derecho > Copiar. A veces los valores enmascarados no se copian correctamente en ServiceNow.

Pegue los campos copiados en su modal de configuración de Rootly y haga clic enConectar.

Se le presentará una pantalla de ServiceNow para proceder con la integración. Haga clic enPermitir.

Si la integración es exitosa, se le presentará esta pantalla en Rootly.

Puede hacer clic enGuardary ¡listo! Su tarjeta de ServiceNow debería aparecer con un indicador deConectadocuando esté en lapágina de Integraciones.

Establecer la capacidad de recibir eventos de ServiceNow

Los webhooks se configuran en ServiceNow para enviar eventos de incidentes a Rootly. Rootly puede entonces procesar estos eventos para facilitar acciones automatizadas.

Navegue a su instancia de ServiceNow y vaya a **System Definition **>Business Rules.

Hay múltiples páginas deBusiness Rules. Asegúrese de seleccionar la que está bajoSystem Definition.

Haga clic enNuevopara iniciar la creación de una nueva regla de negocio.

Complete los siguientes campos.

Campo de ServiceNowValor
NameDele cualquier nombre descriptivo que desee.
TableSeleccioneIncident [incident].
AdvancedAsegúrese de que esto esté marcado.
WhenSeleccioneAfter.
InsertMarque esto si desea recibir un evento después de que se crea un incidente en ServiceNow.
UpdateMarque esto si desea recibir un evento después de que se actualiza un incidente en ServiceNow.
DeleteMarque esto si desea recibir un evento después de que se elimina un incidente en ServiceNow.

Navegue a la pestañaAvanzado.

Reemplace el contenido en el editor deScriptcon el siguiente código.

(function executeRule(current, previous /*null when async*/ ) {
    try {
        var r = new sn_ws.RESTMessageV2();
        r.setEndpoint("<insert webhook public URL>");
        r.setHttpMethod("post");
        r.setRequestHeader("secret", "<secret>");

        // getValue(string) does not support dot walking, 
        // so I had to do a bit more to get the user’s email address
        var usr = new GlideRecord('sys_user');
        usr.get('sys_id', current.getValue("caller_id"));
        var reported_by_email = usr.getValue('email');

        // Make sure to convert object references to values.
        // More info at: 
        // https://swissbytes.blogspot.com/2017/11/service-now-script-includes-make-sure.html

        var number = current.getValue("number");		
        var opened_at = current.getValue("opened_at");
        var impact = current.getValue("impact");
        var urgency = current.getValue("urgency");
        var short_description = current.getValue("short_description");
        var description = current.getValue("description");
        var category = current.getValue("category");
        var priority = current.getValue("priority");
        var sys_id = current.getValue("sys_id");
        var subcategory = current.getValue("subcategory");
        var state = current.getValue("state");

        var obj = {
            "number": number,
            "reported_by_email": reported_by_email,
            "opened_at": opened_at,
            "impact": impact,
            "urgency": urgency,
            "short_description": short_description,
            "description": description,
            "category": category,
            "priority": priority,
            "sys_id": sys_id,
            "subcategory": subcategory,
            "state": state
        };
        
        var body = JSON.stringify(obj);
        gs.info("Webhook body: " + body);
        r.setRequestBody(body);

        var response = r.execute();
        var httpStatus = response.getStatusCode();
    } catch (ex) {
        var message = ex.message;
        gs.error("Error message: " + message);
    }

    gs.info("Webhook target HTTP status response: " + httpStatus);

})(current, previous);

Reemplace<insert webhook public URL>y<secret>los textos de marcador de posición con los valores reales de la página de integración de ServiceNow de Rootly.

Haga clic enEnviar. ¡Ahora está listo para recibir eventos de ServiceNow en Rootly!

Desinstalar

Puededesinstalaresta integración navegando aConfiguración>Integraciones> **ServiceNow **>Eliminar.

Usar ServiceNow como fuente de alertas

Si su organización está utilizando Rootly On-Call, ServiceNow también se puede configurar como una fuente de alertas. Esto permite que su usuario de guardia sea notificado cada vez que se crea un ticket en ServiceNow.

Su organización de Rootly debe tener Rootly On-Call habilitado para realizar esta configuración.

Soporte

Si necesita ayuda o más información sobre esta integración, por favor contacte asupport@rootly.com.