Аутентификация в ограниченных реестрах

Unity · Версия 2020.3 LTS · Manual

Аутентификация в ограниченных реестрах

Некоторые организации размещают свои собственные пакеты в частных реестрах пакетов, для доступа к которым требуется проверка подлинности. Если вы являетесь сотрудником или клиентом одной из этих организаций, вы должны настроить реестр с ограниченной областью действия с аутентификацией npm. Чтобы настроить это, получите токен аутентификации npm, а затем добавьте этот токен в файл конфигурации пользователя.

Получение токена аутентификации npm

Процесс создания токена аутентификации npm и доступа к нему отличается для каждого поставщика реестра. Например, Bintray (откроется другой сайт) от JFrog и Artifactory (откроется другой сайт) Менеджеры репозиториев используют другую процедуру для создания токена аутентификации из npm. Это пример типичной процедуры, но вам необходимо следовать процессу, рекомендованному поставщиком реестра пакетов для вашего реестра с заданной областью.

Чтобы получить токен аутентификации из npm:

  1. Установите npm (откроется другой сайт) локально на своем компьютере.
  2. В терминале введите эту команду, чтобы войти в реестр: $ npm login --registry
  3. Найдите и откройте сгенерированный файл .npmrc (откроется другой сайт).
  4. Найдите запись _authToken или _auth и скопируйте ее значение (см. пример ниже).
    В зависимости от реестра строка токена может быть идентификатором GUID, токеном или строкой в собственном формате.

Примеры файлов .npmrc

Это пример файла .npmrc, содержащего атрибут _authToken:

registry=https://example.com:1234/mylocation/
//example.com:1234/mylocation/:_authToken=

Это пример файла .npmrc, содержащего атрибут _auth:

registry=https://example.com:1234/mylocation
_auth=
email=
always-auth=true

Настройка аутентификационных данных

Сохраняйте информацию о маркере для каждого реестра с заданной областью действия, для которого требуется проверка подлинности, в .upmconfig.toml файле конфигурации пользователя используя схему конфигурации npmAuth. После того как вы сохраните эту информацию в файле конфигурации, диспетчер пакетов будет предоставлять вашу информацию для аутентификации при каждом запросе к каждому реестру в файле.

Следуйте этим инструкциям, чтобы добавить информацию для аутентификации в файл конфигурации пользователя:

  1. Найдите .upmconfig.toml файл конфигурации пользователя. Если файл еще не существует, создайте пустой текстовый файл.
  2. Отформатируйте информацию для аутентификации, используя схему, в зависимости от того, какой механизм аутентификации вы используете: Bearer (на основе токенов) или Basic (с шифрованием Base64):
[npmAuth.""]
 = ""
email = ""
alwaysAuth = 

В этой таблице поясняется, как указать значения файла конфигурации:

Entry: Description:
[npmAuth.""] Необходимый. URL для реестра. Например, [npmAuth."https://example.com:8081/mylocation"].
= "" Необходимый. Токен аутентификации сгенерирован из реестра npm. Это может быть либо GUID, токен, либо строка в собственном формате. Например, это может быть либо token = "" (Bearer), либо _auth = "" (базовый).
email Необязательный. Адрес электронной почты пользователя, совпадающий с адресом электронной почты пользователя в реестре.
alwaysAuth Необязательный. Установите значение true, если метаданные пакета и tar-архивы находятся на разных серверах. Как правило, вы можете скопировать значение из сгенерированного вами файла .npmrc.

Пример использования Bearer-аутентификации

[npmAuth."http://localhost:8081/myrepository/mylocation"]
token = "NpmToken.2348c7ea-6f86-3dbe-86b6-f257e86569a8"
alwaysAuth = true

[npmAuth."http://localhost:4873"]
token = "eaJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZWFsX2dyb3VwcyI6WyJwYXNjYWxsIl0sIm5hbWUiOiJwYXNjYWxsIiwiZ3JvdXBzIjpbInBhc2NhbGwiLCIkYWxsIiwiJGF1dGhlbnRpY2F0ZWQiLCJAYWxsIiwiQGF1dGhlbnRpY2F0ZWQiLCJhbGwiLCJwYXNjYWxsIl0sImlhdCI6MTU3NDY4ODQ5MCwibmJmIjoxNTc0Njg4NDkxLCJleHAiOjE1Nzk4NzI0OTB9.qF8_0ue1ppraWLkReT06AMG6R7RZuDiV2XinxMkdSo0"

[npmAuth."https://api.bintray.example/npm/mycompany/myregistry"]
token = "aGFzY2FsbDo4ZWIwNTM5NzBjNTI3OTIwYjQ4MDVkYzY2YWEzNmQxOTkyNDYzZjky"
email = "username@example.com"
alwaysAuth = true

Обновлено 17 ноября 2026 г.