Partilhar via

Resolver problemas relacionados com a ligação a projetos

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Se está a ter dificuldades em ligar-se a um projeto no Azure DevOps, este artigo fornece orientações passo a passo para resolver problemas comuns de conectividade e autenticação.

Pré-requisitos

Categoria Requerimentos
acesso ao projeto Membro do projeto.

Passos rápidos de resolução

Se estiver a ter problemas de ligação, experimente primeiro estes passos rápidos:

  1. Limpe completamente o seu navegador: Faça logout usando https://aka.ms/VsSignout, depois apague todos os cookies (Ctrl+Shift+Delete).
  2. Use uma sessão privada do navegador: Abra uma janela incógnita ou InPrivate e teste o acesso.
  3. Verificar URL da organização: Certifique-se de que está a usar o formato correto de URL: https://dev.azure.com/{organizationName}.
  4. Verifica o tipo de conta da tua conta: Verifica se estás a iniciar sessão com o tipo de conta correto (Microsoft Entra ID vs. conta pessoal Microsoft).

Se estes passos não resolverem o problema, continue com as seguintes secções detalhadas de resolução de problemas.

Resolver erros de autenticação

O Azure DevOps suporta contas Microsoft Entra e contas pessoais Microsoft para autenticação. As organizações ligadas ao Microsoft Entra ID requerem autenticação Microsoft Entra (contas de membros ou convidados B2B).

401 - Erros não autorizados

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

O erro 401 Não Autorizado é o problema mais comum ao iniciar sessão. Este erro ocorre quando a sua identidade não tem permissões para aceder à organização ou a recursos específicos. As causas comuns incluem:

  • Identidade não adicionada à organização: A sua conta não está listada no diretório de utilizadores da organização.
  • Confusão entre alias e UPN: Tentar iniciar sessão com um alias em vez do seu Nome Principal de Utilizador (UPN).
  • Permissões insuficientes do projeto: Falta de permissões de leitura no projeto ou recurso alvo.
  • Convite de convidado B2B pendente: O convite B2B da Microsoft Entra não é aceite.
  • Incompatibilidade no tipo de conta: Tentar iniciar sessão com o tipo de conta errado quando várias contas partilham o mesmo endereço de email.

Identidade não está na organização

Passos de resolução:

  1. Contacte o seu administrador Azure DevOps para verificar se a sua identidade aparece na lista de Utilizadores da organização.
  2. Para contas Microsoft Entra: Certifique-se de que a identidade na lista de Utilizadores corresponda exatamente ao seu UPN no locatário Microsoft Entra.
  3. Para contas pessoais Microsoft: Confirme que a identidade corresponde ao email da sua conta principal.
  4. Para convidados B2B: Verifique se o seu UPN no inquilino convidado corresponde ao UPN do seu inquilino residencial, incluindo o caso exato.

Observação

Os convidados B2B aparecem no Microsoft Entra ID com UPNs formatados como {username}_{homeDomain}#EXT#@{guestDomain}. A parte {username}_{homeDomain} deve corresponder ao seu tenant principal UPN, substituindo o _ por @.

Problemas de login UPN vs. alias

O Azure DevOps não suporta pseudónimos de login. Deve usar o seu Nome Principal de Utilizador (UPN) exato para contas Microsoft Entra ou a conta principal para contas pessoais Microsoft.

Exemplo: Se o seu UPN for john.doe@contoso.com mas tiver um alias jdoe@contoso.com, deve iniciar sessão usando john.doe@contoso.com.

Resolução: Pede ao teu administrador para adicionar o teu UPN real (john.doe@contoso.com) à organização e usa sempre este UPN para iniciar sessão.

Permissões insuficientes

Podes ter acesso à organização mas não ter permissões para projetos ou recursos específicos.

Sintomas:

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

Resolução: Contacte o seu administrador Azure DevOps para verificar se tem pelo menos permissões de leitura para o recurso alvo.

Problemas com convites de convidados B2B

Os convidados B2B devem aceitar o convite para o seu tenant Microsoft Entra antes de aceder ao Azure DevOps.

Instruções de resolução para os convidados:

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

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

  1. Aceda a https://portal.azure.com.
  2. Selecione ID do Microsoft Entra>Utilizadores.
  3. Encontre o utilizador convidado e consulte a sua página de Visão Geral .
  4. Se o estado do convite B2B mostrar "Aceitação pendente", use Reenviar convite.

Conflitos entre tipos de conta

Organizações não ligadas ao Microsoft Entra ID suportam tanto contas pessoais Microsoft como contas Microsoft Entra. O primeiro tipo de conta que usar estabelece a sua identidade de forma permanente.

Resolução: Se precisar de mudar o tipo de conta:

  1. Peça ao seu administrador para o remover e adicionar novamente à sua organização.
  2. Inicie sessão com o seu tipo de conta preferido quando solicitado.

Sugestão

Evite ter contas pessoais e Microsoft Entra idênticas. Considere renomear a sua conta pessoal para evitar confusão.

Resolver problemas de conectividade

Encerramento de sessão completo e limpeza:

  1. Sair completamente: Ir a https://aka.ms/VsSignout.
  2. Limpar todos os dados do navegador: Selecionar Ctrl+Shift+Delete e remover:
    • Cookies e dados do site.
    • Imagens e ficheiros em cache.
    • Preencher automaticamente os dados do formulário.
  3. Limpar dados do Microsoft Edge: O IDE do Visual Studio usa cookies do Microsoft Edge, por isso limpa os dados do Microsoft Edge mesmo que use um navegador diferente.
  4. Fechar todas as aplicações: Sair de todos os navegadores e das instâncias do IDE Visual Studio.
  5. Teste com navegação privada: Use uma janela incógnita ou InPrivate para testar o acesso.

Problemas de ligação ao IDE do Visual Studio

Se está a ter problemas de ligação no Visual Studio:

  1. Remover ligações existentes: No Team Explorer, remova todas as ligações Azure DevOps.
  2. Limpar a cache de credenciais: Eliminar as credenciais em cache do Gestor de Credenciais do Windows.
  3. Reiniciar o Visual Studio: Feche e reabra completamente o Visual Studio.
  4. Readicionar ligações: Adicione novamente a sua ligação Azure DevOps usando as credenciais atuais.

Questões de rede e proxy

Resolução de problemas de rede corporativa:

  1. Teste a partir de uma rede diferente: Tente aceder ao Azure DevOps a partir de um dispositivo/rede pessoal.
  2. Verifique as definições do proxy: Certifique-se de que o proxy corporativo permite os domínios *.visualstudio.com e *.azure.com.
  3. Configuração do firewall: Garantir que o firewall permite tráfego HTTPS para os endpoints Azure DevOps.
  4. Interferência VPN: Teste com a VPN desativada, se aplicável.

Resolução de problemas avançados

Migração de autenticação moderna

Se estiver a usar métodos de autenticação legados, considere migrar para alternativas modernas:

Autenticação da ligação ao serviço

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

  1. Atualizar segredos principais de serviço: Atualizar segredos ou certificados de cliente expirados.
  2. Verificar permissões: Certifique-se de que os principais de serviço têm as permissões DevOps apropriadas do Azure.
  3. Verifique a expiração do token: Valide que os tokens de autenticação não estão expirados.
  4. Revise os registos de auditoria: Verifique os registos de auditoria do Microsoft Entra para falhas de autenticação.

Use IA para resolver problemas de ligação

O exemplo seguinte para o Copilot Chat ajuda o Copilot a resolver os seus erros de ligação e autenticação. Copie e cole este prompt no Copilot Chat, substituindo o marcador por uma 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.

O copiloto é alimentado por IA, por isso surpresas e erros são possíveis. Para obter mais informações, consulte Perguntas frequentes sobre o uso geral do Copilot.

Procura outra ajuda

Quando completas todos os passos de resolução de problemas e ainda não consegues ligar:

  1. Recolha informações de diagnóstico: Crie um rastreio no navegador da sua tentativa falhada de iniciar sessão.
  2. Contacte o Suporte da Microsoft: Crie um pedido de suporte e inclua:
    • Descrição detalhada do problema.
    • Passos que já tentaste.
    • Ficheiros de rastreamento do navegador.
    • Capturas de ecrã de mensagens de erro.
  3. Apoio da comunidade: Pesquise ou publique perguntas na Comunidade de Desenvolvedores Azure DevOps.

Conteúdo relacionado

  • Last updated on