Configurando credencial do Azure DevOps OAuth 2,0

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 7 min. de leitura

    • Criar Azure DevOpsOAuth 2,0 e use-as para conectar seu Azure DevOpsinstância.

    Se você quiser usar credenciais de autenticação básica em vez de OAuth 2,0, ignore esta seção e prossiga para a integração Azure DevOpsusando uma das seguintes opções:

    Crie um locatário em MicrosoftEntra

    Crie um locatário em MicrosoftE configure as permissões necessárias para criar um Azure DevOps(ADO).

    Antes de Iniciar

    Função necessária: Criador de locatário em Azure DevOps.

    Por Que e Quando Desempenhar Esta Tarefa

    Seu locatário representa sua organização e ajuda você a gerenciar uma instância específica de MicrosoftServiços em nuvem para seus usuários internos e externos.

    Se você tiver um locatário existente, que tenha acesso para criar um app ADO, não precisará executar este procedimento. Se você não tiver um locatário, você deve criar um locatário em MicrosoftEntra, que terá acesso para criar um app ADO.

    Procedimento

    1. Em Microsoft Entra portal, navegue até Visão geral > Gerenciar locatários .
    2. Selecione Criar.
    3. Selecione Força de trabalho e selecione Continuar .
    4. Insira as informações a seguir:
      • O nome da organização desejada no Nome da organização caixa.
      • Seu nome de domínio inicial desejado no Nome de domínio inicial caixa.
    5. Selecione Próximo: Revisar e criar .
    6. Revise as informações inseridas e, se as informações estiverem corretas, selecione Criar no canto inferior esquerdo.

      Para obter mais informações, consulte Microsoft documentação.

    Adicione um usuário ao locatário em MicrosoftEntra

    Adicione um usuário que contém a função de administrador ao locatário criado no procedimento anterior.

    Antes de Iniciar

    Função necessária: Administrador de usuário em Azure DevOps

    Procedimento

    1. Em MicrosoftEntra ID do locatário, selecione o link Número de usuários na seção Detalhes do locatário. Usuários na seção de detalhes do locatário
    2. Selecione Novo usuário > Criar novo usuário .
    3. Na guia Noções básicas, insira os seguintes detalhes.
      Tabela 1. Campos da guia Noções básicas
      Campo Valor
      Nome principal do usuário Insira um nome de usuário exclusivo e selecione um domínio no menu após o símbolo de a.
      Apelido do e-mail Se você precisar inserir um apelido de e-mail diferente do nome principal do usuário inserido, limpe Derivar do nome principal do usuário e insira o apelido do e-mail.
      Nome de exibição Insira o nome do usuário.
      Senha Forneça uma senha para o usuário usar durante o login inicial. Desmarque a opção Gerar senha automaticamente para inserir uma senha diferente
      Conta habilitada Esta opção está marcada por padrão. Desmarque para impedir que o novo usuário possa entrar. Você pode mudar esta configuração depois que o usuário for criado. Esta configuração foi chamada Bloquear login no processo de criação de usuário legado.
    4. Selecione Próximo: Propriedades para concluir a próxima seção.
      Tabela 2. Campos da guia Propriedades
      Campo Valor
      Identidade Insira o nome e o sobrenome do usuário. Defina o tipo de usuário como Membro ou Convidado.
      Informações do trabalho Adicione todas as informações relacionadas ao trabalho, como o cargo, o departamento ou o gerente do usuário.
      Informações de Contato Adicione todas as informações de contato relevantes para o usuário.
      Controles parentais Para organizações como distritos escolares K-12, a faixa etária do usuário pode precisar ser fornecida. Os menores têm 12 anos ou menos, os adultos não têm 13-18 anos e os adultos têm 18 anos ou mais. A combinação de faixa etária e consentimento fornecido pelas opções primárias determina a classificação do grupo etário jurídico. A classificação de faixa etária jurídica pode limitar o acesso e a autoridade do usuário.
      Configurações Especifique o local global do usuário.
    5. Selecione Próximo: Atribuições para concluir a próxima seção.
    6. Na seção Atribuições, selecione E Adicionar função.
    7. No menu exibido, selecione Administrador global na lista e selecione Selecione botão.
    8. Selecione Revisar e criar botão.

      Para obter mais informações, consulte Microsoft documentação.

    Crie uma organização no portal do Azure

    Crie uma organização no novo locatário, que tenha acesso para criar um app.

    Antes de Iniciar

    Função necessária: Administrador global em Azure DevOps

    Procedimento

    1. Faça login em Azure portal com o usuário criado no procedimento anterior.
    2. Navegue até Azure DevOps Organizations > Minhas organizações do Azure DevOps .
    3. Selecione Crie uma nova organização .
    4. Insira o nome da organização ADO e o local e selecione Continuar . Criar página da organização ADO

      Esta organização recém-criada será conectada ao locatário criado no Crie um locatário em MicrosoftEntratópico.

    Crie um Azure DevOpsapp

    Crie e configure um Azure DevOps(ADO) e copie os valores necessários para habilitar a autenticação OAuth 2,0 com sua instância da ServiceNow.

    Antes de Iniciar

    Função necessária: Administrador global em Azure DevOps

    Procedimento

    1. Em Azure portal, navegue até Registros da aplicação .
    2. Selecione Novo registro .
    3. Na  página Registros do app, insira as informações de registro da sua aplicação, conforme descrito na tabela.
      Tabela 3. Página de registros do app
      Campo Valor
      Nome Insira um nome de aplicação significativo que seja exibido para os usuários.
      Tipos de conta compatíveis Somente selecione contas neste diretório organizacional (locatário único)
      Redirecional URL Insira o URL da instância da ServiceNow.
    4. Selecione Registrar.
    5. Na aplicação recém-criada, na página Visão geral no painel de navegação esquerdo e copie os seguintes detalhes:
      • ID da aplicação (cliente)
      • ID do diretório (locatário)
      Página de visão geral de um app ADO
    6. Selecione um segredo do cliente Gerenciar > Certificados e segredos no painel de navegação esquerdo.
      Para obter mais informações, consulte Adicione um segredo do cliente e. Registre uma aplicação Tópicos na documentação da Microsoft.
    7. Copie o valor do segredo do cliente. Seção Certificados e segredos para um app ADO
    8. Navegue até Gerenciar > Permissões de API .
    9. Selecione - Adicione uma permissão E selecione a guia APIs da Microsoft à direita.
    10. PESQUISE e selecione Azure DevOps e adicione o. vso.project permissão.
    11. Selecione a permissão vso.project e copie o. ID do app de recurso valor. ID do app de recurso na tela Permissões da API
      Nota:
      O valor do ID da app do recurso copiado aqui será adicionado aos escopos da entidade OAuth para o registro da aplicação.

    Registrar Azure DevOpsComo um provedor de OAuth

    Use as informações geradas durante Azure DevOps(ADO) configuração da conta do app a ser registrada Azure DevOpsComo um provedor de OAuth e habilite a instância para solicitar tokens OAuth 2,0.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em ServiceNow Velocidade de mudança para DevOps, navegue até Tudo > OAuth de Sistema > Registro de aplicações.
    2. Selecione Novo.
      . Que tipo de aplicação OAuth? a mensagem é exibida.
    3. Selecione Conecte-se a um provedor de OAuth terceirizado .
    4. No formulário, preencha os campos.
      Tabela 4. Campos de formulário do Registro de aplicações
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira Meu provedor de app ADO .
      ID de cliente ID do cliente do seu app ADO (dica: Disponível em Visão geral Da sua aplicação ADO).
      Segredo do cliente Segredo do cliente do seu app ADO (dica: Disponível em Certificados e segredos Da sua aplicação ADO).
      Tipo de concessão padrão Tipo de concessão associada ao registro da aplicação. Selecione Credenciais do Cliente.
      URL de Autorização Inserir:

      ID>oauth2/v2.0/Authorize do https://login.microsoftonline.com/<Directory (locatário)

      ID do diretório (locatário) é o valor alfanumérico encontrado na seção Visão geral do app ADO.
      URL de Token Inserir:

      ID>oauth2/v2.0/token do https://login.microsoftonline.com/<Directory (locatário)

      ID do diretório (locatário) é o valor alfanumérico encontrado na seção Visão geral do app ADO.
    5. Deixe o restante dos campos do formulário como estão.
      OAuth do ADO
    6. Selecione e segure (ou clique com o botão direito do mouse) o cabeçalho do formulário e selecione Salvar .
      O sistema valida as credenciais do OAuth e preenche o. URL de redirecionamento (Dica: Ele deve corresponder ao URL de redirecionamento fornecido anteriormente na criação do app ADO).
    7. Selecione Escopos da entidade OAuth guia relacionada.
    8. Adicione o valor do escopo OAuth como Valor do ID da aplicação de recurso copiado na etapa 11 do procedimento anterior>/.padrão . Guia relacionada ao escopo da entidade OAuth

    Defina as configurações de nível da organização e do projeto

    Defina as configurações de nível de organização e projeto para seu app.

    Antes de Iniciar

    Função necessária: Membro do Administradores da coleção de projetos grupo ou o proprietário da organização.

    Procedimento

    1. Navegue até Configurações organizacionais da sua organização no Azure DevOpsportal.
    2. Selecione Usuários .
    3. Em Principais de serviço ou usuários selecione o app que você criou no procedimento anterior na lista. Adicione usuário do app à organização
    4. Navegue de volta para a lista de usuários e selecione o usuário do app.
    5. Selecione Ações e selecione Gerencie o acesso .
    6. Adicione o projeto que você deseja habilitar o app para acessar e atribua o. Administrador de projetos função desse projeto.
      Nota:
      Se você não estiver vendo sua versão ou pipelines clássicos, certifique-se de que o. Desabilite a criação de pipelines de versão clássica a configuração está desativada para sua organização.
      Configurações de pipeline para sua organização
    7. Navegue até Configurações do projeto do seu projeto.
    8. Selecione Permissões .
      Uma equipe de projeto será criada em permissões por padrão. Permissões no nível do projeto
    9. Selecione a equipe de projeto padrão e navegue até a guia Membros.
    10. Adicione o usuário do app. Adicione o usuário do app ao projeto padrão

    Crie registro de credencial e obtenha token OAuth

    Crie registro de credencial e obtenha token OAuth.

    Antes de Iniciar

    Função necessária: administrador, sn_devops.admin

    Por Que e Quando Desempenhar Esta Tarefa

    Para ADO OAuth 2,0, você deve criar registros de credencial separados para compilação, lançamento e feeds em ServiceNow.

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Credenciais.
    2. Selecione Novo.
      . Que tipo de credenciais você deseja criar? a mensagem é exibida.
    3. Selecione Credenciais OAuth 2.0.
    4. No formulário, preencha os campos.
      Tabela 5. Campos do formulário Credenciais do OAuth 2,0
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira Minha credencial de compilação do APP ADO .
      Ativo Opção para habilitar o registro.
      Perfil de Entidade OAuth Perfil de entidade OAuth padrão criado no registro da aplicação.
    5. Salve o registro.
    6. Selecione Obter token OAuth Link relacionado para gerar o token OAuth.
    7. Repita o procedimento para criar credenciais de versão e feeds.