Alterar a ligação da sua organização para um ID diferente do Microsoft Entra

  • Artigo

Serviços de DevOps do Azure

Saiba como mudar a ligação da sua organização de um ID do Microsoft Entra para outro. Quando você altera diretórios, os recursos do projeto permanecem inalterados.

Para obter mais informações sobre como usar o Microsoft Entra ID 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 no ID do Microsoft Entra de destino. Para obter mais informações, consulte como converter um convidado do Microsoft Entra em membro.
  • Você deve ser um membro ou um convidado na ID Microsoft Entra de origem.
  • Confirme se há 100 ou menos usuários em sua organização. Se a sua organização tiver mais de 100 utilizadores, contacte o Serviço de Apoio para resolver quaisquer utilizadores desligados. 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 mudar de diretório. Você pode encontrar as etapas de como recriar chaves SSH mais adiante neste artigo. Para obter mais informações, consulte as FAQs.
  • 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 herdam membros 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 do Azure DevOps não são transferidos e deixarão de existir na 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. Inicie sessão na sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione gear iconDefiniçõ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, em seguida, 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 Terminar sessão.

    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 seu ID do Microsoft Entra ou credenciais de trabalho.

  7. Se alguns dos seus membros forem desconectados durante esse processo, a seguinte mensagem de erro será exibida na página Microsoft Entra. Escolha Resolver para mapear os usuários desconectados. Para obter mais informações, consulte as FAQs.

    Screenshot showing Resolve button emphasized.

    Screenshot showing Resolve disconnected users dialog.

Informar os utilizadores da alteração concluída

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

Limpar cache para o Git Credential Manager

Se você também usar o Visual Studio ou a linha de comando do Git, limpe o cache do Gerenciador de Credenciais do Git. Exclua o arquivo %LocalAppData%\GitCredentialManager\tenant.cache em cada máquina 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. Introduza uma descrição e os dados da chave e, em seguida, selecione Guardar.

    Screenshot showing info dialog for creating SSH key.

  4. Copie a sua chave e coloque-a num local seguro, pois não poderá voltar a vê-la.

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 a sua subscrição VS

Se o UPN usado dentro de sua organização foi 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.