Autenticação do ServiceNow

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
Código de autorização do OAuth 2.0	O usuário faz logon no ServiceNow e concede acesso a um cliente do OAuth configurado no ServiceNow.	Cenários delegados pelo usuário em produção que precisam de uma governança forte e revogação fácil.
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.

Código de autorização do OAuth 2.0

Esse método concede acesso à UiPath emitindo um token de acesso em vez de exigir seu nome de usuário e senha como campos de conexão.

Observação:

• O fluxo de concessão de código de autorização do OAuth 2.0 é compatível apenas com o ServiceNow Identity e versões posteriores.
• O URL de retorno de chamada para seu aplicativo deve ser definido com o valor exibido na página de criação de conexão do Integration Service, por exemplo https://cloud.uipath.com/provisioning_/callback para Automation Cloud. Consulte Configurar o OAuth para obter mais detalhes.
• Para VMware, Yokohama e versões anteriores , use a opção Criar endpoint da API do OAuth para clientes externos no Registro do aplicativo. Os aplicativos existentes com o OAuth 2.0 configurados dessa maneira continuam a funcionar.
• Para Zurique e Austrália, o ServiceNow descontinuou a opção Criar endpoint da API do OAuth para clientes externos em favor da nova configuração simplificada de Integração de entrada no Console de identidade da máquina. Consulte Configurar o OAuth para Zurique e Austrália (Integração de entrada) para obter orientação.

Campos de conexão

Campo	Description
URL do site	URL completa da instância do ServiceNow (por exemplo, https://your-instance.service-now.com).​
ID do Cliente	ID do cliente do cliente OAuth do Application Registry do ServiceNow usado pela UiPath.​
Segredo do cliente	Segredo do Cliente do mesmo cliente do OAuth.​

Problemas comuns

• Incompatibilidade de URL de redirecionamento ou erro de redirecionamento inválido

  Confirme se a URL de redirecionamento configurada no cliente OAuth do ServiceNow corresponde exatamente à URL de retorno de chamada exibida na UiPath (esquema, host, caminho e barra à direita).​

• Já autenticado no ServiceNow: a página Aceitar/Negar aparece em vez da tela de logon

  Esse comportamento é esperado quando seu navegador já tem uma sessão ativa do ServiceNow. Nesse caso, o ServiceNow ignora a tela de login e exibe diretamente a página Consentimento do OAuth (Aceitar/Negar).

  • Se esta for a conta correta, clique em Aceitar para concluir a conexão.
  • Se você precisar usar uma conta diferente, saia do ServiceNow em outra guia do navegador ou tente novamente o fluxo em uma janela anônima/privada e, em seguida, faça login com o usuário pretendido.

  Quando o SSO está habilitado

  Em algumas configurações de SSO, não aparecem nem a tela de login nem a página Aceitar/Negar consentimento. O ServiceNow supõe o usuário autenticado no momento e prossegue com a criação da conexão, que pode falhar devido à falta de permissões.

  Nesse cenário, use uma janela anônima/privada para garantir que você possa autenticar com o usuário correto e as permissões necessárias.

• O logon e a autorização foram bem-sucedidos, mas a criação da conexão falhou

  O usuário de autorização não tem ACLs em uma ou mais tabelas usadas pelo conector. Conceda acesso de leitura aos metadados (sys_db_object, sys_dictionary) e leia/grave ACLs para as tabelas de negócios relevantes e, em seguida, refaça o teste.​

• A conexão funcionava anteriormente, mas agora falha com erros de autenticação ou token

  Os tokens de acesso ou atualização podem ter expirado ou sido revogados (por exemplo, após alterações na senha ou no cliente do OAuth). Reabra a conexão no UiPath e autorize novamente. Se o problema persistir, verifique se o cliente OAuth do ServiceNow foi modificado ou removido.

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 o URL de redirecionamento exibido na página de criação de conexão do Integration Service, por exemplo, https://cloud.uipath.com/provisioning_/callback para o Automation Cloud.

   

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 redirecionamento (URL de retorno de chamada) como: https://{baseURL}/provisioning_/callback (por exemplo, https://cloud.uipath.com/provisioning_/callback para Automation Cloud).

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.

Ciclo de vida do token para o OAuth2.0 Código de autorização

Durante a criação da conexão, a UiPath redireciona o usuário para o ServiceNow; o usuário faz login e aprova o cliente OAuth. A UiPath troca o código de autorização por um token de acesso e um token de atualização, armazenando-os com segurança.​

Os tokens de acesso são de curta duração; A UiPath usa automaticamente o token de atualização para obter novos tokens de acesso até que o token de atualização expire ou o consentimento seja revogado.​ Se o cliente OAuth for excluído ou os tokens forem revogados no ServiceNow, a conexão da UiPath deverá ser reautorizada.

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 mantém uma linha correspondente a cada tabela na 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 CRUD. Imagem dos documentos
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 de usuário em tempo de design em nossas atividades falharão ao carregar.

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 de 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 de 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

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 Orchestrator no inicializador do produto.

2. Selecione uma pasta e navegue até a aba Conexões .

3. Selecione Adicionar conexão.

4. Para abrir a página de criação de conexão, selecione o conector na lista. Você pode usar a barra de pesquisa para encontrar o conector.

5. Selecione seu tipo de autenticação preferido e insira as credenciais necessárias.

   Where available, select the menu next to a field and choose Use credential asset or Use Orchestrator asset to reference an Orchestrator asset instead of entering the value directly. For more information, see Use credential assets for connections.

6. Select Connect.

7. 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.