MongoDB user management from the command line can be a very cumbersome and unwieldy task. Luckily, Studio 3T (formerly MongoChef) makes it super-easy to create MongoDB users and manage their roles.

In this tutorial, I will assume that you have already set up a user administrator for your database. If not, please first read our tutorial on how to bootstrap user authentication in MongoDB.

 

1. Select the target database

In MongoDB, users are defined for a particular database. Although it is possible to grant a user from a database A access to another database B, users are typically defined in the database that they will access primarily.

So, start by connecting to your MongoDB instance with your user administrator or with any other user that has sufficient privileges to create new users (usually via roles dbAdmin or dbAdminAnyDatabase).

Next, right-click the database for which you want to create a new user and select “Manage Users” from the context menu. This will open the user management tab for your database.

Here, you can see all users that have already been created for this database. You can also expand users to immediately see all the roles they have been granted.

To create a new user, simply click the “Add…” button.

Manage MongoDB Users

2. Add the new user

This will bring up the Add User dialog where you can enter the name of the new user (in our case “sarah”) and their password.

Next, we need to grant the new user a role so that they’ll actually be able to do something. For that, click the “Grant Roles…” button.

Assign MongoDB Role

3. Grant roles to the user

In this dialog, you will be presented with all roles that are currently defined for your database.

Built-in roles will be marked by a yellow icon, custom roles by a green icon. You can also click the combo-box at the top to choose from roles in other databases of your MongoDB instance, in case you want your new user to access other databases as well.

For our example, we will simply make our new user an administrator of their database and also grant them read-write access to it by selecting the roles dbAdmin and readWrite.

When done, click the “Grant” button.

Manage MongoDB Roles and Users

4. Create the new user

You return to the previous dialog where you can now see the roles that will be granted to your new user.

To create the new user, click the “Add User” button. After that, you will be taken back to the user management tab.

Manage MongoDB Roles and Users

And that’s it!  Studio 3T makes MongoDB user management a breeze. Once you’ve created your new MongoDB users, why not read more about how to find users that have been granted specific MongoDB roles or check out what we’ve been up to lately (see: making the world’s best MongoDB GUI even better, duh! 🙂 )

Editor’s Note: This post was originally published in March 2015.