Autenticação do ServiceNow

Conecte a UiPath ao ServiceNow usando nome de usuário e senha ou autenticação OAuth 2.0 no Automation Suite.

A UiPath é compatível com os seguintes tipos de autenticação para o ServiceNow:

Tipo de Autenticação	Description	Melhor para
Básico (nome de usuário/senha)	Login direto com um usuário do ServiceNow na autenticação básica HTTPS.	Configurações simples, sem OAuth, perfeitas para POCs rápidos
Concessão de senha do OAuth 2.0	O nome de usuário/senha da conta de serviço mais as credenciais do cliente do OAuth trocadas por tokens.	Integrações de serviço a serviço em que o OAuth é necessário, mas o logon interativo não é prático.

Básico (nome de usuário/senha)

Campos de conexão

Campo	Description
URL do site	URL completa da instância do ServiceNow, por exemplo, https://your-instance.service-now.com.​
Username	Nome de usuário de integração do ServiceNow.​
Senha	Senha para o usuário de integração.​

Problemas comuns

Erros 4XX

• Verificar URL da instância, nome de usuário e senha; certifique-se de que a conta esteja ativa e não bloqueada por políticas de IP/login.​
• Verifique se o usuário pode ler sys_db_object , sys_dictionary e tem as ACLs necessárias nas tabelas de destino (read/insert/update/delete).
• Certifique-se de que sua instância do ServiceNow não esteja em hibernação.

Senha do OAuth 2.0

Campos de conexão

Campo	Description
URL do site	URL completa da instância do ServiceNow.
Username	Nome de usuário da conta de serviço do ServiceNow.
Senha	Senha para essa conta de serviço.
ID do Cliente	ID do cliente do cliente OAuth do ServiceNow.​
Segredo do Cliente	Segredo do Cliente do mesmo cliente do OAuth.​

Configurar o OAuth

Observação:

O procedimento a seguir se aplica a formulários VMware, Yokohama e versões anteriores do ServiceNow. Se você estiver em Zurique ou Austrália, consulte Configurar OAuth para Zurique e Austrália (Integração de entrada).

Conclua as etapas de Configuração do OAuth na documentação do ServiceNow.

Embora as etapas documentadas sejam provavelmente as mesmas em todas as regiões da plataforma do ServiceNow, é recomendável que você siga as etapas para sua região específica caso haja diferenças.

Para referência, o procedimento a seguir explica como configuramos o OAuth para nossos exemplos.

1. Faça login na sua instância do ServiceNow (por exemplo, https://<span>dev74293.service-now.com/login</span>)
2. Acesse Definições do Sistema > Plug-ins e verifique se o Status do plug-in do OAuth está definido como Ativo.

3. Acesse OAuth do sistema > Registro do aplicativo e selecione Novo.
   • Quando perguntado Qual tipo de aplicativo do OAuth?, selecione Criar um ponto de extremidade de API do OAuth para clientes externos.

4. Digite um Nome para o aplicativo (por exemplo UiPathQuickstart) e selecione Enviar (se for bem-sucedido, você será redirecionado de volta para sua lista Registros de aplicativos ).

5. Na lista Registros de aplicativos , encontre seu novo aplicativo e selecione o Nome para abrir a página de detalhes.
6. Selecione o ícone de cadeado ao lado de Segredo do cliente para mostrar o valor.
7. Take note of the Client Id and Client Secret values.
8. Insira a seguinte URL de redirecionamento em seu campo correspondente: https://{yourDomain}/provisioning_/callback

Configurar o OAuth para Zurique e Austrália (Integração de entrada)

Para Zurique, Austrália e versões posteriores , o ServiceNow substituiu a opção Criar endpoint da API do OAuth para clientes externos por um fluxo de integração de entrada simplificado configurado por meio do Console de identidade da máquina.

Siga as etapas Configurar uma concessão de código de autorização OAuth na documentação do ServiceNow para criar uma Integração de entrada.

Ao configurar a Integração de entrada, defina o URL de redirecionamento (callback) como: https://{yourDomain}/provisioning_/callback.

Observação:

• Desmarque Permitir acesso apenas a APIs no escopo selecionado se você quiser que os controles de acesso dos usuários e as políticas de API sejam aplicados por padrão.
• Se você habilitar Permitir acesso apenas a APIs no escopo selecionado e atribuir escopos, o escopo da API de Tabelas será necessário para que a integração funcione.

Observação:

O procedimento de integração de entrada da Zurique/Austrália está documentado para o fluxo de concessão de código de autorização do OAuth. Se você estiver usando a concessão de senha do OAuth 2.0, verifique a documentação do ServiceNow para confirmar se a mesma configuração de integração de entrada também abrange a configuração do cliente de concessão de senha em sua versão do ServiceNow.

Adicionar a conexão do ServiceNow

Para criar uma conexão com sua instância do ServiceNow, você precisa realizar as seguintes etapas:

1. Selecione Integration Service no menu de navegação esquerdo.
2. Na lista Conectores , selecione ServiceNow. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Conectar ao ServiceNow .
4. Selecione seu tipo de autenticação preferido e insira as credenciais necessárias.
5. Select Connect.
6. Em seguida, insira seu nome de usuário e senha do ServiceNow. O aplicativo pede sua permissão para se conectar à sua conta do ServiceNow e para interagir com os registros. Selecione Permitir.

Para obter mais informações sobre como criar conexões com o ServiceNow, consulte a Documentação do produto ServiceNow.

Funções e permissões do ServiceNow

A tabela a seguir lista as funções e permissões mínimas necessárias para criar uma conexão e usar o conector do ServiceNow. Os requisitos se aplicam a todos os tipos de autenticação.

Tabela do ServiceNow	Operação	Motivo do acesso
Tabelas (sys_db_object)	Ler	O módulo/tabela de Tabelas funciona como um repositório que contém uma linha correspondente a cada tabela em sua instância do ServiceNow. É utilizado para compilar uma lista de tabelas com a finalidade de executar ações ou disparar eventos. Isso é necessário para carregar todas as suas tabelas ao usar o menu suspenso Selecionar Objeto para suas atividades de CRUD.
Dicionário (sys_dictionary)	Ler	Esta tabela abrange dados sobre as respectivas colunas de uma tabela específica na sua instância do ServiceNow. Esta tabela é necessária para carregar os campos de entrada e saída quando você seleciona uma tabela para realizar uma ação.
Opções (sys_choice)	Ler	A tabela Escolha contém valores para opções que aparecem em listas de escolha e também para pesquisas em nossas atividades selecionadas. Sem isso, as buscas de tempo de design em nossas atividades não serão carregadas.
Usuário (sys_user)	Ler	A tabela Escolha contém texto traduzido para opções que aparecem em listas de escolha e também para pesquisas em nossas atividades selecionadas. Sem isso, as pesquisas relacionadas ao usuário do tempo de design em nossas atividades falharão no carregamento.

Além disso, o usuário também deve possuir o controle de acesso necessário para as tabelas essenciais para o cenário de integração. Por exemplo, se você pretende estabelecer um usuário de integração capaz de executar ações típicas do suporte técnico do IIL (por exemplo, abrir, atualizar e fechar incidentes, problemas, alterações e itens de gerenciamento de configuração), você deve atribuir a função itil .

Criando Funções Personalizadas

Certas funções do sistema Base, como admin já abrangem o controle de acesso para essas tabelas. Mas, se você não quiser atribuir funções de sistema básicas e pretende fornecer apenas o controle de acesso essencial necessário para usar o conector do ServiceNow, você pode considerar criar uma função personalizada com as permissões de acesso necessárias.

Para conceder acesso exclusivamente a tabelas ou tabelas específicas não cobertas pelas funções padrão do sistema de base, recomendamos a criação de funções personalizadas e a atribuição do controle de acesso apropriado, conforme necessário.

Você deve fornecer as novas funções com os controles de acesso listados na tabela a seguir para que possam usar o conector/atividades do ServiceNow. Por exemplo, um usuário sem permissões de administrador requer a função personalize_dictionary para acessar a tabela sys_dictionary .

Tabela	Tipo	Operação
Tabelas (sys_db_object)	Registro	Ler
Dicionário (sys_dictionary)	Registro	Ler
Opções (sys_choice)	Registro	Ler
Usuário (sys_user)	Registro	Ler
Classes do campo (sys_glide_object)	Registro	Ler

Observação:

Editar ou criar o controle de acesso é um recurso exclusivo de um usuário que possui a função security\_admin . Se você tiver alguma dúvida, é recomendável consultar seu administrador do ServiceNow. Você pode encontrar informações adicionais em funções de privilégio elevado.

Para realizar execuções de atividades ou gatilhos, você também precisa fornecer outros controles de acesso.

Por exemplo, se seu cenário específico envolver a inicialização de um fluxo de trabalho com um incidente do ServiceNow ou a criação de um incidente do ServiceNow, os seguintes controles de acesso precisarão ser concedidos.

Tabela	Tipo	Operação
Incident	Registro	Ler
Incident	Registro	Gravar