Nomnom Pumpernickle Muffins
    Have ideas to improve npm?Join in the discussion! »

    couch-admin

    1.2.0 • Public • Published

    Node.js Couch User Admin API Build Status NPM version

    NPM

    A library to manage users for CouchDB.

    Getting started

    You will need:

    • CouchDB URL (running locally or on a server)
    • CouchDB admin username/password (optional: but without it security is moot)
    • Node & NPM

    Simply go to terminal and type:

    npm install couch-admin

    Feel free to look at examples below to see how easy it is to use this library!

    Examples

    var admin = require('couch-admin')({
        url: 'http://localhost:5984',
        user: 'admin',
        pass: 'mysecretpassword'
        user_db: '_users', // Optional
    });
     
    admin.createUser('leander', 'unhackable password', function (err) {
        // Added a user!
    })
     
    admin.changePassword('leander', 'new unhackable password', function (err) {
        // Changed the password for leander.
    })
     
    admin.createDatabase('my_documents', function (err) {
        // New database called 'my_documents' created!
    })
     
    admin.grantMembership('leander', 'my_documents', function (err) {
        // User 'leander' was given membership access to my_documents.
    })
     
    admin.revokeMembership('leander', 'my_documents', function (err) {
        // User 'leander' is no longer a member of my_documents :(
    })
     
    admin.grantAdmin('leander', 'my_documents', function (err) {
        // User 'leander' was given admin access to my_documents.
    })
     
    admin.revokeAdmin('leander', 'my_documents', function (err) {
        // User 'leander' is no longer an admin of my_documents :(
    })
     
    admin.removeUser('leander', function (err) {
        // User 'leander' was deleted :(
    })
     
    admin.removeDatabase('my_documents', function (err) {
        // Database 'my_documents' was deleted :(
    })
     

    API

    Unless otherwise specified, cb is a callback that contains errors in its first parameter, and response as its second. The response comes from CouchDB, and varies depending on the call. Feel free to learn more about these calls at the resources linked below.

    Init Options

    url

    The URL to the CouchDB instance. (default: http://localhost:5984)

    user

    The username for the admin of the CouchDB instance. (default: admin)

    pass

    The password for the admin of the CouchDB instance. (default: mysecretpassword)

    user_id_prefix

    The user id prefix for users. (default: org.couchdb.user)

    user_db

    The database name for the authentication db of the CouchDB instance. (default: _users)

    config_db

    The database name for the config db of the CouchDB instance. (default: _config)

    session_db

    The database name for the session db of the CouchDB instance. (default: _session)

    User controls

    getUser(username, cb)

    Gets the user with the given username.

    verifyUser(username, password, cb)

    Verifies that the username/password combination is valid.

    createUser(username, password, cb)

    Adds a user with the given username and password.

    changePassword(username, password, cb)

    Edits the username to have a new password.

    removeUser(username, cb)

    Removes the user with the given username.

    Database controls

    createDatabase(database, cb)

    Adds a database (initially with no permissions.)

    removeDatabase(database, cb)

    Removes the database.

    grantMembership(username, database, cb)

    Adds username as a member of the database. Members will have read/write access to the data in the database, but cannot change the design docs.

    grantAdmin(username, database, cb)

    Adds username as an admin of the database. Admins will have read/write access to the data in the database, and also be able to add, edit and remove design docs.

    revokeMembership(username, cb)

    Removes username as a member of the database.

    revokeAdmin(username, cb)

    Removes username as an admin of the database.

    Contributing & Bugs

    Feel free to file an issue if you notice there are problems, and submit pull requests to contribute to this simple little library!

    Install

    npm i couch-admin

    DownloadsWeekly Downloads

    9

    Version

    1.2.0

    License

    MIT

    Last publish

    Collaborators

    • avatar