Configurar o spoke da instância remota da ServiceNow

Integre as instâncias ServiceNow locais e remotas criando um endpoint de API OAuth na instância ServiceNow remota para autenticar solicitações.

Antes de Iniciar

• Solicitar assinatura do Integration Hub.
• Ative o ServiceNow Remote Instance spoke em instâncias remotas e locais ServiceNow.
  Nota:

  Os termos instância remota e instância local são usados nestes contextos:

  • Instância local: esta é a instância da ServiceNow a partir da qual a comunicação é iniciada e estabelecida.
  • Instância remota: esta é a instância da ServiceNow com a qual a instância local se comunica.
• Função necessária: administrador
  Nota:

  A função de administrador é necessária para configurar somente o spoke.

  Para usar o spoke, certifique-se de que os usuários do spoke tenham apenas as permissões mínimas necessárias para acessar dados nas tabelas ServiceNow. Não atribua funções de privilégio elevado a usuários deste spoke, a menos que seja muito necessário. Esta prática garante o acesso controlado aos dados.

  Os usuários de integração devem ter as funções necessárias para acessar a tabela com a qual desejam interagir. Além disso, eles precisam de funções para acessar as tabelas Tabela [sys_db_object] e Entrada de dicionário [sys_dictionary] para mostrar opções dinâmicas, como nomes de tabela e campos em uma tabela.

Registrar instância ServiceNow remota como um provedor OAuth

Registre a instância ServiceNow remota como um provedor OAuth para que a instância ServiceNow local possa solicitar tokens OAuth 2.0.

Antes de Iniciar

• Na instância ServiceNow remota:
  • Crie um endpoint da API OAuth para clientes externos. Em Redirecionar URL, especifique o URL da instância ServiceNow local neste formato: https://<instance-name> .service-now.com/oauth_redirect.do . Para obter mais informações, consulte Criar um endpoint para que os clientes acessem a instância.
  • Copie e registre os valores de ID do cliente e segredo do cliente.
• Função necessária: administrador

Procedimento

1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
2. Aberto para o registro, RemoteSpoke.
3. No formulário, preencha estes valores.

   Tabela 1. Formulário de registros de aplicações

   Campo	Descrição
   ID de cliente	ID de cliente criado na instância ServiceNow remota.
   Segredo do cliente	Segredo do cliente criado na instância ServiceNow remota.
   URL de Autorização	URL da instância ServiceNow remota neste formato: https://<instance-name> .service-now.com/oauth_auth.do .
   URL de Token	URL da instância ServiceNow remota neste formato: https://<instance-name> .service-now.com/oauth_token.do .
   URL de redirecionamento	URL da instância local ServiceNow neste formato: https://<instance-name> .service-now.com/oauth_redirect.do .
   Tipo de concessão padrão	Tipo de concessão usado para estabelecer o token. Selecione Código de autorização.
   Tempo de vida do token de atualização	Tempo, em segundos, em que o token de atualização é válido. O tempo padrão é 8.640.0000 segundos.
   PKCE necessário	Opção para permitir que clientes públicos exijam o PKCE para uma autorização. Nota: Você pode usar somente o Código de autorização como o Tipo de concessão padrão quando o PKCE estiver habilitado.
   Aplicação	Escopo da aplicação que contém este registro.
   Acessível de	Escopo da aplicação a partir do qual este registro fica acessível.
   Ativo	Opção para usar ativamente o registro da aplicação.

4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

Criar registro de credencial para a instância ServiceNow remota

Crie o registro de credencial para a instância ServiceNow remota. Os aliases de conexão e credencial do spoke da Instância remota da ServiceNow usam essas credenciais para autorizar ações.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > Conexões e Credenciais > Credenciais.
2. Clique em Nova.
   O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
3. Selecione Credenciais OAuth 2.0.
4. No formulário, preencha os campos.

   Campo	Valor necessário
   Nome	Nome para identificar exclusivamente o registro. Por exemplo, credenciais remotas.
   Ativo	Opção de usar ativamente o registro de credencial.
   Perfil de Entidade OAuth	Perfil OAuth criado durante o registro da instância ServiceNow remota como um provedor OAuth. Por exemplo, selecione RemoteSpoke default_profile.
   Ordem	Ordem na qual as credenciais são usadas. Por exemplo: insira 100.

5. Clique com o botão direito no cabeçalho do formulário e clique em Enviar.
6. Para gerar o token OAuth, clique no link relacionado Obter Token OAuth.

Criar registro de conexão para a instância ServiceNow remota

Crie o registro de conexão para sua instância ServiceNow remota. Os aliases de conexão e credencial do spoke da Instância remota da ServiceNow usam essas conexões para executar ações.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > Conexões e Credenciais > Aliases de conexões e credenciais.
2. Abra o registro de alias, ServiceNowRemoteInstance.
3. Na guia Conexões, clique em Novo.
4. No formulário, preencha os campos.

   Tabela 2. Formulário de conexão HTTP

   Campo	Valor necessário
   Nome	Nome para identificar exclusivamente o registro. Por exemplo, Conexão remota.
   Credenciais	Registro de credencial criado para instância ServiceNow remota. Por exemplo, credenciais remotas.
   Alias de conexão	Registro de alias associado a esta conexão.
   Construtor de URL	Nota: Não marque a caixa de seleção.
   URL de Conexão	URL da instância ServiceNow remota. Por exemplo, https://<remote-instance-name> .service-now.com/ .
   Ativo	Opção para usar a conexão ativamente.
   Domínio	Domínio em que a ação ou atividade é executada.

5. Clique em Enviar.

Criar registro de credencial para a instância local ServiceNow

Crie o registro de credencial para a instância local ServiceNow. Os aliases de conexão e credencial do spoke da Instância remota da ServiceNow usam essas credenciais para autorizar ações.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > Conexões e Credenciais > Credenciais.
2. Clique em Nova.
   O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
3. Selecione Credenciais de autenticação básica.
4. No formulário, preencha os campos.

   Campo	Valor necessário
   Nome	Nome para identificar exclusivamente o registro. Por exemplo, Credenciais locais.
   Nome de usuário	Nome de usuário para fazer login na instância local ServiceNow.
   Senha	Senha para fazer login na instância local ServiceNow.
   Ativo	Opção de usar ativamente o registro de credencial.

5. Clique com o botão direito no cabeçalho do formulário e clique em Enviar.

Criar registro de conexão para a instância local ServiceNow

Crie o registro de conexão para sua instância local ServiceNow. Os aliases de conexão e credencial do spoke da Instância remota da ServiceNow usam essas conexões para executar ações.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > Conexões e Credenciais > Aliases de conexões e credenciais.
2. Abra o registro de alias ServiceNowRemoteInstanceLocalAlias.
3. Na guia Conexões, clique em Novo.
4. No formulário, preencha os campos.

   Tabela 3. Formulário de conexão HTTP

   Campo	Valor necessário
   Nome	Nome para identificar exclusivamente o registro. Por exemplo, Conexão local.
   Credenciais	Registro de credencial criado para a instância local ServiceNow. Por exemplo, Credenciais locais.
   Alias de conexão	Registro de alias associado a esta conexão.
   URL de Conexão	URL da instância local ServiceNow. Por exemplo, https://<local-instance-name> .service-now.com/ .
   Ativo	Opção para usar a conexão ativamente.
   Domínio	Domínio em que a ação ou atividade é executada.

5. Clique em Enviar.