Tickets no ServiceNow
Com o ServiceNow ligado, Raise Ticket (abrir ticket) aparece em todos os eventos. Um clique cria um incidente na instância do ServiceNow do próprio cliente, com os detalhes do evento preenchidos.
Esta página descreve as definições do conector. Para abrir um ticket a partir de um evento, consulte Abrir um ticket. Para ligar o ServiceNow passo a passo, consulte Ligar o ServiceNow.
Quem pode utilizar
Seção intitulada “Quem pode utilizar”| Requisito | Detalhe |
|---|---|
| Plano | Super |
| Ligado para o workspace | ITSM ticketing tem de mostrar um visto em Policies, na lista Feature flags. Está ligado por predefinição num workspace Super. |
| Função para configurar | Admin. ITSM aparece em Workspace na barra lateral apenas para admins. |
| Função para abrir um ticket | Admin ou membro. Os visualizadores não podem. |
O que o ServiceNow necessita
Seção intitulada “O que o ServiceNow necessita”- A versão Washington DC ou mais recente.
- A propriedade de sistema
glide.oauth.inbound.client.credential.grant_type.enableddefinida comotrue. - Uma aplicação OAuth registada em System OAuth → Application Registry como Application endpoint for external clients. Deixe-a confidencial, não pública.
- Um OAuth Application User nesse registo, com a função
itil. O ServiceNow cria os incidentes como esse utilizador.
O Identiguard inicia sessão no ServiceNow com o cliente OAuth, através da concessão client-credentials. O client ID e o segredo são guardados encriptados.
O cartão ServiceNow connection
Seção intitulada “O cartão ServiceNow connection”A página ITSM tem um único cartão, ServiceNow connection.
| Controlo | O que faz |
|---|---|
| Enable ticketing | Uma caixa de seleção. Quando está assinalada e guardada, Raise Ticket é mostrado no feed de eventos deste workspace. |
| ServiceNow instance URL | O endereço da instância, por exemplo https://your-instance.service-now.com. Tem de utilizar HTTPS e estar em service-now.com ou servicenowservices.com. |
| OAuth client ID e OAuth client secret | As credenciais da aplicação OAuth. Depois de guardadas, o cartão mostra-as mascaradas, com Replace. |
| Assignment group | Opcional. Encaminha todos os incidentes para uma fila. Introduza o nome de um grupo, que o Identiguard procura na instância, ou um sys_id, que é utilizado tal como está. |
| Caller sys_id | Opcional. O utilizador do ServiceNow registado como autor do pedido. |
| Save changes | Guarda o cartão. O botão mostra Saving… |
| Send test incident | Cria um incidente de teste no ServiceNow. Disponível depois de o conector estar guardado. |
| Disconnect | Remove o conector e elimina o cliente OAuth guardado |
As mensagens são ServiceNow connector saved. (conector do ServiceNow guardado), Test incident com o número do incidente created in ServiceNow. (incidente de teste criado no ServiceNow) e ServiceNow disconnected. (ServiceNow desligado).
O incidente de teste tem o título “Identiguard connection test - no action required” (teste de ligação do Identiguard, nenhuma ação necessária) e a severidade INFO. Feche-o no ServiceNow depois de o ter visto.
Alterar as credenciais ou a instância
Seção intitulada “Alterar as credenciais ou a instância”- Para alterar o client ID e o segredo, escolha Replace, introduza ambos e guarde.
- Se alterar o ServiceNow instance URL, o cartão pede de novo o client ID e o segredo. Explica: “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.” (alterar o URL da instância obriga a introduzir de novo o client ID e o segredo OAuth; o cliente guardado só é enviado para a instância para a qual foi guardado)
Parar a abertura de tickets
Seção intitulada “Parar a abertura de tickets”| Para | Faça isto |
|---|---|
| Ocultar Raise Ticket mas manter o conector | Desmarque Enable ticketing e escolha Save changes |
| Remover o conector | Escolha Disconnect. O diálogo Disconnect ServiceNow? explica que o feed de eventos deixa de imediato de oferecer tickets do ServiceNow e que o cliente OAuth guardado é eliminado. Os incidentes já abertos não são afetados. Escolha Disconnect para confirmar. |
Quando aparece Raise Ticket
Seção intitulada “Quando aparece Raise Ticket”Raise Ticket é mostrado em cada linha de evento e no detalhe do evento quando todas estas condições se verificam:
- O workspace está no plano Super e ITSM ticketing está ligado.
- Um admin guardou o conector do ServiceNow.
- Enable ticketing está assinalado e guardado.
Um visualizador vê o botão desativado.
Quando o ticket é criado, vê ServiceNow incident com o número e created. (incidente do ServiceNow criado). O botão mostra Raising… enquanto trabalha.
O que contém um ticket
Seção intitulada “O que contém um ticket”| Campo do ServiceNow | Conteúdo |
|---|---|
| Short description | “Identiguard:” seguido da mensagem do evento, ou do tipo de evento quando não há mensagem. No máximo 160 caracteres. |
| Description | Nome do tenant, quem o abriu, ID do tenant, ID do evento, origem, severidade, hora do evento e uma ligação para a lista de eventos do workspace |
| Urgency e impact | Definidos a partir da severidade do evento. Veja a tabela abaixo. |
| Correlation ID | Um valor que identifica o evento do Identiguard, para que o service desk reconheça o mesmo evento aberto duas vezes |
| Assignment group | O grupo do conector, se o definiu |
| Caller | O autor do pedido do conector, se o definiu |
Da severidade para a urgência e o impacto
Seção intitulada “Da severidade para a urgência e o impacto”| Severidade no Identiguard | Urgência no ServiceNow | Impacto no ServiceNow |
|---|---|---|
CRITICAL |
1 | 1 |
ERROR |
2 | 2 |
WARN |
3 | 2 |
INFO |
3 | 3 |
DEBUG |
3 | 3 |
O ServiceNow calcula a prioridade do incidente a partir da urgência e do impacto, com as suas próprias regras.
Tickets para falhas de jornadas
Seção intitulada “Tickets para falhas de jornadas”Quando a abertura de tickets está ligada, uma falha confirmada de uma jornada abre também automaticamente um incidente no ServiceNow.
- A descrição curta começa por “[DOWN]” e indica o tenant e a jornada.
- A descrição indica o motivo da falha, o número de sondas falhadas seguidas, a região e a hora em que a falha começou.
- A urgência é 2 e o impacto é 2.
- Quando a jornada recupera, o Identiguard acrescenta uma nota de trabalho ao incidente. Não fecha o incidente. Fechá-lo é uma decisão do service desk.
Outras ferramentas de tickets
Seção intitulada “Outras ferramentas de tickets”Atualmente o ServiceNow é o único conector de tickets para clientes. Se um cliente utilizar outra ferramenta, a resposta habitual é enviar os alertas para o Slack, o Teams ou o email e deixar que essa ferramenta os recolha a partir daí.
Resolução de problemas
Seção intitulada “Resolução de problemas”A página e o formulário
Seção intitulada “A página e o formulário”| O que vê | Porquê | O que fazer |
|---|---|---|
| ITSM não está na barra lateral, ou The ITSM connector is not available on this workspace plan. (o conector ITSM não está disponível no plano deste workspace) | O workspace não está no plano Super, ou o ITSM ticketing está desligado para o workspace. | Atualize para o plano Super, ou peça a um operador da plataforma. |
| Forbidden: only workspace admins can manage the ITSM connector. (proibido: só os admins do workspace podem gerir o conector ITSM) | Não é admin. | Peça a um admin. |
| ServiceNow instance URL is required., …is invalid., …must use HTTPS. ou …host is not allowed. (o URL da instância do ServiceNow é obrigatório, é inválido, tem de utilizar HTTPS, ou o anfitrião não é permitido) | O URL está vazio, não é HTTPS, ou não está em service-now.com ou servicenowservices.com. |
Corrija o URL. |
| clientId and clientSecret must be provided together. (o clientId e o clientSecret têm de ser indicados em conjunto), clientId and clientSecret are required when configuring ServiceNow. (o clientId e o clientSecret são obrigatórios ao configurar o ServiceNow) ou ServiceNow credentials are not configured. (as credenciais do ServiceNow não estão configuradas) | Falta uma das credenciais, ou ambas. | Introduza o client ID e o segredo. |
| Changing the ServiceNow instance URL requires re-entering the OAuth client ID and secret. (alterar o URL da instância obriga a introduzir de novo o client ID e o segredo OAuth) ou The stored ServiceNow client belongs to a different instance URL. Re-enter the OAuth client ID and secret. (o cliente guardado pertence a outro URL de instância; introduza de novo o client ID e o segredo OAuth) | O URL da instância mudou. | Introduza de novo o client ID e o segredo. |
| ServiceNow is not configured for this workspace. (o ServiceNow não está configurado para este workspace) | Testou ou abriu um ticket antes de o conector estar guardado. | Guarde primeiro o conector. |
| The ServiceNow connector is turned off for this workspace. (o conector do ServiceNow está desligado para este workspace) | Enable ticketing não está assinalado. | Assinale-o e guarde. |
| Failed to save the ServiceNow connector. (falha ao guardar o conector do ServiceNow) ou ServiceNow test failed. (o teste do ServiceNow falhou) | O servidor não devolveu uma mensagem utilizável. | Tente de novo. Se continuar, indique ao suporte a hora e a página. |
Mensagens do ServiceNow
Seção intitulada “Mensagens do ServiceNow”Estas mensagens incluem o estado HTTP que o ServiceNow devolveu. O Identiguard comunica apenas o estado, pelo que as causas abaixo são as habituais.
| O que vê | Porquê | O que fazer |
|---|---|---|
| ServiceNow authentication failed (a autenticação no ServiceNow falhou) com um estado e um motivo | O client ID ou o segredo está errado, o cliente é público, a concessão client-credentials não está ativada, a versão é anterior à Washington DC, ou o registo não tem um OAuth Application User. | Verifique cada ponto em O que o ServiceNow necessita. |
| Uma mensagem terminada em the instance redirected the request, and redirects are not followed (a instância redirecionou o pedido, e os redirecionamentos não são seguidos) | Algo à frente da instância redireciona o pedido, ou o URL está errado. | Utilize o URL direto da instância. |
| ServiceNow did not return an access token. (o ServiceNow não devolveu um token de acesso) | O endpoint de tokens respondeu sem um token. | Verifique o registo no Application Registry. |
| ServiceNow assignment group lookup failed (a procura do grupo de atribuição falhou) com um estado | O utilizador OAuth não consegue ler grupos. | Dê ao utilizador acesso de leitura aos grupos, ou introduza o sys_id do grupo. |
| ServiceNow assignment group com o nome e was not found on the instance. (o grupo de atribuição não foi encontrado na instância) | O nome do grupo está errado. | Corrija o nome, ou cole o sys_id. |
| ServiceNow incident creation failed (a criação do incidente no ServiceNow falhou) com um estado | Normalmente o OAuth Application User não tem a função itil, o sys_id do autor do pedido está errado, ou uma regra de campo obrigatório na instância recusou o incidente. |
Corrija a função ou o campo na instância. |
Os problemas ao abrir um ticket a partir de um evento estão em Abrir um ticket.