Administration: roles and access
This page describes the devo admin role and devo admin access commands, which show security roles and permission sets and manage the organization-wide permissions of users and groups. Most of them are for Devolutions Cloud; devo admin access permission-sets is for Devolutions Server. The Workspace line under each command says where it works. A command run on a workspace type it doesn't support stops with operationNotSupportedBySource and names the type you need.
For the list of all commands, see Commands. For step-by-step tasks, see Manage users, groups, and access. To give access to one vault or one entry, use devo vault access and devo entry access instead. The options every command accepts, such as --context or --output json, are described in Global options and aren't repeated here.
devo admin role list
Lists the vault roles or the entry roles of the Devolutions Cloud organization. Alias: devo admin role ls.
Workspace: Devolutions Cloud.
devo admin role list [--scope vault|entry]--scope <scope>
vault
Which roles to list: vault (roles you assign on a vault) or entry (roles you assign on an entry). Any other value is refused. Case doesn't matter.
devo admin role get
Shows one vault role or entry role, by ID.
Workspace: Devolutions Cloud.
devo admin role get <role-id> [--scope vault|entry]<role-id>
Required. ID of the role, as a GUID.
--scope <scope>
vault
Where to look for the role: vault or entry. Use the scope the role belongs to. Any other value is refused.
devo admin access permission-sets
Lists the permission sets of the workspace.
Workspace: Devolutions Server.
This command has no options of its own.
devo admin access system list
Lists the system permissions given to users and groups of the Devolutions Cloud organization. Alias: devo admin access system ls.
Workspace: Devolutions Cloud.
This command has no options of its own.
devo admin access system get
Shows the system permissions of one user or one group.
Workspace: Devolutions Cloud.
--user-id <id>
ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.
--group-id <id>
ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.
devo admin access system grant
Gives one or more system permissions to a user or a group.
Workspace: Devolutions Cloud.
--user-id <id>
ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.
--group-id <id>
ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.
--permission <name>
Required. System permission to give. Repeat the option, or list several names after one --permission, to give several. Names are matched without case sensitivity and duplicates are ignored. Only the names listed below are accepted; an unknown or empty name is refused.
--yes (-y, --confirmed)
Off
Confirms the change. Required.
devo admin access system revoke
Removes system permissions from a user or a group. Without --permission, removes all of the subject's system permissions. Alias: devo admin access system rm.
Workspace: Devolutions Cloud.
--user-id <id>
ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.
--group-id <id>
ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.
--permission <name>
All
System permission to remove. Repeat the option, or list several names, to remove several. Leave it out to remove every system permission of the user or group. Only the names listed below are accepted.
--yes (-y, --confirmed)
Off
Confirms the removal. Required.
System permission names
--permission accepts these names, without case sensitivity:
Organization and settings:
manageSystemSettings,systemSettingsView,manageLicense,manageProductLicenses,viewAdministrationLogs,openedEntriesView,forceCheckin,releaseLock.Vaults and templates:
addVaults,manageEntryTemplates,entryTemplatesView,entryTemplatesEdit,entryTemplatesDelete,managePasswordTemplates,passwordTemplatesView,passwordTemplatesAdd,passwordTemplatesEdit,passwordTemplatesDelete,passphraseDictionariesEdit,passphraseDictionariesDelete.Users, groups, and invitations:
manageUsersGroups,manageUsers,usersView,usersAdd,usersEdit,usersDelete,usersReinvite,groupsView,groupsAdd,groupsEdit,groupsDelete,manageInvitations,invitationsView,invitationsAdd,invitationsDelete.Licenses:
licensesAssign,licensesView,licensesAdd,licensesAdjust,licensesDelete.Devolutions Gateway:
manageGateways,gatewaysView.Privileged access:
managePAMProviders,pamProvidersView,managePAMTasks,addPAMVaults,managePAMPolicies,pamPoliciesView,managePAMScriptTemplates,pamScriptTemplatesView.Global resources:
manageGlobalImages,manageGlobalMacrosScriptsTools,manageGlobalVpns,manageGlobalContact,manageCustomWidgets.Application services:
manageApplicationServices,applicationServicesView,applicationServicesAdd,applicationServicesEdit,applicationServicesDelete,applicationServicesChangeStatus,applicationServicesViewLogs.Scheduled reports:
manageScheduledReports,scheduledReportsView,scheduledReportsAdd,scheduledReportsEdit,scheduledReportsDelete,scheduledReportsReschedule.
devo admin access system-vault list
Lists the roles users and groups hold on the system vault of the Devolutions Cloud organization. Alias: devo admin access system-vault ls.
Workspace: Devolutions Cloud.
This command has no options of its own.
devo admin access system-vault get
Shows the system vault role of one user or one group.
Workspace: Devolutions Cloud.
--user-id <id>
ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.
--group-id <id>
ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.
devo admin access system-vault grant
Gives a user or a group a role on the system vault. If the user or group already has a role there, it's replaced.
Workspace: Devolutions Cloud.
--user-id <id>
ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.
--group-id <id>
ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.
--role-id <role-id>
Required. ID of the vault role to give, as a GUID. Find it with devo admin role list --scope vault.
--yes (-y, --confirmed)
Off
Confirms the change. Required.
devo admin access system-vault revoke
Removes the system vault role of a user or a group. Alias: devo admin access system-vault rm.
Workspace: Devolutions Cloud.
--user-id <id>
ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.
--group-id <id>
ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.
--yes (-y, --confirmed)
Off
Confirms the removal. Required.
Last updated
Was this helpful?