Så här löser du Git NTLM-autentiseringsproblem på Azure DevOps

Mia Chevalier
Måndag 20 maj 2024 00:33:26
Python, Bash

Felsökning av autentiseringsfel

Att klona ett arkiv som finns på en Azure DevOps-server med Git kan ibland innebära utmaningar, särskilt med autentisering. Medan Visual Studio hanterar de flesta konfigurationer sömlöst, kan installation av Git på en ny klient utan Visual Studio leda till oväntade autentiseringsfel. Det här problemet uppstår ofta på grund av skillnader i hur autentiseringsuppgifter hanteras och bearbetas.

Den här artikeln tar upp ett specifikt problem där NTLM-autentisering misslyckas på en ny klientinstallation. Vi kommer att undersöka symptomen, loggar och potentiella orsaker till det här problemet och tillhandahålla lösningar som hjälper dig att framgångsrikt autentisera och klona ditt arkiv. Att förstå krångligheterna med NTLM-autentisering och Git-behörighetshantering kommer att vara nyckeln till att lösa detta problem.

NTLM-autentisering med Git och Azure DevOps

Backend-skript i Python för Credential Management

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")

Konfigurera Git för NTLM-autentisering

Frontend-skript i Bash för att ställa in Git-konfigurationer

#!/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

Åtgärda NTLM-autentiseringsproblem i Git

PowerShell-skript för att säkerställa korrekt NTLM-autentisering

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

Åtgärda NTLM-autentiseringsproblem

NTLM-autentiseringsproblem uppstår ofta på grund av skillnader i konfiguration mellan olika klienter och de miljöer de arbetar i. Ett vanligt problem är bristen på korrekt hantering av autentiseringsuppgifter. När Git försöker autentisera med NTLM, förlitar den sig på att behörighetshanteraren tillhandahåller de nödvändiga referenserna. Om dessa autentiseringsuppgifter inte är tillgängliga eller korrekt konfigurerade kommer autentiseringen att misslyckas. Detta kan vara särskilt besvärligt i miljöer där Visual Studio inte är installerat, eftersom det vanligtvis hanterar mycket av denna konfiguration automatiskt.

En annan aspekt att tänka på är de underliggande nätverksinställningarna och hur de interagerar med NTLM-autentisering. Till exempel måste Git-klienten vara korrekt konfigurerad för att kommunicera över säkra kanaler, och eventuella avvikelser i SSL/TLS-inställningar kan leda till autentiseringsfel. Att säkerställa att Git-klienten använder rätt SSL-backend, såsom Schannel på Windows, och att alla relevanta certifikat är korrekt installerade, är avgörande för framgångsrik autentisering. Dessutom kan miljöspecifika problem som proxyinställningar och brandväggsregler också påverka autentiseringsprocessen.

  1. Varför misslyckas NTLM-autentisering på en klient men inte på en annan?
  2. Felet kan bero på skillnader i konfiguration eller saknade autentiseringsuppgifter. Se till att båda klienterna är identiskt konfigurerade och har de nödvändiga referenserna lagrade.
  3. Hur kan jag lagra Git-uppgifter säkert på mitt system?
  4. Använd funktion i Python för att lagra inloggningsuppgifter säkert i systemets nyckelring.
  5. Vad är rollen för i autentiseringsskriptet?
  6. Det här kommandot används för att köra en underprocess som konfigurerar Git med nödvändiga referenser, vilket säkerställer att Git-klienten kan autentisera sig ordentligt.
  7. Hur konfigurerar jag Git att använda referenshanterarens kärna?
  8. Kör kommandot för att ställa in Git för att använda credential manager-kärnan globalt.
  9. Varför avvisas NTLM-handslaget på min nya klient?
  10. Handskakningen kan avvisas på grund av saknade eller felaktiga referenser, eller på grund av SSL/TLS-konfigurationsproblem.
  1. Hur godkänner jag autentiseringsuppgifter i Git med ett Bash-skript?
  2. Använd kommandot för att lagra arkivets URL i Gits autentiseringshanterare.
  3. Vad är funktionen för i PowerShell?
  4. Detta kommando konverterar autentiseringsuppgifter till JSON-format och godkänner dem i Gits autentiseringshanterare, vilket säkerställer korrekt autentisering.
  5. Kan skillnader i SSL/TLS-inställningar påverka NTLM-autentisering?
  6. Ja, avvikelser i SSL/TLS-inställningar kan leda till autentiseringsfel. Se till att rätt SSL-backend och certifikat används.
  7. Hur kan nätverksinställningar påverka NTLM-autentisering?
  8. Proxyinställningar och brandväggsregler kan störa autentiseringsprocessen. Se till att din nätverkskonfiguration tillåter korrekt kommunikation.
  9. Vad är Windows Integrated Authentication och hur relaterar det till NTLM?
  10. Windows Integrated Authentication (WIA) inkluderar NTLM och andra protokoll. Det möjliggör sömlös autentisering med Windows-referenser.

Sista tankar om att lösa Git NTLM-autentiseringsproblem

Sammanfattningsvis kan NTLM-autentiseringsfel vid kloning av Git-arkiv från Azure DevOps lösas genom att säkerställa korrekt autentiseringshantering och konfiguration. Att använda verktyg som systemets nyckelring för att säkert lagra autentiseringsuppgifter och konfigurera Git för att använda autentiseringshanteraren kan lösa de flesta problem. Dessutom är det viktigt att uppmärksamma SSL/TLS-inställningar och nätverkskonfigurationer. Genom att följa de skisserade stegen och skripten kan användare övervinna autentiseringsproblem och upprätthålla sömlös åtkomst till sina arkiv, oavsett klientmiljö.