View a markdown version of this page

ServiceNow integração - Amazon Quick
Antes de começarConfigurar o ServiceNow OAuthConfigure a integração no Amazon QuickAções disponíveisLimitaçõesGerenciar e solucionar problemas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

ServiceNow integração

Use a ServiceNow integração para realizar ações em suas ServiceNow instâncias, incluindo gerenciamento de incidentes, problemas, solicitações de mudança, artigos da base de conhecimento e anexos. Essa integração usa a API ServiceNow REST. Para obter mais informações, consulte API REST na ServiceNow documentação.

A configuração dessa integração envolve duas etapas. Primeiro, você configura um aplicativo OAuth na sua ServiceNow instância. Em seguida, você cria a integração no Amazon Quick e a conecta ao seu ServiceNow aplicativo. Para obter informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Antes de configurar a integração, verifique se você tem o seguinte.

  • Um ServiceNow exemplo. Essa integração é validada em relação à versão do Xanadu.

  • Uma conta de ServiceNow usuário com permissões para criar aplicativos OAuth (adminfunção necessária).

  • Para autenticação de serviço (credenciais do cliente), sua instância deve estar executando a versão Washington DC ou posterior.

  • Para obter os requisitos de assinatura, consulteConfigurar integrações no console.

Configurar o ServiceNow OAuth

Antes de configurar o Amazon Quick, crie um endpoint do aplicativo OAuth na sua instância. ServiceNow Conclua todas as etapas a seguir ServiceNow antes de migrar para o console do Amazon Quick.

Para obter mais informações, consulte Criar um endpoint para os clientes acessarem a instância na ServiceNow documentação.

Registre o aplicativo OAuth

Para registrar o aplicativo OAuth, conclua as etapas a seguir.

  1. Na sua ServiceNow instância, navegue até Tudo > Sistema OAuth > Registro de aplicativos e escolha Novo.

  2. Escolha Criar um endpoint da API OAuth para clientes externos.

  3. Preencha o formulário:

    • Nome — Um nome descritivo para o aplicativo OAuth.

    • URL de redirecionamento — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

      {region}Substitua pela sua AWS região (por exemplo,us-east-1).

  4. Selecione Enviar.

  5. Reabra a entrada do registro do aplicativo e escolha o ícone de cadeado ao lado do Segredo do Cliente para revelar o valor.

  6. Copie os valores do ID do cliente e do segredo do cliente. Você precisa deles ao configurar a integração no Amazon Quick.

Etapas adicionais para autenticação de serviços (credenciais do cliente)

Se você planeja usar a autenticação de serviço, conclua essas etapas adicionais após registrar o aplicativo OAuth. O tipo de concessão de credenciais do cliente foi introduzido na versão de ServiceNow Washington DC. Para obter mais informações, consulte Up Your OAuth2.0 Game: Inbound Client Credentials with Washington DC in the ServiceNow Community.

  1. Ative o tipo de concessão de credenciais do cliente. Navegue até sys_properties.list usar o navegador de filtros e crie uma nova propriedade do sistema com os seguintes valores:

    • Nome: glide.oauth.inbound.client.credential.grant_type.enabled

    • Tipo: true | false

    • Value (valor): true

  2. Verifique se os seguintes plug-ins estão instalados (navegue até Administrador > Gerenciador de aplicativos):

    • OAuth 2.0 () com.snc.platform.security.oauth

    • Provedor de API REST (com.glide.rest)

    • Escopo de autenticação (com.glide.auth.scope)

    • Plug-in de escopo de autenticação da API REST () com.glide.rest.auth.scope

  3. Retorne ao seu aplicativo OAuth em System OAuth > Application Registry. Adicione o campo Usuário do aplicativo OAuth ao formulário se ele não estiver visível (use Configurar > Criador de formulários para adicioná-lo).

  4. Defina o usuário do aplicativo OAuth como um usuário com permissão adequada, como um usuário com a função de administrador do sistema.

Importante

Com a autenticação de serviço, todas as ações são executadas como o usuário configurado do aplicativo OAuth. Qualquer usuário do Amazon Quick com acesso a essa integração pode realizar ações usando as permissões dessa conta. Configure as permissões da conta de acordo com os requisitos de segurança da sua organização.

Configure a integração no Amazon Quick

Depois de concluir a configuração do ServiceNow OAuth, crie a integração no Amazon Quick.

  1. No console do Amazon Quick, escolha Conectores.

  2. Escolha a guia Criar para sua equipe.

  3. Encontre e escolha ServiceNow.

  4. Insira os detalhes da integração:

    • Nome — Nome descritivo da sua ServiceNow integração.

    • Descrição (opcional) — Objetivo da integração.

  5. Escolha seu tipo de conexão e preencha as configurações de conexão:

    1. Para Autenticação do usuário (OAuth), configure os seguintes campos:

      • URL base — https://{your-instance}.service-now.com

      • ID do cliente — ID do cliente do seu aplicativo ServiceNow OAuth.

      • Segredo do cliente — Segredo do cliente do seu aplicativo ServiceNow OAuth.

      • URL do token — https://{your-instance}.service-now.com/oauth_token.do

      • URL de autenticação — https://{your-instance}.service-now.com/oauth_auth.do

      • URL de redirecionamento — https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

    2. Para autenticação de serviço (credenciais do cliente), configure os seguintes campos:

      • Tipo de autenticação — Service-to-service OAuth

      • URL base — https://{your-instance}.service-now.com

      • ID do cliente — ID do cliente do seu aplicativo ServiceNow OAuth.

      • Segredo do cliente — Segredo do cliente do seu aplicativo ServiceNow OAuth.

      • URL do token — https://{your-instance}.service-now.com/oauth_token.do

  6. Escolha Criar e continuar.

  7. Escolha usuários com os quais compartilhar a integração.

  8. Escolha Próximo.

Para autenticação do usuário, navegue até Conectores > o nome do seu ServiceNow conector e escolha Entrar para concluir o fluxo de autorização do OAuth.

Ações disponíveis

Depois de configurar a integração, as ações a seguir estarão disponíveis.

ServiceNow ações disponíveis
Categoria Ação Description
Incidentes Listar incidentes Recupere incidentes existentes.
Incidentes Criar incidente Crie um registro de incidente para documentar um desvio de um padrão de operação esperado.
Incidentes Exibir incidente Recupere os detalhes de um incidente específico.
Incidentes Atualizar incidente Atualize um registro de incidentes.
Incidentes Excluir incidente Exclua um incidente.
Problemas Listar problemas Recupere os problemas existentes.
Problemas Criar problema Crie um novo registro de problemas.
Problemas Exibir problema Recupere os detalhes de um registro de problema específico.
Problemas Problema de atualização Atualize um registro de problemas.
Problemas Excluir problema Exclua um problema.
Solicitações de alteração Listar solicitações de alteração Recupere todas as solicitações de alteração.
Solicitações de alteração Criar solicitação de alteração Crie uma solicitação de alteração para implementar um processo controlado para modificar itens de configuração (CIs) aprovados e suportados.
Solicitações de alteração Exibir solicitação de alteração Recupere informações detalhadas sobre uma solicitação de alteração específica.
Solicitações de alteração Solicitação de alteração de atualização Modifique uma solicitação de alteração.
Solicitações de alteração Excluir solicitação de alteração Exclua uma solicitação de alteração.
Artigos da base de conhecimento Criar artigo da base de conhecimento Crie um artigo da base de conhecimento. Requer o plug-in Knowledge API (sn_km_api).
Artigos da base de conhecimento Atualizar artigo da base de conhecimento Modifique um artigo da base de conhecimento.
Artigos da base de conhecimento Excluir artigo da Base de Conhecimento Exclua um artigo da base de conhecimento.
Anexos Recuperar metadados de anexos Recupere metadados para arquivos anexos.
Anexos Recuperar metadados de anexos Recupere metadados para um arquivo anexo específico.
Anexos Recuperar conteúdo do anexo Recupere o conteúdo do anexo do arquivo binário.
Anexos Carregar anexo binário Faça upload de um arquivo binário como anexo a um registro especificado.
Anexos Carregar anexo de formulário com várias partes Faça upload de um anexo de arquivo com várias partes.
Anexos Excluir anexo Exclua um anexo.
Usuários Listar usuários Listar todos os registros do usuário.
Sistema Opções de lista Recupere os valores da lista de opções da tabela sys_choice.
nota

As ações específicas disponíveis dependem das permissões configuradas na sua ServiceNow instância e do método de autenticação usado.

Limitações

Essa integração interage ServiceNow por meio da API REST, que não impõe políticas de interface do usuário, ações de interface do usuário ou scripts do cliente. Essas regras se aplicam somente na interface ServiceNow do navegador. Server-side regras de negócios, ACLs e políticas de dados são aplicadas. Para obter mais informações, consulte API REST na ServiceNow documentação.

Gerenciar e solucionar problemas

Para editar, compartilhar ou excluir sua integração, consulteGerenciando integrações existentes.

Problemas de autenticação

  • Falha na autorização do OAuth — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores no registro do ServiceNow aplicativo. Confirme se o URL de redirecionamento ServiceNow corresponde exatamente ao URL na sua configuração do Amazon Quick.

  • Falha na autenticação do serviço — Verifique se a propriedade glide.oauth.inbound.client.credential.grant_type.enabled do sistema está definida comotrue. Confirme se o campo Usuário do aplicativo OAuth está preenchido no registro de registro do aplicativo.

Mensagens de erro comuns

  • As ações retornam erros de permissão — Verifique se o ServiceNow usuário ou o usuário do aplicativo OAuth tem as funções necessárias para acessar as tabelas de destino (por exemplo, itil função para gerenciamento de incidentes).

  • Tempo limite de conexão ou instância inacessível — Verifique se o URL base usa o nome correto da instância. ServiceNow Confirme se a ServiceNow instância está acessível e não está no modo de manutenção.