Configurar o spoke de instância remota da ServiceNow

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura

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

    Antes de Iniciar

    • Solicitar assinatura do IntegrationHub.
    • 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 somente para configurar 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 os 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 remota ServiceNow como um provedor OAuth

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

    Antes de Iniciar

    • Na instância remota ServiceNow :
      • Crie um endpoint da API da 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 de 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 do cliente criado na instância remota ServiceNow.
      Segredo do cliente Segredo do cliente criado na instância remota ServiceNow.
      URL de Autorização URL da instância ServiceNow remota neste formato: https://<instance-name> .service-now.com/oauth_auth.do .
      URL do 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 uma autorização do PKCE.
      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 pode ser acessado.
      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 remota ServiceNow

    Crie um registro de credencial para a instância ServiceNow remota. Os aliases de conexão e credencial do ServiceNow Remote Instance spoke 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 em que 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 um registro de conexão para sua instância remota ServiceNow. Os aliases de conexão e credencial do ServiceNow Remote Instance spoke 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.
      Credencial Registro de credencial criado para a instância remota ServiceNow. 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 ativamente a conexão.
      Domínio Domínio no qual a ação ou atividade é executada.
    5. Clique em Enviar.

    Criar registro de credencial para a instância ServiceNow local

    Crie um registro de credencial para a instância ServiceNow local. Os aliases de conexão e credencial do ServiceNow Remote Instance spoke 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 do 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 um registro de conexão para sua instância local ServiceNow. Os aliases de conexão e credencial do ServiceNow Remote Instance spoke 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.
      Credencial 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 ServiceNow local. Por exemplo, https://<local-instance-name> .service-now.com/ .
      Ativo Opção para usar ativamente a conexão.
      Domínio Domínio no qual a ação ou atividade é executada.
    5. Clique em Enviar.