Compartilhar via


Autenticação da CLI multiplataforma para o Azure DevOps

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Este artigo explica as abordagens de autenticação da CLI multiplataforma (tfx-cli) e do Azure DevOps.

Importante

É recomendável usar a autenticação da ID do Microsoft Entra como o método principal para autenticação. Os PATs (tokens de acesso pessoal) devem ser usados somente quando a autenticação da ID do Microsoft Entra não estiver disponível. A autenticação básica foi preterida e não é recomendada.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Node.js (versão mais recente do LTS recomendada)

  • tfx-cli instalado globalmente:

    npm install -g tfx-cli
    

Para obter mais informações sobre tfx-cli, consulte a CLI do Node para Azure DevOps no GitHub.

Métodos de autenticação

Escolha o método de autenticação apropriado com base em seu ambiente:

Método Recomendado para
Microsoft Entra ID Azure DevOps Services
PAT Servidor do Azure DevOps, scripts de automação
Autenticação Básica Somente servidor do Azure DevOps

Para o Azure DevOps Services, use a autenticação da ID do Microsoft Entra para obter a melhor segurança:

tfx login

Quando solicitado:

  1. Insira sua URL de serviço, por exemplo, https://dev.azure.com/Your_Organization.
  2. Siga o fluxo de autenticação baseado em navegador.
  3. Conclua o processo de entrada no navegador.

Para obter diretrizes detalhadas sobre a autenticação da ID do Microsoft Entra, consulte a autenticação baseada no Microsoft Entra.

Autenticação PAT

Use PATs quando a autenticação da ID do Microsoft Entra não estiver disponível, como com o Azure DevOps Server.

Criar e usar um PAT

  1. Crie um PAT com os escopos necessários.

  2. Entre usando o PAT:

    tfx login
    
  3. Quando solicitado, forneça:

    • URL de Serviço: a URL da instância do Azure DevOps.
    • Token de acesso pessoal: o PAT que você criou.

URLs de exemplo:

  • Azure DevOps Services: https://dev.azure.com/Your_Organization
  • Servidor Azure DevOps: https://yourserver/tfs/DefaultCollection
  • Visual Studio Marketplace: https://marketplace.visualstudio.com

Sessão de exemplo:

~$ tfx login
Copyright Microsoft Corporation

> Service URL: https://dev.azure.com/Your_Organization
> Personal access token: **********************
Logged in successfully

Autenticação básica (preterida)

Aviso

A autenticação básica foi preterida e não é recomendada. Em vez disso, use a ID do Microsoft Entra. Autenticação básica:

  • Envia credenciais em texto sem formatação
  • Pode causar problemas com operações de linha de comando do Git
  • Representa riscos à segurança

Configurar a autenticação básica (somente o Servidor do Azure DevOps)

Se você precisar usar a autenticação básica com instalações do Servidor do Azure DevOps:

  1. Habilitar a Autenticação Básica do IIS:

    • Abra o Gerenciador de Servidor.
    • Instale o recurso de Autenticação Básica para IIS.
    • No Gerenciador do IIS, acesse o site do Servidor do Azure DevOps.
    • Selecione a Autenticação duas vezes no modo de exibição Recursos.
    • Habilitar a Autenticação Básica.
    • Deixe as configurações de domínio e realm vazias.
  2. Entre com a autenticação básica:

    tfx login --auth-type basic
    
  3. Quando solicitado, forneça:

    • URL de Serviço: URL do servidor local (por exemplo, http://yourserver:8080/tfs/DefaultCollection).
    • Nome de usuário: Usar domain\username formato (por exemplo, fabrikam\john)
    • Senha: sua senha de domínio.

Dica

Considere configurar o SSL para comunicação segura ao usar a autenticação básica.

Próxima etapa