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](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 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, 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 OAuth aplicativos (`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).
## 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](https://www.servicenow.com/docs/bundle/xanadu-platform-security/page/administer/security/task/t_CreateEndpointforExternalClients.html) 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**.
1. Escolha **Criar um endpoint de OAuth API para clientes externos**.
1. Preencha o formulário:
+ **Nome** — Um nome descritivo para o OAuth aplicativo.
+ **URL de redirecionamento** — `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
*\$1region\$1*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 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](https://www.servicenow.com/community/developer-blog/up-your-oauth2-0-game-inbound-client-credentials-with-washington/ba-p/2816891) 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`
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 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).
1. 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.**
1. Escolha **ServiceNow**e escolha o botão Adicionar (mais “\$1”).
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 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`
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 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`
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é **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\$1km\$1api). |
| 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\$1choice. |
**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](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
+ **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 como`true`. 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.