Работа по HTTPS через Git Credential Manager

Info

Git Credential Manager (GCM) — помощник Git для хранения учетных данных. При работе с GitVerse по HTTPS он авторизует пользователя через браузер и сохраняет полученный токен. Вводить пароль или создавать токен авторизации вручную не требуется.

По умолчанию GCM обращается к адресам авторизации, которых нет на GitVerse. Поэтому перед первой работой с репозиторием необходимо выполнить настройку, описанную ниже.

Требования

  • установлен Git и Git Credential Manager. В Git для Windows GCM входит в состав установщика;
  • для репозиториев с большими файлами установлен Git LFS.

Настройка

Откройте командную строку и выполните команды:

  1. Укажите адрес страницы авторизации GitVerse:
git config --global credential.https://gitverse.ru.oauthAuthorizeEndpoint /signin/oauth/authorize
  1. Укажите область доступа токена:
git config --global credential.https://gitverse.ru.oauthScopes write:repository
  1. Если в репозитории используется Git LFS, перейдите в директорию репозитория и отключите передачу типа содержимого при загрузке LFS-объектов:
git config --local lfs.contenttype false

Note

Параметры с флагом --global действуют для всех репозиториев GitVerse на вашем компьютере, поэтому шаги 1 и 2 достаточно выполнить один раз.

Если вы хотите применить их только к одному репозиторию, перейдите в его директорию и выполните те же команды с флагом --local вместо --global.

Шаг 3 выполняется с флагом --local в каждом репозитории, где используется Git LFS.

Проверка

Выполните любую операцию с удаленным репозиторием, например:

git push -u origin <имя_ветки>

GCM откроет браузер. Войдите в учетную запись GitVerse и подтвердите доступ. После этого Git выполнит операцию, а GCM сохранит учетные данные для следующих запросов.

Решение проблем

При авторизации открывается несуществующая страница

GCM использует адрес авторизации по умолчанию. Выполните шаг 1 настройки и повторите операцию.

Ошибка «Недопустимая область доступа»

GCM запрашивает токен без указания области доступа. Выполните шаг 2 настройки и повторите операцию. Если браузер снова запросит подтверждение доступа, подтвердите его.

Ошибка «403 Forbidden» при загрузке LFS-объектов

Если Git LFS передает тип содержимого файла (например, application/pdf), загрузка объекта может быть отклонена с ошибкой 403 Forbidden. Выполните шаг 3 настройки и повторите git push.

Другие способы аутентификации Git

  1. Работа по HTTPS.
  2. SSH ключи.
  3. Токены авторизации.

Вид графа

Связанные страницы