Como configurar a integração do OAuth por meio do MID Server

  • Versão de lançamento: Xanadu
  • Atualizado 9 de jan. de 2026
  • 3 min. de leitura

    • Crie um registro de conexão que permita o envio de uma solicitação de token OAuth a um servidor de terceiros por meio de um MID Server.

    Antes de Iniciar

    Confirme se você assinou o ServiceNow IntegrationHub Standard Pack Installer. Para obter mais informações, consulte https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf.

    Função necessária: administrador

    Procedimento

    Configure a conexão com um modelo de configuração.
    1. Navegar até Todos > IntegrationHub > Modelos de Configuração.
    2. Selecione Novo.
    3. Selecione Conexão HTTP com tipo de concessão de Credenciais de cliente OAuth.
    4. Atualize o formulário conforme necessário.
      Por exemplo, é possível informar o escopo nos campos oauth_entity_profile_scope e oauth_entity_scope da seção "Modelo de dados padrão". Para aprender a criar um modelo de configuração, consulte Crie um modelo de configuração.
    5. Selecione Enviar.
      Você criou o modelo de configuração.
    6. Navegar até Todos > IntegrationHub > Aliases de conexão e credencial.
    7. Atualize o formulário.
      Tabela 1. Alias de conexão e credencial
      Campo Descrição
      Nome Nome do alias. Um alias só pode conter caracteres alfa, número e sublinhado.

      Durante um upgrade, o marcador no registro de credencial migra para um alias de credencial e conexão. Se o marcador de credencial contiver caracteres especiais diferentes de alfabetos, números e sublinhados, isso preserva o nome do marcador após um upgrade. Ainda é possível usar esse alias migrado, mas não é possível atualizá-lo até que você mude o nome para atender às restrições de nomenclatura.
      Aplicação Identificador exclusivo do alias de conexão e credencial, com base no formato scope_name.alias_name.
      • Se o escopo for Global, o ID será o nome do alias. Por exemplo, se você criar um alias do Workday no escopo global, ele definirá o ID para workday.
      • Se você criar um alias do workday no escopo do app de RH, ele definirá o ID como x_hr_app.workday.
      Alias primário Opção para selecionar o alias sob o qual você está criando esse alias de conexão e credencial. O alias de conexão e credencial que você está criando é um alias secundário. Um alias secundário é listado na guia Aliases secundários, na página do alias primário de conexão e credencial.

      Alias secundário na guia "Aliases secundários".
      Tipo Opção para indicar o tipo de alias que você está criando. Escolha dentre as seguintes opções.
      • Credencial: alias que contém um registro de credencial.
      • Conexão e credencial: alias que contém um registro de conexão e credencial. Essa opção é selecionada por padrão.

      Confirme se a opção "Conexão e credencial" está selecionada.
      Suporte a várias conexões ativas Designador que indica se o alias suporta várias conexões ativas. Adicione conexões usando a tabela Conexões e as associe ao alias usando a lista relacionada às Conexões.
      Política de nova tentativa padrão Tente novamente a política para o alias. Para obter mais informações, consulte Política de nova tentativa.
      Modelo de configuração Opção para selecionar o modelo de configuração com base no qual você está criando o alias de conexão e credencial. Selecione o modelo do tipo Conexão HTTP com tipo de concessão de Credenciais de Cliente OAuth que você criou.
    8. Selecione Enviar.
      Você criou o registro de alias de conexão e credencial.
    9. Navegar até Todos > IntegrationHub > Painel de Conexões.
    10. No campo "Pesquisar todas as conexões", digite o nome do registro de alias de conexão e credencial que você criou.
    11. No registro, selecione Exibir detalhes.
    12. Selecione Configurar.
    13. Preencha o formulário.
      Tabela 2. Registro de conexão
      Campo Descrição
      Nome da conexão Nome do registro de conexão. Não é possível atualizar o nome.
      URL de Conexão Opção para informar a URL que se conecta ao servidor de terceiros.
      Usar MID Opção para especificar que você deseja enviar solicitações de token OAuth por meio de um MID Server.
      Importante:
      Confirme se a opção está selecionada.
      Seleção de MID Opção para especificar se você deseja usar um MID Server específico, habilitar a seleção automática do MID Server ou usar um Cluster do MID. Escolha uma das opções a seguir.
      • Selecionar automaticamente o MID Server
      • MID Server específico
      • Cluster do MID específico
      MID Server Opção para selecionar um MID Server.
      Nota:
      Essa opção aparecerá se você selecionar MID Server específico no campo "Seleção de MID".
      Cluster do MID Opção para selecionar um Cluster do MID.
      Nota:
      Essa opção aparecerá se você selecionar Cluster do MID específico no campo "Seleção de MID".
      ID do cliente OAuth Opção para especificar o ID do cliente.
      Segredo do cliente OAuth Opção para especificar o segredo do cliente.
      Conectar-se ao servidor Auth via MID Server Opção para especificar que a conexão entre a instância da ServiceNow e o servidor de autenticação ocorre por meio do MID Server.
      Importante:
      Confirme se a opção está selecionada.
      URL do token Oauth Opção para especificar a URL do token OAuth usada para solicitar tokens OAuth.
    14. Selecione Configurar e obter token do OAuth.
      O registro de conexão e credencial é criado.