Compartilhar via

Solucionar problemas de conexão a um projeto

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

Se você estiver enfrentando problemas de conexão com um projeto no Azure DevOps, este artigo fornece diretrizes passo a passo de solução de problemas para resolver problemas comuns de conectividade e autenticação.

Pré-requisitos

Categoria Requisitos
Acesso ao projeto Membro do projeto.

Etapas de resolução rápida

Se você estiver enfrentando problemas de conexão, experimente estas etapas rápidas primeiro:

  1. Limpe completamente o navegador: saia usando https://aka.ms/VsSignoute desmarque todos os cookies (Ctrl+Shift+Delete).
  2. Use uma sessão privada do navegador: abra uma janela incógnito ou InPrivate e teste o acesso.
  3. Verificar a URL da organização: verifique se você está usando o formato de URL correto: https://dev.azure.com/{organizationName}.
  4. Verifique o tipo de conta: verifique se você está entrando com o tipo de conta correto (ID do Microsoft Entra versus conta pessoal da Microsoft).

Se essas etapas não resolverem o problema, continue com as seções de solução de problemas detalhadas a seguir.

Solucionar problemas dos erros de autenticação

O Azure DevOps dá suporte a contas do Microsoft Entra e contas pessoais da Microsoft para autenticação. As organizações conectadas ao Microsoft Entra ID exigem autenticação no Microsoft Entra (contas de membro ou convidado B2B).

401 – Erros não autorizados

A captura de tela mostra o erro 401 da conexão 401 do Azure DevOps.

O erro 401 Não Autorizado é o problema de entrada mais comum. Esse erro ocorre quando sua identidade não tem permissões para acessar a organização ou recursos específicos. As causas mais comuns incluem:

  • Identidade não adicionada à organização: sua conta não está listada no diretório de usuários da organização.
  • Confusão de Aliases vs. UPN: Tentando fazer login com um alias em vez do Nome Principal do Usuário (UPN).
  • Permissões de projeto insuficientes: sem permissões de leitura no projeto ou recurso de destino.
  • Convite de convidado B2B pendente: o convite de convidado do Microsoft Entra B2B não é aceito.
  • Incompatibilidade de tipo de conta: tentar entrar com o tipo de conta errado quando várias contas compartilham o mesmo endereço de email.

Identidade não está na organização

Etapas da resolução:

  1. Entre em contato com o administrador do Azure DevOps para verificar se sua identidade aparece na lista usuários da organização.
  2. Para contas do Microsoft Entra: garanta que a identidade na lista de usuários corresponde exatamente ao seu UPN no locatário do Microsoft Entra.
  3. Para contas pessoais da Microsoft: confirme se a identidade corresponde ao email da sua conta primária.
  4. Para convidados B2B: Verifique se o UPN no locatário convidado corresponde ao UPN do locatário principal, incluindo o casing exato.

Observação

Os convidados B2B aparecem na ID do Microsoft Entra com UPNs formatados como {username}_{homeDomain}#EXT#@{guestDomain}. A {username}_{homeDomain} parte deve corresponder ao UPN do locatário da casa, substituindo por _@.

Problemas de login de UPN vs. alias

O Azure DevOps não dá suporte a aliases de entrada. Você deve usar o Nome Principal de Usuário (UPN) exato para contas do Microsoft Entra ou a conta primária para contas pessoais da Microsoft.

Exemplo: Se o UPN for john.doe@contoso.com, mas você tiver um alias jdoe@contoso.com, você deverá fazer login utilizando john.doe@contoso.com.

Resolução: Peça ao administrador para adicionar o UPNjohn.doe@contoso.com (real) à organização e sempre use esse UPN para entrar.

Permissões insuficientes

Você pode ter acesso à organização, mas não tem permissões para projetos ou recursos específicos.

Sintomas:

  • Pode acessar https://dev.azure.com/{orgName} , mas não https://dev.azure.com/{orgName}/{projectName}.
  • Receba 401 erros ao acessar itens de trabalho, repositórios ou pipelines específicos.

Resolução: Entre em contato com o administrador do Azure DevOps para verificar se você tem pelo menos permissões de leitura para o recurso de destino.

Problemas de convite de convidado B2B

Os convidados B2B devem aceitar o convite do tenant do Microsoft Entra antes de acessar o Azure DevOps.

Etapas de resolução para visitantes:

  1. Verifique seu email para o convite do Microsoft Entra.
  2. Selecione o link do convite e conclua o processo de aceitação.
  3. Tente entrar no Azure DevOps novamente.

Etapas de resolução para administradores de locatários:

  1. Ir para https://portal.azure.com.
  2. Selecione Microsoft Entra ID>Usuários.
  3. Localize o usuário convidado e verifique sua página visão geral .
  4. Se o status do convite B2B mostrar "Aceitação pendente", use Reenviar convite.

Conflitos de tipo de conta

As organizações não conectadas ao Microsoft Entra ID dão suporte a contas pessoais da Microsoft e contas do Microsoft Entra. O primeiro tipo de conta que você usa estabelece sua identidade permanentemente.

Resolução: Se você precisar alterar os tipos de conta:

  1. Peça ao administrador que remova e adicione você novamente à organização.
  2. Entre com seu tipo de conta preferencial quando solicitado.

Dica

Evite ter contas pessoais e do Microsoft Entra semelhantes. Considere renomear sua conta pessoal para evitar confusão.

Solucionar problemas de conectividade

Concluir a saída e a limpeza:

  1. Saia completamente: vá para https://aka.ms/VsSignout.
  2. Desmarque todos os dados do navegador: SelecioneExcluir e remover ++:
    • Cookies e dados do site.
    • Arquivos e imagens armazenadas em cache.
    • Dados do formulário de preenchimento automático.
  3. Limpar dados do Microsoft Edge: o IDE do Visual Studio usa cookies do Microsoft Edge, portanto, limpe os dados do Microsoft Edge mesmo se você usar um navegador diferente.
  4. Feche todos os aplicativos: saia de todos os navegadores e instâncias do IDE do Visual Studio.
  5. Teste com navegação privada: abra uma janela de navegação anônima ou InPrivate para testar o acesso.

Problemas de conexão do IDE do Visual Studio

Se você estiver enfrentando problemas de conexão no Visual Studio:

  1. Remover conexões existentes: no Team Explorer, remova todas as conexões do Azure DevOps.
  2. Limpar cache de credenciais: excluir credenciais armazenadas em cache do Gerenciador de Credenciais do Windows.
  3. Reinicie o Visual Studio: feche e reabra completamente o Visual Studio.
  4. Conexões lidas: adicione sua conexão do Azure DevOps novamente usando as credenciais atuais.

Problemas de rede e proxy

Solução de problemas de rede corporativa:

  1. Teste de uma rede diferente: tente acessar o Azure DevOps de um dispositivo/rede pessoal.
  2. Verifique as configurações do proxy: verifique se o proxy corporativo permite os domínios *.visualstudio.com e *.azure.com.
  3. Configuração do firewall: verifique se o firewall permite o tráfego HTTPS para pontos de extremidade do Azure DevOps.
  4. Interferência vpn: teste com VPN desabilitada, se aplicável.

Solução de problemas avançada

Migração de autenticação moderna

Se você estiver usando métodos de autenticação herdados, considere migrar para alternativas modernas:

Autenticação de conexão de serviço

Para conexões de serviço do Azure DevOps com problemas de autenticação:

  1. Atualizar segredos do principal de serviço: Atualizar segredos ou certificados de cliente expirados.
  2. Verificar permissões: verifique se as entidades de serviço têm permissões apropriadas do Azure DevOps.
  3. Verificar a expiração do token: valide se os tokens de autenticação não expiraram.
  4. Examine os logs de auditoria: verifique os logs de auditoria do Microsoft Entra em busca de falhas de autenticação.

Usar a IA para solucionar problemas de conexão

O prompt de exemplo a seguir para o Copilot Chat ajuda o Copilot a solucionar problemas de conexão e erros de autenticação. Copie e cole esse prompt no Copilot Chat, substituindo o espaço reservado por sua mensagem de erro específica ou descrição do problema.

I'm getting this Azure DevOps connection/authentication error: [PASTE YOUR ERROR MESSAGE HERE]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the connection problem
2. Fix the authentication or access issue
3. Verify I can successfully connect to my Azure DevOps project

Context: This is for connecting to an Azure DevOps organization and project. I've already tried basic troubleshooting like clearing browser cache and using a private browser session.

Copilot é alimentado pela IA, portanto, surpresas e erros são possíveis. Para obter mais informações, consulte perguntas frequentessobre uso geral do Copilot.

Obter outra ajuda

Quando você conclui todas as etapas de solução de problemas e ainda não consegue se conectar:

  1. Coletar informações de diagnóstico: crie um rastreamento do navegador de sua tentativa de login mal-sucedida.
  2. Entre em contato com o Suporte da Microsoft: crie uma solicitação de suporte e inclua:
    • Descrição detalhada do problema.
    • Etapas que você já tentou.
    • Arquivos de rastreamento do navegador.
    • Capturas de tela de mensagens de erro.
  3. Suporte da comunidade: pesquise ou poste perguntas na Comunidade de Desenvolvedores do Azure DevOps.

Conteúdo relacionado

  • Last updated on