Проверка подлинности реестра

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

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

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

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

Установите npm локально на своем компьютере.
В терминале введите эту команду, чтобы войти в реестр: $ npm login --registry
Найдите и откройте сгенерированный файл .npmrc.
Найдите запись _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. После того как вы сохраните эту информацию в файле конфигурации, диспетчер пакетов будет предоставлять вашу информацию для аутентификации при каждом запросе к каждому реестру в файле.

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

Найдите .upmconfig.toml файл конфигурации пользователя. Если файл еще не существует, создайте пустой текстовый файл.
Отформатируйте информацию для аутентификации, используя схему, в зависимости от того, какой механизм аутентификации вы используете: 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

Вы можете отблагодарить автора, за перевод документации на русский язык. ₽ Спасибо