https://github.com/mrjones-plip/couchdb-role-switcher

A simple Node script which accepts a new role and adds it every user in a CouchDB instance.
https://github.com/mrjones-plip/couchdb-role-switcher

couchdb nodejs

Last synced: 5 days ago
JSON representation

A simple Node script which accepts a new role and adds it every user in a CouchDB instance.

• Host: GitHub
• URL: https://github.com/mrjones-plip/couchdb-role-switcher
• Owner: mrjones-plip
• License: mit
• Created: 2022-08-19T04:51:25.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-09-15T03:49:24.000Z (over 2 years ago)
• Last Synced: 2024-03-18T18:10:38.634Z (9 months ago)
• Topics: couchdb, nodejs
• Language: JavaScript
• Homepage:
• Size: 74.2 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CouchD Role Switcher

A simple Node script which accepts a new role and adds it to every user in a CouchDB instance. 

https://user-images.githubusercontent.com/8253488/190309528-e247de64-14c3-460e-8824-141d162835c2.mp4

## Requirements

* Node 12 LTS or later

* `npm`

## Install

Run `npm ci` before using

## Use

You to need have two environment variables set to us this script:

* `ROLE` - the string value of the permission you want to add

* `COUCH_URL` - the URL of your couch instance. should be in a https://USER:PASSWORD@URL:PORT format

* `DEBUG` - set to `True` if you want to see a stack trace for any errors.

Here's an example call adding the role `foo` on a URL of `192-168-68-26.my.local-ip.co` with user of `admin` 

and a password of `password`. Port is `8443`:

```shell

 ROLE=foo COUCH_URL=https://medic:[email protected]:8443 node . 

Start

17 total users found.

1 needed the permission added.

End

```

## Notes

* First user returned should be `_design/_auth` and [is always skipped](https://github.com/mrjones-plip/couchdb-role-switcher/blob/main/index.js#L44).

* If you're hitting CouchDB through a proxy and updating a lot users (>500), you should try and bypass the proxy to talk to DB directly. In testing, I saw errors like  `Client network socket disconnected before secure TLS connection was established`.