Managing vStor User Accounts

Note. User roles are available for vStor 4.11 and higher.

vStor implements an advanced permission model that lets you create and manage user accounts with role-based access control. This system defines permissions for both administrators and standard users, allowing controlled access to vStor resources.

vStor User Roles

vStor distinguishes between two predefined roles, each with specific access levels to resources:

  • Admin: Users with the Admin role have unrestricted access to all resources and capabilities within vStor, including user management and system configuration.

  • Standard: Standard users are granted access only to pools specifically assigned to them.

Impact of Pool Permissions on User Visibility

The pool permissions assigned to a Standard user directly influence their visibility of resources in vStor:

  • Shares: A Standard user will not see these resources if they lack permissions for the associated pool.

  • Partnerships, Replication Relationships, and Schedules:

    • Creation: Standard users can create these configurations for their assigned pools.

    • Editing and Synchronization: Only the creating Standard user can edit their configurations and manually trigger synchronization for their own Replication Relationships.

    • Administrative Actions: Administrators can view all configurations but can only delete them, not edit or manually trigger synchronization.

  • Dashboard: The dashboard for a Standard user will only summarize the pools they can access.

Creating User Accounts

To create a new user account in vStor:

  1. Log in as an administrator.

  2. In the navigation menu, select Users to display all user accounts.

  3. Click on Add New to create a new account.

  4. Assign a Name and a Password for the new user.

  5. Select the type of account for the user:

    • Admin: Grants full access to all resources within vStor.

    • Standard: Limits access to only assigned pools. If you select this option, you need to specify which pools the user can access.

  6. Click Save to save the new user account.

Note. Standard users can only view and manage resources within their assigned pools. Administrators can modify pool permissions for a Standard user at any time.

Changing Pool Permissions for Standard Users

Administrators can only modify a Standard user's pool access in vStor.

To adjust pool permissions for a Standard user:

  1. Log in as an administrator.

  2. In the navigation menu, select Users to display all user accounts.

  3. Locate the account, hover over the name, click More Actions (•••), and select Change Permissions.

  4. Add or remove the user's access to specific pools.

Attention! If a user loses permission to access a pool, any relationships and hosts they have created associated with that pool will be automatically deleted.

Disabling User Accounts

User accounts can be temporarily disabled through both the vStor Web Interface and the CLI.

Using vStor Web Interface

  1. Log in as an administrator.

  2. In the navigation menu, select Users to display all user accounts.

  3. Locate the account to be disabled, hover over the name, click More Actions (•••), and select Disable Account.

  4. Confirm by clicking the Disable button.

To re-enable a disabled account, follow the same steps and select Enable Account.

Using vStor CLI

To disable a user account via the CLI, execute:

vstor user disable --username <user>

Changing User Account Password

Changing a user account's password can be done through the Web Interface or CLI for security purposes.

Using vStor Web Interface

  1. Log in as an administrator.

  2. In the navigation menu, select Users to display all user accounts.

  3. Locate the account, hover over the name, click More Actions (•••), and select Change Password.

  4. Enter the new password and click Save.

Using vStor CLI

To change a password via the CLI, use:

vstor user change-password --username <username> --password <password> --new_password <new-password>

Last updated