Unity 6.3
0 онлайн 3 гостей 3 в системе
Вход
← Руководство

Использование приватных репозиториев с HTTPS-адресами Git

Когда вы обращаетесь к закрытому репозиторию по HTTPS из терминала, Git запрашивает имя пользователя и пароль. Затем Git передаёт эти учётные данные серверу и продолжает выполнение команды, если сервер их принял и разрешил доступ к репозиторию.

Когда Unity Package Manager получает пакеты с помощью Git URLs, нет терминала для ввода учетных данных пользователей. В результате, когда сервер запрашивает учетные данные из Git, Git не выдает запрос. Вместо этого он сообщает об ошибке Unity Package Manager. Чтобы решить эту проблему, вы должны настроить Git с помощью Git credential helper, и этот helper должен уже иметь загруженные необходимые учетные данные для этого хранилища. Если учетные данные действительны, Git может успешно выполнить команды, выданные Unity Package Manager.

Примечание: Помощник учётных данных Git не действует при использовании URL-адресов Git по протоколу SSH, включая синтаксис в стиле SCP. О доступе к закрытому репозиторию Git по SSH см. Использование защищённых парольной фразой SSH-ключей с SSH-адресами Git.

Менеджер учетных данных Git

Хотя Git поддерживает несколько вспомогательных средств для хранения учётных данных, рекомендуется использовать Менеджер учетных данных Git (GCM). GCM отличается гибкостью, простотой установки и активной поддержкой. Он создан на платформе .NET, поэтому может работать в Windows, macOS и дистрибутивах Linux с поддержкой .NET.

По умолчанию, GCM использования Windows Диспетчер удостоверений личности Windows) и macOS Брелок (на macOS) в качестве настроенного хранилища учетных данных. GCM нет хранилища по умолчанию, настроенного для Linux. См. GCM документация хранилищ учетных данных дополнительные сведения о различных конфигурациях хранилища учетных данных, поддерживаемых GCM.

Предварительные условия

Прежде чем получать пакеты из закрытых репозиториев Git по HTTPS-адресам, обязательно установите GCM.

Установщик Git для Windows включает шаг автоматической установки и настройки GCM. Вы также можете установить GCM отдельно, если:

  • Использован другой метод установки Git на Windows.
  • Используйте macOS или Linux.

См. инструкции по установке GCM для получения дополнительной информации об установке GCM.

Процедуры

Процедура зависит от того, использует ли хранилище двухфакторную аутентификацию (2FA).

Процедура для хранилищ, не использующих 2FA

Чтобы получать пакеты из закрытых репозиториев по HTTPS-адресам Git без 2FA, выполните следующие действия:

  1. Настройте Git на использование GCM, запустив в терминале следующую команду:

    git config --global credential.helper manager

  2. Доступ к хранилищу один раз с помощью терминала. Например, запустите следующую команду:

    git ls-remote --heads https://<url-to-repository> HEAD

  3. Если учетная запись пользователя имеет доступ к удалённому серверу Git и сервер принимает ваши учетные данные, то помощник Git по учетным данным безопасно сохранит ваши учетные данные.

  4. Используйте Unity Package Manager. Он будет использовать ваши сохраненные учетные данные, когда это необходимо, для получения пакетов из хранилищ, основанных на HTTPS, к которым у вас есть права доступа.

Процедура для хранилищ, использующих 2FA

Если в вашем хранилище включена двухфакторная аутентификация, вы не можете использовать свои учетные данные для доступа к пакетам через HTTPS.. Вместо этого вы должны использовать в качестве пароля персональный токен доступа (PAT).

Чтобы получать пакеты из закрытых репозиториев по HTTPS-адресам Git с 2FA, выполните следующие действия:

  1. Создание личного токена доступа:

    • Перейдите на веб-сайт вашего поставщика хостинга Git, например, GitHub или GitLab.

    • Откройте раздел Настройки разработчика, Токены доступа или эквивалентный раздел учетной записи.

    • Создайте новый токен со следующими данными:

      • Имя или Описание: Нечто значимое (например, Unity UPM Доступ).
      • Дата истечения срока действия: Факультативно, но рекомендуется для обеспечения безопасности.
      • Области или Разрешения: Как правило, read_repository или подобное, если вам просто нужен доступ для клонирования или вытягивания.

    • Сохраните токен в безопасном месте. Большинство поставщиков покажут токен только один раз.

  2. Настройка Git на использование PAT:

    • Когда Git запрашивает учетные данные при клонировании, загрузке или отправке:

      • Пользовательское имя: Имя пользователя вашей учетной записи (или иногда ваш адрес электронной почты, в зависимости от хоста).
      • Пароль: Ваш PAT (вместо вашего обычного пароля).

  3. Храните свои учетные данные (необязательно):

    Чтобы не вводить свои учетные данные каждый раз, вы можете использовать менеджер учетных данных Git:

    • Windows

        git config --global credential.helper manager-core

    • macOS

        git config --global credential.helper osxkeychain

Дополнительные ресурсы