ServiceNow integração - Amazon Quick
Antes de começarConfigure 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 o 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 OAuth aplicativo 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 OAuth aplicativos (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.

Configure ServiceNow OAuth

Antes de configurar o Amazon Quick, crie um endpoint de OAuth aplicativo na sua ServiceNow instância. 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 OAuth aplicativo

Para registrar o OAuth aplicativo, 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 de OAuth API para clientes externos.

  3. Preencha o formulário:

    • Nome — Um nome descritivo para o OAuth aplicativo.

    • 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 OAuth aplicativo. 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 OAuth2 Your .0 Game: Inbound Client Credentials with Washington DC in the Community. ServiceNow

  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 OAuth aplicativo em Sistema OAuth > Registro de aplicativos. Adicione o campo Usuário do OAuth aplicativo 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 OAuth aplicativo 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 do OAuth aplicativo configurado. 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 ServiceNow OAuth configuração, crie a integração no Amazon Quick.

  1. No console do Amazon Quick, escolha Integrações.

  2. Escolha ServiceNowe escolha o botão Adicionar (mais “+”).

  3. Insira os detalhes da integração:

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

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

  4. 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 ServiceNow OAuth aplicativo.

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

      • 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 ServiceNow OAuth aplicativo.

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

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

  5. Escolha Criar e continuar.

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

  7. Escolha Próximo.

Para autenticação do usuário, navegue até Integrações > Ações > seu nome de ServiceNow integração e escolha Entrar para concluir o fluxo de OAuth autorização.

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 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 aprovados e suportados (CIs).
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 do anexo 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. As regras de negócios e as políticas de dados do lado do servidor são aplicadas. ACLs 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

  • OAuth falha na autorização — 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 OAuth aplicativo está preenchido no registro do registro do aplicativo.

Mensagens de erro comuns

  • As ações retornam erros de permissão — Verifique se o ServiceNow usuário ou usuário do OAuth aplicativo 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.