Alterar a conexão da sua organização para uma ID diferente do Microsoft Entra

Azure DevOps Services

Saiba como alternar a conexão da sua organização de uma ID do Microsoft Entra para outra. Quando você altera diretórios, os recursos do projeto não são afetados.

Para obter mais informações sobre como usar a ID do Microsoft Entra com o Azure DevOps, consulte a Visão geral conceitual.

Pré-requisitos

  • Você deve ser um grupo de Administrador de Coleção de Projetos para a organização.
  • Você deve ser um membro na ID do Microsoft Entra de destino. Para obter mais informações, consulte como converter um convidado do Microsoft Entra em um membro.
  • Você deve ser um membro ou um convidado na ID do Microsoft Entra de origem.
  • Confirme se há 100 ou menos usuários em sua organização. Se sua organização tiver mais de 100 usuários, entre em contato com o Suporte para resolver os usuários desconectados. Você pode mapeá-los para suas identidades do Microsoft Entra no novo locatário.
  • Solicite que as chaves SSH sejam limpas manualmente pelo Suporte antes de alternar diretórios. Você pode encontrar as etapas de como recriar chaves SSH mais adiante neste artigo. Consulte mais informações em Perguntas Frequentes.
  • Não adicione os usuários da ID do Microsoft Entra de destino à organização do Azure DevOps.
  • Se você adicionar novos domínios personalizados ao diretório do Microsoft Entra, entre em contato com o Suporte antes de migrar os clientes para o novo domínio personalizado, pois essa ação interrompe o mapeamento de identidades existentes.

Importante

Os usuários e grupos que herdarem associação e permissões de um grupo do Microsoft Entra não herdarão mais essas permissões após a transferência. Os grupos do Microsoft Entra que foram adicionados à sua organização de DevOps do Azure não são transferidos e deixarão de existir em sua organização quando a conexão do Microsoft Entra for alterada. Todas as permissões e relações de associação feitas com esses grupos do Microsoft Entra também deixarão de existir após a transferência.

Alterar a conexão do Microsoft Entra

  1. Entre na sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione gear iconConfigurações da organização.

    Screenshot showing highlighted Organization settings button.

  3. Selecione Microsoft Entra ID e, em seguida , Alternar diretório.

    Screenshot showing Switch directory button emphasized.

  4. Selecione um diretório no menu suspenso e selecione Conectar.

    Screenshot showing Microsoft Entra dropdown menu, and then Connect button emphasized.

    Se você não conseguir encontrar seu diretório, entre em contato com o administrador do Microsoft Entra para solicitar que ele o adicione como membro à ID do Microsoft Entra.

  5. Selecione Sair.

    Screenshot showing Sign out button emphasized.

    Sua organização se conecta à sua ID do Microsoft Entra.

  6. Confirme se o processo está concluído. Termine sessão e, em seguida, abra o browser numa sessão privada e inicie sessão na sua organização com o Microsoft Entra ID ou credenciais de trabalho.

  7. Se alguns de seus membros estiverem desconectados durante esse processo, a seguinte mensagem de erro será exibida na página Microsoft Entra. Escolha Resolver para mapear os usuários desconectados. Consulte mais informações em Perguntas Frequentes.

    Screenshot showing Resolve button emphasized.

    Screenshot showing Resolve disconnected users dialog.

Informar os usuários sobre a alteração concluída

Quando você informar os usuários sobre a alteração concluída, inclua as seguintes tarefas para cada usuário na organização a ser concluída.

Limpar cache do Gerenciador de Credenciais do Git

Se você usar o Visual Studio ou a linha de comando do Git também, limpe o cache do Gerenciador de Credenciais do Git. Exclua o arquivo %LocalAppData%\GitCredentialManager\tenant.cache em cada computador cliente.

Regenerar novos PATs

Conclua as etapas em Usar tokens de acesso pessoal.

Recriar chaves SSH

Conclua as etapas a seguir para recriar suas chaves SSH.

  1. No Azure DevOps, abra seu perfil e selecione Segurança no menu suspenso resultante.

    Screenshot showing Security selection emphasized.

  2. Selecione Chaves públicas SSH e, em seguida, selecione Adicionar.

    Screenshot that shows adding an SSH public key.

  3. Insira uma descrição e dados de chave e selecione Salvar.

    Screenshot showing info dialog for creating SSH key.

  4. Copie sua chave e coloque-a em um lugar seguro, pois você não pode visualizá-la novamente.

Renomeie seu MSA

Renomeie sua conta da Microsoft para um email diferente que não entre em conflito com sua identidade do Microsoft Entra. Isso garante que você não seja solicitado a escolher entre contas.

Ajustar sua assinatura do VS

Se o UPN usado dentro de sua organização for alterado, ajuste sua assinatura do Visual Studio. Você pode reatribuir a assinatura ao seu novo UPN ou definir esse UPN como a conta alternativa dentro da assinatura. Para obter mais informações, consulte como adicionar uma conta alternativa à sua assinatura.