Cambiar la conexión de la organización a otro identificador de Entra de Microsoft

Azure DevOps Services

Obtenga información sobre cómo cambiar la conexión de su organización de un identificador de Entra de Microsoft a otro. Al cambiar los directorios, los recursos del proyecto no se ven afectados.

Para obtener más información sobre el uso de Microsoft Entra ID con Azure DevOps, consulte información general conceptual.

Requisitos previos

  • Debe ser un grupo de colección de proyectos Administración istrator para la organización.
  • Debe ser miembro del id. de Microsoft Entra de destino. Para obtener más información, vea cómo convertir un invitado de Microsoft Entra en un miembro.
  • Debe ser miembro o invitado en el id. de Microsoft Entra de origen.
  • Confirme que hay 100 o menos usuarios en su organización. Si su organización tiene más de 100 usuarios, póngase en contacto con el soporte técnico para resolver los usuarios desconectados. Puede asignarlas a sus identidades de Microsoft Entra en el nuevo inquilino.
  • Solicite que las claves SSH se borren manualmente mediante soporte técnico antes de cambiar de directorio. Puede encontrar los pasos para volver a crear claves SSH más adelante en este artículo. Para más información, consulte las preguntas más frecuentes.
  • No agregue los usuarios del identificador de Microsoft Entra de destino a la organización de Azure DevOps.
  • Si agrega nuevos dominios personalizados al directorio de Microsoft Entra, póngase en contacto con el soporte técnico antes de migrar los clientes al nuevo dominio personalizado, ya que esta acción interrumpe la asignación de identidades existentes.

Importante

Los usuarios y grupos que heredan la pertenencia y los permisos de un grupo de Microsoft Entra ya no heredarán esos permisos después de la transferencia. Los grupos de Microsoft Entra que se agregaron a la organización de Azure DevOps no se transfieren y dejan de existir en su organización cuando se cambie la conexión de Microsoft Entra. Todos los permisos y las relaciones de pertenencia realizadas con estos grupos de Microsoft Entra también dejará de existir después de la transferencia.

Cambiar la conexión de Microsoft Entra

  1. Inicie sesión en su organización (https://dev.azure.com/{yourorganization}).

  2. Seleccione gear iconConfiguración de la organización.

    Screenshot showing highlighted Organization settings button.

  3. Seleccione Microsoft Entra ID (Id. de entra de Microsoft) y, a continuación, Switch directory (Cambiar directorio).

    Screenshot showing Switch directory button emphasized.

  4. Seleccione un directorio en el menú desplegable y, a continuación, seleccione Conectar.

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

    Si no encuentra el directorio, póngase en contacto con el administrador de Microsoft Entra para solicitar que le agregue como miembro al identificador de Microsoft Entra.

  5. Seleccione Cerrar sesión.

    Screenshot showing Sign out button emphasized.

    Su organización se conecta al identificador de Microsoft Entra.

  6. Confirme que el proceso se ha completado. Cierre la sesión y, a continuación, abra el explorador en una sesión privada e inicie sesión en su organización con su identificador de Microsoft Entra o credenciales de trabajo.

  7. Si algunos de los miembros están desconectados durante este proceso, el siguiente mensaje de error se muestra en la página Microsoft Entra. Elija Resolver para asignar los usuarios desconectados. Para más información, consulte las preguntas más frecuentes.

    Screenshot showing Resolve button emphasized.

    Screenshot showing Resolve disconnected users dialog.

Informar a los usuarios del cambio completado

Cuando informe a los usuarios del cambio completado, incluya las siguientes tareas para que cada usuario de la organización se complete.

Borrar caché del Administrador de credenciales de Git

Si también usa Visual Studio o la línea de comandos de Git, borre la memoria caché del Administrador de credenciales de Git. Elimine el archivo %LocalAppData%\GitCredentialManager\tenant.cache en cada equipo cliente.

Regeneración de nuevas PAT

Complete los pasos descritos en Uso de tokens de acceso personal.

Volver a crear claves SSH

Complete los pasos siguientes para volver a crear las claves SSH.

  1. En Azure DevOps, abra el perfil y seleccione Seguridad en el menú desplegable resultante.

    Screenshot showing Security selection emphasized.

  2. Seleccione Claves públicas SSH y, a continuación, seleccione Agregar.

    Screenshot that shows adding an SSH public key.

  3. Escriba una descripción y los datos de clave y, a continuación, seleccione Guardar.

    Screenshot showing info dialog for creating SSH key.

  4. Copie la clave y colóquela en un lugar seguro, ya que no se puede volver a ver.

Cambiar el nombre de la MSA

Cambie el nombre de la cuenta Microsoft a un correo electrónico diferente que no entre en conflicto con la identidad de Microsoft Entra. Al hacerlo, se garantiza que no se le pida que elija entre cuentas.

Ajuste de la suscripción de VS

Si el UPN usado dentro de la organización ha cambiado, ajuste la suscripción de Visual Studio. Puede reasignar la suscripción a su nuevo UPN o configurar ese UPN como la cuenta alternativa dentro de la suscripción. Para obtener más información, consulte cómo agregar una cuenta alternativa a la suscripción.