Tickets en ServiceNow
Con ServiceNow conectado, Raise Ticket aparece en todos los eventos. Un clic crea un incidente en la instancia de ServiceNow del propio cliente, con los detalles del evento ya rellenados.
Esta página describe la configuración del conector. Para abrir un ticket desde un evento, consulte Abrir un ticket. Para conectar ServiceNow paso a paso, consulte Conectar ServiceNow.
Quién puede usarlo
Sección titulada «Quién puede usarlo»| Requisito | Detalle |
|---|---|
| Plan | Super |
| Activado para el workspace | ITSM ticketing debe aparecer marcado en Policies, en la lista Feature flags. Está activado de forma predeterminada en un workspace Super. |
| Rol para configurarlo | Admin. ITSM aparece en Workspace, en la barra lateral, solo para los Admin. |
| Rol para abrir un ticket | Admin o Member. Los Viewer no pueden. |
Qué necesita ServiceNow
Sección titulada «Qué necesita ServiceNow»- La versión Washington DC o una posterior.
- La propiedad del sistema
glide.oauth.inbound.client.credential.grant_type.enabledcon el valortrue. - Una aplicación OAuth registrada en System OAuth → Application Registry como Application endpoint for external clients. Déjela como confidencial, no pública.
- Un OAuth Application User en ese registro, con el rol
itil. ServiceNow crea los incidentes como ese usuario.
Identiguard inicia sesión en ServiceNow con el cliente OAuth, mediante la concesión client-credentials. El ID de cliente y el secreto se almacenan cifrados.
La tarjeta ServiceNow connection
Sección titulada «La tarjeta ServiceNow connection»La página ITSM tiene una sola tarjeta, ServiceNow connection.
| Control | Qué hace |
|---|---|
| Enable ticketing | Una casilla. Cuando está marcada y guardada, Raise Ticket se muestra en el feed de eventos de este workspace. |
| ServiceNow instance URL | La dirección de la instancia, por ejemplo https://your-instance.service-now.com. Debe usar HTTPS y estar en service-now.com o servicenowservices.com. |
| OAuth client ID y OAuth client secret | Las credenciales de la aplicación OAuth. Una vez guardadas, la tarjeta las muestra enmascaradas, con Replace. |
| Assignment group | Opcional. Dirige todos los incidentes a una misma cola. Introduzca un nombre de grupo, que Identiguard busca en la instancia, o un sys_id, que se usa tal cual. |
| Caller sys_id | Opcional. El usuario de ServiceNow que se registra como solicitante. |
| Save changes | Guarda la tarjeta. El botón muestra Saving… |
| Send test incident | Crea un incidente de prueba en ServiceNow. Disponible una vez guardado el conector. |
| Disconnect | Quita el conector y elimina el cliente OAuth almacenado |
Los mensajes son ServiceNow connector saved., Test incident con el número del incidente created in ServiceNow. y ServiceNow disconnected.
El incidente de prueba se titula “Identiguard connection test - no action required” (Prueba de conexión de Identiguard, no se requiere ninguna acción) y tiene la severidad INFO. Ciérrelo en ServiceNow después de haberlo visto.
Cambiar las credenciales o la instancia
Sección titulada «Cambiar las credenciales o la instancia»- Para cambiar el ID de cliente y el secreto, elija Replace, introduzca ambos y guarde.
- Si cambia ServiceNow instance URL, la tarjeta pide de nuevo el ID de cliente y el secreto. Lo explica así: “Changing the instance URL means re-entering the OAuth client ID and secret. The stored client is only ever sent to the instance it was saved for.” (Cambiar la URL de la instancia implica volver a introducir el ID de cliente y el secreto de OAuth. El cliente almacenado solo se envía a la instancia para la que se guardó.)
Detener los tickets
Sección titulada «Detener los tickets»| Para | Haga esto |
|---|---|
| Ocultar Raise Ticket pero conservar el conector | Desmarque Enable ticketing y elija Save changes |
| Quitar el conector | Elija Disconnect. El cuadro de diálogo Disconnect ServiceNow? explica que el feed de eventos deja de ofrecer tickets de ServiceNow de inmediato y que el cliente OAuth almacenado se elimina. Los incidentes ya abiertos no se ven afectados. Elija Disconnect para confirmar. |
Cuándo aparece Raise Ticket
Sección titulada «Cuándo aparece Raise Ticket»Raise Ticket se muestra en cada fila de evento y en el detalle del evento cuando se cumple todo lo siguiente:
- El workspace está en Super e ITSM ticketing está activado.
- Un Admin ha guardado el conector de ServiceNow.
- Enable ticketing está marcado y guardado.
Un Viewer ve el botón deshabilitado.
Cuando se crea el ticket, verá ServiceNow incident con el número created. El botón muestra Raising… mientras trabaja.
Qué contiene un ticket
Sección titulada «Qué contiene un ticket»| Campo de ServiceNow | Contenido |
|---|---|
| Short description | “Identiguard:” seguido del mensaje del evento, o del tipo de evento cuando no hay mensaje. Como máximo 160 caracteres. |
| Description | Nombre del tenant, quién lo abrió, ID del tenant, ID del evento, origen, severidad, hora del evento y un enlace a la lista de eventos del workspace |
| Urgency e impact | Se definen a partir de la severidad del evento. Véase la tabla siguiente. |
| Correlation ID | Un valor que identifica el evento de Identiguard, para que el centro de servicios pueda reconocer el mismo evento abierto dos veces |
| Assignment group | El grupo del conector, si definió uno |
| Caller | El solicitante del conector, si definió uno |
De la severidad a la urgencia y el impacto
Sección titulada «De la severidad a la urgencia y el impacto»| Severidad de Identiguard | Urgencia en ServiceNow | Impacto en ServiceNow |
|---|---|---|
CRITICAL |
1 | 1 |
ERROR |
2 | 2 |
WARN |
3 | 2 |
INFO |
3 | 3 |
DEBUG |
3 | 3 |
ServiceNow calcula la prioridad del incidente a partir de la urgencia y el impacto con sus propias reglas.
Tickets por caídas de recorridos
Sección titulada «Tickets por caídas de recorridos»Cuando los tickets están activados, una caída confirmada de un recorrido también abre automáticamente un incidente en ServiceNow.
- La descripción breve empieza por “[DOWN]” e indica el tenant y el recorrido.
- La descripción indica el motivo del fallo, el número de sondas fallidas seguidas, la región y la hora a la que empezó el fallo.
- La urgencia es 2 y el impacto es 2.
- Cuando el recorrido se recupera, Identiguard añade una nota de trabajo al incidente. No cierra el incidente. Cerrarlo es decisión del centro de servicios.
Otras herramientas de tickets
Sección titulada «Otras herramientas de tickets»Hoy ServiceNow es el único conector de tickets para los clientes. Si un cliente usa otra herramienta, la respuesta habitual es enviar las alertas a Slack, Teams o correo electrónico y dejar que esa herramienta las recoja desde allí.
Solución de problemas
Sección titulada «Solución de problemas»La página y el formulario
Sección titulada «La página y el formulario»| Qué ve | Por qué | Qué hacer |
|---|---|---|
| ITSM no está en la barra lateral, o The ITSM connector is not available on this workspace plan. (El conector ITSM no está disponible en el plan de este workspace.) | El workspace no está en Super, o los tickets ITSM están desactivados para el workspace. | Suba a Super, o pregunte a un operador de la plataforma. |
| Forbidden: only workspace admins can manage the ITSM connector. (Prohibido: solo los administradores del workspace pueden gestionar el conector ITSM.) | Usted no es Admin. | Pídaselo a un Admin. |
| ServiceNow instance URL is required., …is invalid., …must use HTTPS. o …host is not allowed. (La URL de la instancia de ServiceNow es obligatoria, no es válida, debe usar HTTPS o su host no está permitido.) | La URL está vacía, no es HTTPS, o no está en service-now.com ni en servicenowservices.com. |
Corrija la URL. |
| clientId and clientSecret must be provided together. (clientId y clientSecret deben indicarse juntos.), clientId and clientSecret are required when configuring ServiceNow. (clientId y clientSecret son obligatorios al configurar ServiceNow.) o ServiceNow credentials are not configured. (Las credenciales de ServiceNow no están configuradas.) | Falta una de las credenciales, o las dos. | Introduzca tanto el ID de cliente como el secreto. |
| Changing the ServiceNow instance URL requires re-entering the OAuth client ID and secret. (Cambiar la URL de la instancia de ServiceNow exige volver a introducir el ID de cliente y el secreto de OAuth.) o The stored ServiceNow client belongs to a different instance URL. Re-enter the OAuth client ID and secret. (El cliente de ServiceNow almacenado pertenece a otra URL de instancia. Vuelva a introducir el ID de cliente y el secreto de OAuth.) | La URL de la instancia ha cambiado. | Introduzca de nuevo el ID de cliente y el secreto. |
| ServiceNow is not configured for this workspace. (ServiceNow no está configurado para este workspace.) | Ha probado o ha abierto un ticket antes de guardar el conector. | Guarde primero el conector. |
| The ServiceNow connector is turned off for this workspace. (El conector de ServiceNow está desactivado para este workspace.) | Enable ticketing no está marcado. | Márquelo y guarde. |
| Failed to save the ServiceNow connector. (No se ha podido guardar el conector de ServiceNow.) o ServiceNow test failed. (La prueba de ServiceNow ha fallado.) | El servidor no dio ningún mensaje útil. | Inténtelo de nuevo. Si continúa, indique a soporte la hora y la página. |
Mensajes de ServiceNow
Sección titulada «Mensajes de ServiceNow»Estos mensajes incluyen el estado HTTP que devolvió ServiceNow. Identiguard solo comunica el estado, así que las causas siguientes son las habituales.
| Qué ve | Por qué | Qué hacer |
|---|---|---|
| ServiceNow authentication failed (La autenticación de ServiceNow ha fallado) con un estado y un motivo | El ID de cliente o el secreto son incorrectos, el cliente es público, la concesión client-credentials no está habilitada, la versión es anterior a Washington DC, o el registro no tiene un OAuth Application User. | Compruebe cada punto de Qué necesita ServiceNow. |
| Un mensaje que termina en the instance redirected the request, and redirects are not followed (la instancia ha redirigido la solicitud, y las redirecciones no se siguen) | Algo situado delante de la instancia redirige la solicitud, o la URL es incorrecta. | Use la URL directa de la instancia. |
| ServiceNow did not return an access token. (ServiceNow no ha devuelto un token de acceso.) | El endpoint de tokens respondió sin token. | Revise el registro de la aplicación. |
| ServiceNow assignment group lookup failed (La búsqueda del grupo de asignación de ServiceNow ha fallado) con un estado | El usuario de OAuth no puede leer grupos. | Dé al usuario acceso de lectura a los grupos, o introduzca el sys_id del grupo. |
| ServiceNow assignment group con el nombre was not found on the instance. (El grupo de asignación de ServiceNow no se ha encontrado en la instancia.) | El nombre del grupo es incorrecto. | Corrija el nombre, o pegue el sys_id. |
| ServiceNow incident creation failed (La creación del incidente en ServiceNow ha fallado) con un estado | Normalmente el OAuth Application User no tiene el rol itil, el sys_id del solicitante es incorrecto, o una regla de campo obligatorio de la instancia ha rechazado el incidente. |
Corrija el rol o el campo en la instancia. |
Los problemas al abrir un ticket desde un evento están en Abrir un ticket.