couchdb-mkuser

0.0.1 • Public • Published

couchdb-mkuser

Build Status

Utility to create couchdb users easier.

Usage

In couchdb it's a common pattern to create a user with a database to store user-private data. Due to the lack of read access control of documents. This module makes it easy to create such a setup.

Use the following code to create a user and a database for the user.

  mkuser('org.couchdb.user:userwithdb', {
    name: 'userwithdb',
    type: 'user',
    roles: [],
    password: 'super-secret'
  }, {
    database: 'userdb',
 
    // All options except `security` and `database` are passed to request.  See
    // https://github.com/request/request.
    baseUrl: 'http://localhost:5984',
  })
  .on('error', err => {
    throw err;
  })
  .on('response', r => {
    // Do something with the response.  E.g. pipe it down to the client.  In
    // this case it should be a 200 since the last action is the PUT to
    // /userdb/_security which should result in a 200.
  });

You can also leave out the database option to create a user document only.

API

mkuser(id, user, opts)

The id is the document-id of the user. As of current couchdb versions it must start with org.couchdb.user:. user is the userobject to store.

opts is an object of options described below:

  • database optional The name of the database to create for the user. Leave this undefined if you don't want a database to be created.
  • security optional The security object to associate with the database. Default is
    security: {
      admins: {
        names: [<user-name>], groups: []
      },
      members: {
        names: [], groups: []
      }
    },
    

All other options are passed to request.

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 0.0.1
    3
    • latest

Version History

  • Version
    Downloads (Last 7 Days)
    • Published
  • 0.0.1
    3

Package Sidebar

Install

npm i couchdb-mkuser

Weekly Downloads

3

Version

0.0.1

License

MIT

Last publish

Collaborators

  • domachine