Verdaccio-sqlite NPM

SQLite Authentication plugin for Verdaccio

This plugin allows you to use a SQLite database as the store for your user data. This is especially useful if you already one and you want to use it for Verdaccio as well.

Install the plugin

1. Get the package with NPM

> npm install -g verdaccio-sqlite

Current release version is v1.0.2

2. Add the plugin in your Verdaccio configuration

In your config.yaml file, look for the auth section. Add the following part right after, replacing the string YOUR_[...] with your values.

auth:
    sqlite:
        path: "PATH/TO/YOUR_DB.db"
        password_secret: "YOUR_SECRET"
        queries:
            auth_user: 'SELECT QUERY'
            add_user: 'INSERT QUERY'
            update_user: 'UPDATE QUERY'

path is the path of your SQLite database file. password_secret is the secret salt used by the Crypto module of node.js. Every password that goes through this plugin is automatically encrypted using the pbkdf2Sync() method and sha512 digest. Please check that you password column can receive atleast 128 characters.

3. Specify custom queries to match your database schema.

Similarly as prepared queries, the parameters for each query must be declared in the query with ? as placeholders.

`auth_user`: Authentication query

This is the query that will be ran for each authentication tentative.

This query has two parameters in this exact order:

The username provided by the user
The password given

If the authentication is successful, the query must return one row with two columns:

username: Username of the user.
usergroups: comma-separated list of all user's groups.

If not successful, the query must return an empty recordset.

`add_user`: New user query

This query allows users to create a new record in the database.

This query has two parameters in this exact order:

The username for the new user
The password given

Declare add_user as an empty string to forbid anyone to create a new user in the database from Verdaccio or the npm CLI.

`update_user`: Update user password

This query allows users to change their password with Verdaccio.

This query has three parameters in this exact order:

The new password for the user
The username
The original password

Declare update_user as an empty string to forbid anyone to update their password from Verdaccio or the npm CLI.

See an example of the configuration

Have a look inside the example folder to find an example of the configuration on a simple server:

create-database.sql contains queries to setup a really simple database with 3 tables: users, groups and user_group
configuration.yaml describes the configuration to put into config.yaml to work with the schema described in the SQL file.

Development / Building

This plugin is a regular TypeScript project.

Get the sources

$ git clone https://github.com/bchanudet/verdaccio-sqlite.git
$ npm install

Build the plugin and link it globally

For plugins, Verdaccio only looks for packages installed in its directory, or globally installed.

$ npm link

This command wil build verdaccio-sqlite, and add a symbolic link to the new version in the global repository of npm. This way it can be used with your local version of Verdaccio.