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](https://docs.servicenow.com/bundle/xanadu-api-reference/page/build/applications/concept/api-rest.html) 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, consulte[Métodos de autenticação](quick-action-auth.md).
## 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 (`admin`funçã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, consulte[Configurar integrações no console](integration-console-setup-process.md).
## 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](https://www.servicenow.com/docs/bundle/xanadu-platform-security/page/administer/security/task/t_CreateEndpointforExternalClients.html) 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.**
1. Escolha **Criar um endpoint da API OAuth para clientes externos**.
1. 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`).
1. Selecione **Enviar**.
1. Reabra a entrada do registro do aplicativo e escolha o ícone de cadeado ao lado **do Segredo do Cliente** para revelar o valor.
1. 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](https://www.servicenow.com/community/developer-blog/up-your-oauth2-0-game-inbound-client-credentials-with-washington/ba-p/2816891) 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`
1. 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`
1. **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).
1. 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**.
1. Escolha a guia **Criar para sua equipe**.
1. Encontre e escolha **ServiceNow**.
1. Insira os detalhes da integração:
+ **Nome — Nome** descritivo da sua ServiceNow integração.
+ **Descrição** (opcional) — Objetivo da integração.
1. 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`
1. 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`
1. Escolha **Criar e continuar**.
1. Escolha usuários com os quais compartilhar a integração.
1. 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](https://docs.servicenow.com/bundle/xanadu-api-reference/page/integrate/inbound-rest/concept/c_RESTAPI.html) na ServiceNow documentação.
## Gerenciar e solucionar problemas
Para editar, compartilhar ou excluir sua integração, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).
### 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 como`true`. 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.