GIT для Windows – Не удалось получить рукопожатие, соединение SSL/TLS не удалось.

Вопрос или проблема

[user]
    name = xxxxxxxxx
    email = [email protected]
[http]
    sslcapath = C:/Program Files/Git/usr/ssl/certs
    sslCAInfo = C:/Program Files/Git/usr/ssl/certs/ca-bundle.crt
    sslBackend = schannel

Ответ или решение

При возникновении ошибки "Failed to receive handshake, SSL/TLS connection failed" в Git для Windows, особенно в среде, где вы находитесь за корпоративным прокси-сервером, важно понимать, что проблема может быть связана с особенностями настройки сети и использования определённых библиотек для шифрования. Рассмотрим, как можно подойти к решению этой проблемы, используя TEA (Theory, Example, Application) подход.

Теория (Theory):

Проблема с SSL/TLS соединением часто возникает из-за неправильной настройки сертификатов или конфигураций сети. Git использует HTTPS для безопасного взаимодействия с репозиториями, и поэтому полагается на SSL/TLS протоколы для установления защищённого соединения. Когда вы находитесь за корпоративным прокси, частой причиной проблем может быть то, что прокси-сервер или корпоративная сеть внедряют свои собственные сертификаты для шифрования, что может вызвать конфликт с настройками Git.

Когда говорится о "handshake", это относится к процессу первичного обмена ключами между клиентом и сервером для установления шифрованного канала. Если "handshake" не удаётся, это может означать, что клиент (в данном случае, Git) не может доверять сертификату сервера или есть проблема на сетевом уровне, которая препятствует успешному завершению этого процесса.

Пример (Example):

Ваш сценарий: Вы разрабатываете в Visual Studio 2017 и работаете с репозиториями Git на Azure DevOps. Ошибка "SSL certificate problem: unable to get local issuer certificate" указывает на то, что Git не может проверить цепочку сертификации SSL/TLS. Это может быть связано с тем, что сертификаты, хранящиеся в системе, не соответствуют тем, которые предоставляет сервер.

Когда вы отключаетесь от корпоративной сети и подключаетесь к открытой WiFi-сети, проблема исчезает. Это лишний раз подтверждает, что проблема, скорее всего, связана с корпоративной сетью.

После установки Git Credential Manager и обновления Git до версии 2.19.1, ошибка изменилась на "Failed to receive handshake, SSL/TLS connection failed". Это изменение ошибки подчёркивает роль настроек шифрования и прокси в проблеме.

Применение (Application):

1. Проверка прокси-настроек: Убедитесь, что прокси-настройки в Git корректны. Попробуйте выполнить команду в командной строке: git config --global --get http.proxy. Если прокси настроен, попробуйте отключить валидацию SSL для диагностики командой: git config --global http.sslVerify false. Это временная мера для проверки, если дело именно в валидации.

2. Настройка Schannel: Ваш .gitconfig файл указывает на использование библиотеки Schannel через настройку sslBackend = schannel. Убедитесь, что в вашей системе хранятся все необходимые корпоративные сертификаты. Настройка schannel позволяет Git использовать сертификаты, которые могут быть установлены вашими IT-администраторами в Windows хранилище сертификатов.

3. Отключение проверки отзыва сертификатов: Установка параметра http.schannelCheckRevoke=false может помочь решить проблемы, связанные с проверкой отзыва сертификатов, которые могут быть неправильно настроены вашим прокси-сервером.

4. Проверка правильной версии Git: Убедитесь, что используемая версия Git соответствует ожидаемой, с помощью команд: where git и git --version, особенно если вы работаете в среде Visual Studio, которая может иметь свою собственную версию Git.

5. Дополнительные тесты на уровнях разных подключений: Используйте командную строку для проверки работы Git команд без участия Visual Studio, чтобы исключить потенциальные проблемы, связанные с интеграцией в среде IDE.

6. Консультация с IT-отделом: Поскольку возникновение ошибок напрямую связано с корпоративной сетью, обратитесь к вашему IT-отделу для проверки политик безопасности и правильности установки необходимых сертификатов.

Следуя этим шагам, вы сможете гораздо быстрее определить источник проблемы и взять его под контроль. Надеемся, вышеописанные шаги помогут вам разрешить возникшую проблему и позволят успешно работать с Git в корпоративной среде.