Uso del Administrador de credenciales de Git para autenticarse en Azure Repos

Servicios de Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

El Administrador de credenciales de Git simplifica la autenticación con los repositorios de Git de Azure Repos. Los administradores de credenciales le permiten usar las mismas credenciales que usa para el portal web de Azure DevOps, lo que admite la autenticación segura a través de la cuenta Microsoft o el identificador de Microsoft Entra con autenticación multifactor integrada. El Administrador de credenciales de Git también admite la autenticación en dos fases con repositorios de GitHub.

Opciones de autenticación

El Administrador de credenciales de Git admite varios métodos de autenticación, ya que los tokens de id. de Microsoft Entra son el enfoque recomendado para mejorar la seguridad:

  • Tokens de identificación de Microsoft Entra (recomendado): proporciona una mayor seguridad con una vida útil más corta del token y una integración mejorada con las políticas de la organización.
  • Autenticación de cuenta Microsoft : cuentas personales de Microsoft con compatibilidad con la autenticación multifactor.
  • Tokens de acceso personal : disponible como alternativa. Use los tokens de Id. de Entra de Microsoft siempre que sea posible.

Integración del IDE

Azure Repos proporciona compatibilidad con IDE para la cuenta Microsoft y la autenticación de Microsoft Entra a través de los siguientes clientes:

Si el entorno no tiene disponible una integración, puede configurar el IDE con tokens de identificador de Microsoft Entra (recomendado), tokens de acceso personal o SSH para conectarse a los repositorios.

Importante

Considere la posibilidad de usar los tokens de Microsoft Entra más seguros sobre tokens de acceso personal de mayor riesgo. Para obtener más información, consulte Reducir el uso de PAT. Revise las instrucciones de autenticación para elegir el mecanismo de autenticación adecuado para sus necesidades.

Instalación del Administrador de credenciales de Git

Windows

Descargue y ejecute la versión más reciente del instalador de Git para Windows , que incluye el Administrador de Credenciales de Git. Asegúrese de habilitar la opción de instalación del Administrador de credenciales de Git.

Captura de pantalla que muestra la selección Habilitación del Administrador de credenciales de Git durante la instalación de Git para Windows.

macOS y Linux

Puede usar claves SSH para autenticarse en Azure Repos o usar el Administrador de credenciales de Git.

Las instrucciones de instalación se incluyen en el repositorio de GitHub para GCM. En macOS, se recomienda usar Homebrew . En Linux, puede instalar desde un .deb o un tarball.

Uso del Administrador de credenciales de Git

Cuando se conecta a un repositorio de Git desde el cliente de Git por primera vez, el administrador de credenciales solicita las credenciales. Proporcione su cuenta microsoft o las credenciales de Microsoft Entra. Si la cuenta tiene habilitada la autenticación multifactor, el administrador de credenciales le pedirá que realice también ese proceso.

Administrador de credenciales de Git solicitando durante la extracción de Git de extracción de Git

Una vez autenticado, el administrador de credenciales crea y almacena en caché un token para futuras conexiones al repositorio. Los comandos de Git que se conectan a esta cuenta no solicitan credenciales de usuario hasta que expire el token. Se puede revocar un token a través de Azure Repos.

De forma predeterminada, GCM puede solicitar diferentes tipos de tokens de autenticación de Azure Repos. Puede configurar la autenticación predeterminada de Git para usar tokens de ID de Microsoft Entra, que proporcionan una seguridad mejorada a través de los protocolos OAuth. Este enfoque proporciona una mejor seguridad e integración con las directivas de la organización. Obtenga más información sobre mediante GCM con Azure Repos.

git config --global credential.azreposCredentialType oauth

Uso de la autenticación de entidad de servicio

También puede proporcionar una entidad de servicio para la autenticación con GCM. Especifique los identificadores de cliente e inquilino de una entidad de servicio en este formato: {tenantId}/{clientId}.

git config --global credential.azreposServicePrincipal "11111111-1111-1111-1111-111111111111/22222222-2222-2222-2222-222222222222"

También debe establecer al menos un mecanismo de autenticación si establece este valor:

Usar IA para configurar y gestionar la autenticación del Administrador de credenciales

Los siguientes prompts de ejemplo para Copilot Chat te ayudan a entender las opciones de autenticación, configurar el Administrador de credenciales de Git, validar la configuración y solucionar problemas cuando sea necesario. Copie y pegue estas indicaciones en Copilot Chat y reemplace los marcadores de posición por los detalles del repositorio y la organización.

Tarea Mensaje de ejemplo
Elección del método de autenticación correcto For this team setup, compare Microsoft Entra ID tokens, Microsoft account sign-in, PAT, and service principal authentication in Git Credential Manager, and recommend the safest default.
Configurar Microsoft Entra como opción predeterminada Show me the exact Git Credential Manager commands to make Microsoft Entra ID token auth the default for Azure Repos on this machine.
Validar el modo de autenticación actual Review this repository and tell me whether Git Credential Manager is currently using Microsoft Entra ID tokens, Microsoft account auth, or a PAT for Azure Repos.
Auditar la posición de seguridad de las credenciales Check this Git authentication setup and point out any security risks, including PAT overuse, tenant mismatch risk, or missing credential hardening steps.
Validación de la configuración de la entidad de servicio Check this Git Credential Manager service principal configuration and explain what is missing for Azure Repos authentication to work.
Solución de problemas de mensajes de inicio de sesión repetidos I get prompted to sign in every time I run git fetch against Azure Repos. Help me troubleshoot Git Credential Manager token caching and credential store issues.

Copilot funciona con IA, por lo que es posible que se produzcan sorpresas y errores. Para obtener más información, consulte las preguntas frecuentes sobre el uso general de Copilot.

Obtención de ayuda

Puede abrir y notificar problemas con el Administrador de credenciales de Git en el proyecto de GitHub.