Як вирішити проблеми автентифікації Git NTLM на Azure DevOps

Mia Chevalier
понеділок, 20 травня 2024 р. о 00:41:22
Python, Bash

Усунення несправностей автентифікації

Клонування репозиторію, розміщеного на сервері Azure DevOps за допомогою Git, іноді може викликати проблеми, особливо з автентифікацією. Хоча Visual Studio легко обробляє більшість конфігурацій, інсталяція Git на новому клієнті без Visual Studio може призвести до неочікуваних помилок автентифікації. Ця проблема зазвичай виникає через відмінності в тому, як облікові дані керуються та обробляються.

У цій статті розглядається конкретна проблема, коли не вдається автентифікація NTLM під час нового налаштування клієнта. Ми вивчимо симптоми, журнали та потенційні причини цієї проблеми та запропонуємо рішення, які допоможуть вам успішно автентифікувати та клонувати ваше сховище. Розуміння тонкощів автентифікації NTLM і керування обліковими даними Git буде ключем до вирішення цієї проблеми.

Автентифікація NTLM за допомогою Git і Azure DevOps

Backend Script у Python для керування обліковими даними

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

Налаштування Git для автентифікації NTLM

Сценарій інтерфейсу в Bash для налаштування конфігурацій 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

Виправлення проблем автентифікації NTLM у Git

Сценарій PowerShell для забезпечення правильної автентифікації NTLM

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

Вирішення проблем автентифікації NTLM

Проблеми з автентифікацією NTLM часто виникають через відмінності в конфігурації між різними клієнтами та середовищами, у яких вони працюють. Однією з поширених проблем є відсутність належного керування обліковими даними. Коли Git намагається автентифікуватись за допомогою NTLM, він покладається на менеджер облікових даних, щоб надати необхідні облікові дані. Якщо ці облікові дані недоступні або правильно налаштовані, автентифікація не вдасться. Це може бути особливо неприємним у середовищах, де Visual Studio не встановлено, оскільки зазвичай вона обробляє більшу частину цієї конфігурації автоматично.

Іншим аспектом, який слід враховувати, є базові параметри мережі та те, як вони взаємодіють з автентифікацією NTLM. Наприклад, клієнт Git має бути належним чином налаштований для зв’язку через захищені канали, і будь-які розбіжності в налаштуваннях SSL/TLS можуть призвести до помилок автентифікації. Для успішної автентифікації важливо переконатися, що клієнт Git використовує правильний сервер SSL, наприклад Schannel у Windows, і що всі відповідні сертифікати правильно встановлено. Крім того, на процес автентифікації також можуть впливати проблеми, пов’язані з середовищем, наприклад налаштування проксі-сервера та правила брандмауера.

  1. Чому не вдається автентифікація NTLM на одному клієнті, але не на іншому?
  2. Помилка може бути наслідком відмінностей у конфігурації або відсутності облікових даних. Переконайтеся, що обидва клієнти налаштовані однаково та мають збережені необхідні облікові дані.
  3. Як я можу безпечно зберігати облікові дані Git у своїй системі?
  4. Використовувати функція в Python для безпечного зберігання облікових даних у зв’язку ключів системи.
  5. Яка роль у сценарії автентифікації?
  6. Ця команда використовується для запуску підпроцесу, який налаштовує Git за допомогою необхідних облікових даних, забезпечуючи належну автентифікацію клієнта Git.
  7. Як налаштувати Git на використання ядра диспетчера облікових даних?
  8. Виконайте команду щоб налаштувати Git на глобальне використання ядра диспетчера облікових даних.
  9. Чому на моєму новому клієнті відхилено рукостискання NTLM?
  10. Рукостискання може бути відхилено через відсутність або неправильність облікових даних або через проблеми з конфігурацією SSL/TLS.
  1. Як затвердити облікові дані в Git за допомогою сценарію Bash?
  2. Використовуйте команду щоб зберегти URL-адресу сховища в менеджері облікових даних Git.
  3. Яка функція в PowerShell?
  4. Ця команда перетворює облікові дані у формат JSON і затверджує їх у менеджері облікових даних Git, забезпечуючи належну автентифікацію.
  5. Чи можуть відмінності в налаштуваннях SSL/TLS вплинути на автентифікацію NTLM?
  6. Так, розбіжності в налаштуваннях SSL/TLS можуть призвести до збоїв автентифікації. Переконайтеся, що використовується правильний сервер SSL і сертифікати.
  7. Як налаштування мережі можуть впливати на автентифікацію NTLM?
  8. Параметри проксі-сервера та правила брандмауера можуть заважати процесу автентифікації. Переконайтеся, що конфігурація вашої мережі забезпечує належний зв’язок.
  9. Що таке інтегрована автентифікація Windows і як вона пов’язана з NTLM?
  10. Інтегрована автентифікація Windows (WIA) включає NTLM та інші протоколи. Це дозволяє безперебійну автентифікацію за допомогою облікових даних Windows.

Останні думки щодо вирішення проблем автентифікації Git NTLM

Підсумовуючи, помилки автентифікації NTLM під час клонування сховищ Git із Azure DevOps можна вирішити, забезпечивши належне керування обліковими даними та конфігурацію. Використання таких інструментів, як системний брелок для безпечного зберігання облікових даних і налаштування Git для використання диспетчера облікових даних, може вирішити більшість проблем. Крім того, дуже важливо звернути увагу на параметри SSL/TLS і мережеві конфігурації. Дотримуючись описаних кроків і сценаріїв, користувачі можуть подолати проблеми автентифікації та підтримувати безперебійний доступ до своїх репозиторіїв, незалежно від середовища клієнта.