Configurar o Microsoft Azure DevOps Boards spoke usando o OAuth

  • Versão de lançamento: Xanadu
  • Atualizado 16 de jun. de 2026
  • 4 min. de leitura

    • Integre a instância [ ServiceNow e Azure DevOps Boards usando a autenticação OAuth 2.0 para autenticar solicitações ServiceNow.

    Antes de Iniciar

    • Solicite uma assinatura do Integration Hub.
    • Ativação do Azure DevOps Boards spoke
    • Função necessária: administrador
    Importante:
    • Se você estiver configurando o Azure DevOps Boards spoke usando o OAuth, não precisará configurar o spoke usando o token de acesso pessoal.
    • Se o Azure DevOps Boards spoke já estiver configurado e configurado, certifique-se de definir o valor de Ativo como falso para a conexão existente antes de prosseguir para configurar o spoke usando o OAuth.

      Se a conexão já estiver configurada, defina o valor de Ativo como falso.

    Registro de uma aplicação usando o portal do Microsoft Azure

    Forneça autorização para a instância ServiceNow registrando uma aplicação no portal do Microsoft Azure.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Conclua essas etapas no portal do Microsoft Azure.

    Procedimento

    1. Faça login no portal do Microsoft Azure como administrador.
    2. Clique em Registros de app.
    3. Clique em Novo registro.
    4. No formulário, preencha os campos de acordo com seus requisitos.
      Para URI de redirecionamento, especifique o URL da instância ServiceNow neste formato: https://<ServiceNow-Instance-Name> .service-now.com/oauth_redirect.do .

      Registre uma aplicação no portal do Microsoft Azure.

    5. Clique em Registrar.
      A aplicação é criada e os valores de ID da aplicação (cliente) e IDdo diretório (locatário) são exibidos.

      Valores de ID da aplicação (cliente) e IDdo diretório (locatário) exibidos após a criação da aplicação.

    6. Copie e registre os valores de ID da aplicação (cliente) e IDdo diretório (locatário).
    7. Gere um segredo do cliente para a aplicação.
      1. Em Gerenciar, clique em Certificados e segredos.
      2. Clique em Novo segredo do cliente.
      3. No formulário, insira fornecer uma descrição e especificar a duração após a qual o segredo expira.
      4. Clique em Adicionar.

        Crie um segredo do cliente.

        O segredo do cliente é criado e seu valor é exibido.
      5. Copie o valor do segredo do cliente para uso posterior.

        Copie o valor do segredo do cliente para uso posterior.

    8. Forneça as permissões de API necessárias para a aplicação.
      1. Em Gerenciar, clique em Permissões de API.
      2. Clique em Adicionar uma permissão.
      3. Em APIs da Microsoft, clique em Azure DevOps.

        Adicione permissões de API.

      4. Expanda vso e selecione estas permissões vso.project_manage e vso.work_full.
        A permissão User.Read no Microsoft Graph é selecionada por padrão. Configure outras permissões de acordo com seus requisitos.
      5. Clique em Conceder consentimento ao administrador para a ServiceNow.

        Conceder consentimento de administrador para a ServiceNow.

      6. Quando solicitado, confirme sua escolha para conceder consentimento de administrador para a ServiceNow.

    Resultado

    Uma aplicação foi registrada no portal do Microsoft Azure. Você pode usar esta aplicação para se conectar ao seu projeto do Azure DevOps na instância da ServiceNow.

    Criar um registro de aplicação na instância ServiceNow

    Use as informações geradas ao registrar uma aplicação no portal do Microsoft Azure para criar um registro de aplicação em sua instância da ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.

      O sistema exibe a mensagem Que tipo de aplicação OAuth?

    3. Selecione Conectar-se a um provedor OAuth de terceiros.
    4. No formulário, preencha os campos.
      Tabela 1. Formulário de registros de aplicações
      Campo Descrição
      Nome Nome para identificar o registro da aplicação. Por exemplo, Azure DevOps Boards OAuth App Reg.
      ID de cliente Valor da ID da aplicação (cliente) gerado depois que você registrou a aplicação no portal do Azure.
      Segredo do cliente Valor do segredo do cliente gerado depois que você registrou a aplicação no portal do Azure.
      Tipo de concessão padrão Selecione Código de autorização.
      URL de Token URL do token neste formato: https://login.microsoftonline.com/<Tenant_ID> /oauth2/v2.0/token . Substituir<Tenant_ID> com o valor da ID do diretório (locatário) gerado depois que você registrou a aplicação no portal do Azure .Registro de uma aplicação usando o portal do Microsoft Azure
      Autorizar URL Autorize a URL neste formato: https://login.microsoftonline.com/<Tenant_ID> /oauth2/v2.0/authorize . Substituir<Tenant_ID> com o valor da ID do diretório (locatário) gerado depois que você registrou a aplicação no portal do Azure .Registro de uma aplicação usando o portal do Microsoft Azure
    5. Clique na guia Escopos de Entidade OAuth.
    6. Insira duas linhas com esses valores.
      Nome Escopo de OAuth
      vso.project_manage https://app.vssps.visualstudio.com/vso.project_manage
      vso.work_full https://app.vssps.visualstudio.com/vso.work_full
      offline_access offline_access

      Adicionar escopos de entidade OAuth.

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

    Resultado

    O registro da aplicação é criado e um registro de perfil de entidade OAuth é criado. Por exemplo, Azure DevOps Boards OAuth App Reg default_profile.

    Criar um registro de credencial para o Azure DevOps Boards spoke

    Crie um registro de credencial para a conta do Azure DevOps Boards. O alias de conexão e credencial Azure DevOps Boards spoke usa essa credencial para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Hub de integração > 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 valores.
      Tabela 2. Formulário de credenciais OAuth 2.0
      Campo Descrição
      Nome Nome do registro da credencial. Por exemplo, Azure DevOps Spoke OAuth Cred.
      Perfil de Entidade OAuth Selecione o perfil de entidade OAuth criado quando você criou o registro da aplicação. Por exemplo, Azure DevOps Boards OAuth App Reg default_profile.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    6. Clique no link relacionado Obter token OAuth.
      O token de atualização do OAuth é gerado após a autenticação e seus detalhes de expiração também são exibidos.

    Criar um registro de conexão para o Azure DevOps Boards spoke

    Crie um registro de conexão para a conta do Azure DevOps Boards. O alias de conexão e credencial Azure DevOps Boards spoke usa essa credencial para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Hub de integração > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Abra o registro Azure_DevOps_Boards.
    3. Na guia Conexões, clique em Novo.
    4. No formulário, preencha estes valores.
      Tabela 3. Formulário de conexão HTTP
      Campo Descrição
      Nome Nome para identificar o registro de conexão. Por exemplo, Azure DevOps Spoke OAuth Conn.
      Credenciais Registro de credencial que você criou. Por exemplo, Azure DevOps Spoke OAuth Cred.
      URL de Conexão URL da organização do Azure DevOps. Por exemplo, insira a URL neste formato: https://dev.azure.com/<instance-name> .
    5. Clique em Enviar.