User Management

pb allows managing users, their roles and permissions on a Parseable server.

Roles

Roles are the pre-requisite to assign permissions to users. A role can be created with a name, permissions and optionally resources where these permissions are applicable. Once a role is created, it can be assigned to users. For details on how RBAC works on Parseable, read the Users & Access Control Section.

Role command supports the following sub-commands:

add

Create a new role with the given name, permissions and resources.

pb role add <role-name>

This opens up an interactive interface to enter the permissions and relevant resources to that role.

list

List all the roles on the server.

pb role list

remove

Remove a role from the server.

pb role remove <role-name>

Users

Users are human or machine entities that can be assigned a role. pb allows creating, listing, setting roles and removing users from the server.

User command supports the following sub-commands:

add

Create a new user with the given name. The add user command returns the password for the user. Please note that this password is not stored anywhere on the server and is only returned once. If you lose the password, you will have to reset it.

You can assign roles to the user with --role flag. If no role is specified, the user is created with no roles.

pb user add bob // creates a user with no roles
pb user add alice --role admin // creates a user with admin role. admin role must exist on the server (see role command)

Note that you can pass multiple roles to the --role flag in a comma separated list, to assign multiple roles to a user.

list

List all the users on the server.

pb user list

set-role

Set a role for a user. This command can be used to add or remove roles from a user.

pb user set-role bob admin // adds admin role to bob

Note that you can pass multiple roles in a comma separated list, to assign multiple roles to a user.

remove

Remove a user from the server.

pb user remove bob