mirror of https://github.com/verdaccio/verdaccio.git synced 2024-11-13 03:35:52 +01:00

History

Juan Picado a9ba3d0649 refactor: config module (#1995 ) * refactor: clean up config * refactor: config, move methods * chore: remove js-yaml from utils		2021-04-09 17:54:25 +02:00
..
src	refactor: max-len and printWidth to 100 (#1941 )	2021-04-09 17:54:20 +02:00
tests	fix: eslint errors (#1973 )	2021-04-09 17:54:23 +02:00
.babelrc	feat: relocate core packages (#1906 )	2021-04-09 17:54:13 +02:00
.eslintignore	feat: relocate core packages (#1906 )	2021-04-09 17:54:13 +02:00
.eslintrc.json	feat: relocate core packages (#1906 )	2021-04-09 17:54:13 +02:00
CHANGELOG.md	feat: relocate core packages (#1906 )	2021-04-09 17:54:13 +02:00
jest.config.js	feat: relocate core packages (#1906 )	2021-04-09 17:54:13 +02:00
LICENSE	feat: relocate core packages (#1906 )	2021-04-09 17:54:13 +02:00
package.json	refactor: config module (#1995 )	2021-04-09 17:54:25 +02:00
README.md	build: configure prettier as formatter for json, yaml and markdown (#1930 )	2021-04-09 17:54:19 +02:00
tsconfig.build.json	feat: add typescript project references settings (#1933 )	2021-04-09 17:54:19 +02:00
tsconfig.json	feat: add typescript project references settings (#1933 )	2021-04-09 17:54:19 +02:00

README.md

Verdaccio Module For User Auth Via Htpasswd

verdaccio-htpasswd is a default authentication plugin for the Verdaccio.

This plugin is being used as dependency after v3.0.0-beta.x. The v2.x still contains this plugin built-in.

Install

As simple as running:

$ npm install -g verdaccio-htpasswd

Configure

auth:
    htpasswd:
        file: ./htpasswd
        # Maximum amount of users allowed to register, defaults to "+infinity".
        # You can set this to -1 to disable registration.
        #max_users: 1000

Logging In

To log in using NPM, run:

    npm adduser --registry  https://your.registry.local

Generate htpasswd username/password combination

If you wish to handle access control using htpasswd file, you can generate username/password combination form here and add it to htpasswd file.

How does it work?

The htpasswd file contains rows corresponding to a pair of username and password separated with a colon character. The password is encrypted using the UNIX system's crypt method and may use MD5 or SHA1.

Plugin Development in Verdaccio

There are many ways to extend Verdaccio, currently it support authentication plugins, middleware plugins (since v2.7.0) and storage plugins since (v3.x).