Como resolver problemas de autenticação Git NTLM no Azure DevOps

Mia Chevalier
Segunda-feira, 20 de maio de 2024 às 00:24:40
Python, Bash

Solução de problemas de falhas de autenticação

Clonar um repositório hospedado em um servidor Azure DevOps usando Git às vezes pode apresentar desafios, especialmente com autenticação. Embora o Visual Studio lide perfeitamente com a maioria das configurações, a instalação do Git em um novo cliente sem o Visual Studio pode levar a falhas de autenticação inesperadas. Esse problema geralmente surge devido a diferenças na forma como as credenciais são gerenciadas e processadas.

Este artigo aborda um problema específico em que a autenticação NTLM falha em uma nova configuração de cliente. Exploraremos os sintomas, logs e possíveis causas desse problema e forneceremos soluções para ajudá-lo a autenticar e clonar seu repositório com êxito. Compreender os meandros da autenticação NTLM e do gerenciamento de credenciais Git será fundamental para resolver esse problema.

Autenticação NTLM com Git e Azure DevOps

Script de back-end em Python para gerenciamento de credenciais

import os
import subprocess
import keyring

def store_credentials(service_name, username, password):
    keyring.set_password(service_name, username, password)

def get_credentials(service_name, username):
    return keyring.get_password(service_name, username)

def configure_git_credentials(service_name, repo_url, username):
    password = get_credentials(service_name, username)
    if password is None:
        raise Exception("No stored credentials found.")
    command = ["git", "credential", "approve"]
    input_data = f"url={repo_url}\nusername={username}\npassword={password}\n"
    subprocess.run(command, input=input_data.encode(), check=True)

# Usage example:
# store_credentials("devops.mydomain.com", "myusername", "mypassword")
# configure_git_credentials("devops.mydomain.com", "https://devops.mydomain.com/Global/myrepo/_git/myrepo", "myusername")

Configurando Git para autenticação NTLM

Script de front-end no Bash para definir configurações do Git

#!/bin/bash

REPO_URL="https://devops.mydomain.com/Global/myrepo/_git/myrepo"
USERNAME="myusername"
PASSWORD="mypassword"

# Configure Git to use the credential manager
git config --global credential.helper manager-core

# Store credentials using git-credential-manager
echo "url=$REPO_URL" | git credential approve
echo "username=$USERNAME" | git credential approve
echo "password=$PASSWORD" | git credential approve

# Clone the repository
git clone $REPO_URL

Corrigindo problemas de autenticação NTLM no Git

Script do PowerShell para garantir a autenticação NTLM correta

param (
    [string]$repoUrl = "https://devops.mydomain.com/Global/myrepo/_git/myrepo",
    [string]$username = "myusername",
    [string]$password = "mypassword"
)

function Set-GitCredentials {
    param (
        [string]$repoUrl,
        [string]$username,
        [string]$password
    )

    $creds = @{
        url = $repoUrl
        username = $username
        password = $password
    }

    $creds | ConvertTo-Json | git credential-manager approve
}

# Set the credentials and clone the repo
Set-GitCredentials -repoUrl $repoUrl -username $username -password $password
git clone $repoUrl

Resolvendo problemas de autenticação NTLM

Os problemas de autenticação NTLM geralmente surgem devido a diferenças na configuração entre vários clientes e os ambientes em que operam. Um problema comum é a falta de gerenciamento adequado de credenciais. Quando o Git tenta autenticar usando NTLM, ele depende do gerenciador de credenciais para fornecer as credenciais necessárias. Se essas credenciais não estiverem disponíveis ou configuradas corretamente, a autenticação falhará. Isso pode ser particularmente problemático em ambientes onde o Visual Studio não está instalado, pois normalmente ele lida com grande parte dessa configuração automaticamente.

Outro aspecto a considerar são as configurações de rede subjacentes e como elas interagem com a autenticação NTLM. Por exemplo, o cliente Git deve ser configurado corretamente para se comunicar por meio de canais seguros, e quaisquer discrepâncias nas configurações de SSL/TLS podem levar a falhas de autenticação. Garantir que o cliente Git use o back-end SSL correto, como Schannel no Windows, e que todos os certificados relevantes estejam instalados corretamente, é crucial para uma autenticação bem-sucedida. Além disso, questões específicas do ambiente, como configurações de proxy e regras de firewall, também podem impactar o processo de autenticação.

  1. Por que a autenticação NTLM falha em um cliente, mas não em outro?
  2. A falha pode ser devido a diferenças na configuração ou falta de credenciais. Certifique-se de que ambos os clientes estejam configurados de forma idêntica e tenham as credenciais necessárias armazenadas.
  3. Como posso armazenar credenciais do Git com segurança no meu sistema?
  4. Use o função em Python para armazenar credenciais com segurança no chaveiro do sistema.
  5. Qual é o papel no script de autenticação?
  6. Este comando é usado para executar um subprocesso que configura o Git com as credenciais necessárias, garantindo que o cliente Git possa se autenticar corretamente.
  7. Como configuro o Git para usar o núcleo do gerenciador de credenciais?
  8. Execute o comando para configurar o Git para usar o núcleo do gerenciador de credenciais globalmente.
  9. Por que o handshake NTLM foi rejeitado no meu novo cliente?
  10. O handshake pode ser rejeitado devido a credenciais ausentes ou incorretas ou devido a problemas de configuração SSL/TLS.
  1. Como aprovo credenciais no Git usando um script Bash?
  2. Use o comando para armazenar a URL do repositório no gerenciador de credenciais Git.
  3. Qual é a função de no PowerShell?
  4. Este comando converte credenciais para o formato JSON e as aprova no gerenciador de credenciais Git, garantindo a autenticação adequada.
  5. As diferenças nas configurações de SSL/TLS podem afetar a autenticação NTLM?
  6. Sim, discrepâncias nas configurações de SSL/TLS podem levar a falhas de autenticação. Certifique-se de que o back-end e os certificados SSL corretos sejam usados.
  7. Como as configurações de rede podem afetar a autenticação NTLM?
  8. As configurações de proxy e regras de firewall podem interferir no processo de autenticação. Certifique-se de que a configuração da sua rede permite a comunicação adequada.
  9. O que é a Autenticação Integrada do Windows e como ela se relaciona com o NTLM?
  10. A Autenticação Integrada do Windows (WIA) inclui NTLM e outros protocolos. Ele permite autenticação contínua usando credenciais do Windows.

Considerações finais sobre como resolver problemas de autenticação NTLM do Git

Concluindo, as falhas de autenticação NTLM ao clonar repositórios Git do Azure DevOps podem ser resolvidas garantindo o gerenciamento e a configuração adequados de credenciais. Usar ferramentas como o chaveiro do sistema para armazenar credenciais com segurança e configurar o Git para usar o gerenciador de credenciais pode resolver a maioria dos problemas. Além disso, prestar atenção às configurações de SSL/TLS e configurações de rede é crucial. Seguindo as etapas e scripts descritos, os usuários podem superar problemas de autenticação e manter acesso contínuo aos seus repositórios, independentemente do ambiente do cliente.