Sådan løses Git NTLM-godkendelsesproblemer på Azure DevOps

Mia Chevalier
Mandag den 20. maj 2024 kl. 00.00.31
Python, Bash

Fejlfinding af godkendelsesfejl

Kloning af et lager, der er hostet på en Azure DevOps-server ved hjælp af Git, kan nogle gange give udfordringer, især med godkendelse. Mens Visual Studio håndterer de fleste konfigurationer problemfrit, kan installation af Git på en ny klient uden Visual Studio føre til uventede autentificeringsfejl. Dette problem opstår ofte på grund af forskelle i, hvordan legitimationsoplysninger administreres og behandles.

Denne artikel behandler et specifikt problem, hvor NTLM-godkendelse mislykkes på en ny klientopsætning. Vi vil udforske symptomerne, logfilerne og potentielle årsager til dette problem og levere løsninger, der hjælper dig med at autentificere og klone dit lager. Forståelse af forviklingerne ved NTLM-godkendelse og Git-legitimationsstyring vil være nøglen til at løse dette problem.

NTLM-godkendelse med Git og Azure DevOps

Backend-script i Python til legitimationsstyring

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

Konfiguration af Git til NTLM-godkendelse

Frontend-script i Bash for at opsætte 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

Løsning af NTLM-godkendelsesproblemer i Git

PowerShell-script for at sikre korrekt NTLM-godkendelse

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

Løsning af NTLM-godkendelsesproblemer

NTLM-godkendelsesproblemer opstår ofte på grund af forskelle i konfigurationen mellem forskellige klienter og de miljøer, de opererer i. Et almindeligt problem er manglen på korrekt legitimationsstyring. Når Git forsøger at godkende ved hjælp af NTLM, er den afhængig af legitimationsadministratoren for at give de nødvendige legitimationsoplysninger. Hvis disse legitimationsoplysninger ikke er tilgængelige eller korrekt konfigureret, mislykkes godkendelsen. Dette kan være særligt besværligt i miljøer, hvor Visual Studio ikke er installeret, da det typisk håndterer meget af denne konfiguration automatisk.

Et andet aspekt at overveje er de underliggende netværksindstillinger og hvordan de interagerer med NTLM-godkendelse. For eksempel skal Git-klienten være korrekt konfigureret til at kommunikere over sikre kanaler, og eventuelle uoverensstemmelser i SSL/TLS-indstillinger kan føre til autentificeringsfejl. At sikre, at Git-klienten bruger den korrekte SSL-backend, såsom Schannel på Windows, og at alle relevante certifikater er korrekt installeret, er afgørende for vellykket godkendelse. Derudover kan miljøspecifikke problemer såsom proxyindstillinger og firewallregler også påvirke godkendelsesprocessen.

  1. Hvorfor mislykkes NTLM-godkendelse på én klient, men ikke på en anden?
  2. Fejlen kan skyldes forskelle i konfiguration eller manglende legitimationsoplysninger. Sørg for, at begge klienter er konfigureret identisk og har de nødvendige legitimationsoplysninger gemt.
  3. Hvordan kan jeg gemme Git-legitimationsoplysninger sikkert på mit system?
  4. Brug funktion i Python til at opbevare legitimationsoplysninger sikkert i systemets nøglering.
  5. Hvad er rollen i godkendelsesscriptet?
  6. Denne kommando bruges til at køre en underproces, der konfigurerer Git med de nødvendige legitimationsoplysninger, hvilket sikrer, at Git-klienten kan godkendes korrekt.
  7. Hvordan konfigurerer jeg Git til at bruge credential manager-kernen?
  8. Kør kommandoen at sætte Git op til at bruge credential manager-kernen globalt.
  9. Hvorfor afvises NTLM-håndtrykket på min nye klient?
  10. Håndtrykket kan blive afvist på grund af manglende eller forkerte legitimationsoplysninger eller på grund af SSL/TLS-konfigurationsproblemer.
  1. Hvordan godkender jeg legitimationsoplysninger i Git ved hjælp af et Bash-script?
  2. Brug kommandoen for at gemme depot-URL'en i Git-legitimationsadministratoren.
  3. Hvad er funktionen af i PowerShell?
  4. Denne kommando konverterer legitimationsoplysninger til JSON-format og godkender dem i Git credential manager, hvilket sikrer korrekt godkendelse.
  5. Kan forskelle i SSL/TLS-indstillinger påvirke NTLM-godkendelse?
  6. Ja, uoverensstemmelser i SSL/TLS-indstillinger kan føre til autentificeringsfejl. Sørg for, at den korrekte SSL-backend og certifikater bruges.
  7. Hvordan kan netværksindstillinger påvirke NTLM-godkendelse?
  8. Proxyindstillinger og firewallregler kan forstyrre godkendelsesprocessen. Sørg for, at din netværkskonfiguration tillader korrekt kommunikation.
  9. Hvad er Windows Integrated Authentication, og hvordan relaterer det til NTLM?
  10. Windows Integrated Authentication (WIA) inkluderer NTLM og andre protokoller. Det giver mulighed for problemfri godkendelse ved hjælp af Windows-legitimationsoplysninger.

Endelige tanker om løsning af Git NTLM-godkendelsesproblemer

Som konklusion kan NTLM-godkendelsesfejl ved kloning af Git-lagre fra Azure DevOps løses ved at sikre korrekt legitimationsadministration og konfiguration. Brug af værktøjer som systemets nøglering til sikkert at gemme legitimationsoplysninger og konfigurere Git til at bruge legitimationsmanageren kan løse de fleste problemer. Derudover er det afgørende at være opmærksom på SSL/TLS-indstillinger og netværkskonfigurationer. Ved at følge de skitserede trin og scripts kan brugere overvinde autentificeringsproblemer og opretholde problemfri adgang til deres lagre, uanset klientmiljøet.