Roles y privilegios

Roles

Un rol es un conjunto con nombre de privilegios más un conjunto de atributos de ámbito. La plataforma crea los roles integrados, que no se pueden modificar ni eliminar. El administrador del clúster crea los roles personalizados, cuya numeración empieza en 10000.

id	Rol	Nivel	Finalidad
1	`Cluster Master`	Clúster	Acceso completo a todo el clúster
2	`vDC Admin`	VDC	Administración del centro de datos virtual (VDC)
3	`vDC User`	VDC	Trabajo con los recursos de un VDC
4	`vDC Viewer`	VDC	Visualización de los objetos del VDC
5	`Resource Viewer`	Clúster	Visualización de los recursos del clúster
6	`Security Admin`	Clúster	Registro de seguridad y auditoría
7	`VM Developer`	VDC	Creación y configuración de máquinas virtuales
≥ 10000	Nombre personalizado, de hasta 64 caracteres	Determinado por los atributos de ámbito	Rol personalizado

Los roles Security Admin y VM Developer se introdujeron en la versión 3.0.3.

Cluster Master no está vinculado a ningún ámbito: su conjunto de ámbitos está vacío, por lo que se aplica a todo el clúster. Los roles integrados tienen vacío el campo creator; en un rol personalizado, contiene el ID del usuario que lo creó.

Privilegios

El acceso se concede mediante privilegios con ámbito, y no mediante una asociación fija con un rol concreto: el mismo privilegio puede aplicarse a todo el clúster o a un único VDC.

Los privilegios se organizan en categorías, y la interfaz los muestra en las mismas secciones de la tarjeta del rol. Una categoría solo agrupa privilegios; no amplía los permisos.

Categoría	Nombre en la interfaz	Privilegios
`1` VDC	`vDC`	10
`2` Máquinas virtuales	`VM`	43
`3` Redes	`Network`	17
`4` Routers edge	`Edge`	34
`5` Almacenamiento	`Storage`	6
`6` Nodos	`Node`	19
`7` Clúster	`Cluster`	11
`8` Usuarios y roles	`User`	31
`9` Varios	`Misc`	4
`10` Autenticación	`Auth`	2
`11` Registro de seguridad	`Security`	10
`12` Interfaz web	`User Interface`	1
`13` Almacenamiento del VDC (Unified Storage)	`Unified Storage`	27
`14` Biblioteca de imágenes de SO	`OS Image Library`	7
`15` Copia de seguridad	`Backup`	3

Hay tres privilegios de gestión de roles que no se pueden conceder a un rol personalizado: Create Role (7111), Edit Role (7112) y Delete Role (7113). De lo contrario, un rol personalizado podría ampliar sus propios permisos. Los intentos de incluirlos en el conjunto se rechazan con -22502 al crear un rol y con -22513 al editarlo.

Ámbito

Un ámbito determina a qué objetos se aplica un privilegio: a todo el clúster, a un VDC concreto o a un objeto individual.

Solo hay dos tipos de ámbito, y la diferencia entre ellos es fundamental.

Ámbito	Disponible para roles personalizados	Significado
VDC (`vdc_id`)	sí	El privilegio se aplica en los VDC en los que está asignado el rol
Creador del objeto (`creator`)	no	El privilegio se aplica a los objetos creados por el propio usuario

La restricción "solo objetos propios" de un rol personalizado se establece mediante los privilegios Own existentes, y no mediante el ámbito de visibilidad: Edit Own Network (2010) y los privilegios relacionados de las categorías "Redes" y "Routers edge". Los intentos de asignar a un rol personalizado el ámbito creator se rechazan con -22505 al crearlo y con -22517 al editarlo.

Un rol se asigna dentro de un VDC: si el rol tiene un ámbito de VDC, debe especificarse un VDC al asignarlo.

Registro de privilegios

El registro completo que figura a continuación contiene 225 privilegios distribuidos en 15 categorías. Los nombres aparecen exactamente como se muestran en la tarjeta del rol. El ID de un privilegio es inmutable, y la API lo utiliza para referirse al privilegio.

VDC (categoría `1`, `vDC`)

id	Privilegio
`1000`	`View vDC`
`1001`	`Create vDC`
`1002`	`Edit vDC`
`1003`	`Delete vDC`
`1004`	`Assign vDC Network`
`1005`	`Deassign vDC Network`
`1006`	`View vDC Networks`
`1007`	`Manage vDC Network Limit`
`1008`	`View vDC Roles`
`1009`	`View vDC Volumes`

Máquinas virtuales (categoría `2`, `VM`)

id	Privilegio
`1100`	`View VM List`
`1101`	`View VM Details`
`1102`	`Access VM Console`
`1103`	`View VM Statuses`
`1104`	`View VM Profiles`
`1105`	`View VM History`
`1107`	`View Boot Media`
`1108`	`View VM Performance`
`1109`	`View Import Area`
`1110`	`Process Import Area`
`1111`	`View VM Inventory`
`1112`	`View VM Infrastructure Details`
`1113`	`View VM Migration Status`
`1114`	`Check VM Configuration`
`1200`	`Create VM`
`1201`	`Remove VM`
`1202`	`Edit VM Settings`
`1203`	`Change VM VDC`
`1204`	`Unlock VM`
`1205`	`Register VM Image`
`1206`	`Set VM Service ID`
`1300`	`Start VM`
`1301`	`Stop VM`
`1302`	`Restart VM`
`1303`	`Suspend VM`
`1304`	`Resume VM`
`1305`	`Suspend VM Pool`
`1306`	`Resume VM Pool`
`1400`	`Add VM Disk`
`1401`	`Remove VM Disk`
`1402`	`Resize VM Disk`
`1403`	`Label VM Disk`
`1404`	`Add VM NIC`
`1405`	`Remove VM NIC`
`1500`	`Create VM Snapshot`
`1501`	`Remove VM Snapshot`
`1502`	`Rollback VM Snapshot`
`1600`	`Rate Limit VM NIC`
`1601`	`Rate Limit VM Disk`
`1602`	`Set VM CPU Priority`
`1603`	`Set VM vCPU Class`
`1604`	`Set VM Memory Balloon`
`1605`	`Migrate VM`
`1606`	`Set VM Reserved vCPU Class`
`1607`	`Live Migrate VM`

Redes (categoría `3`, `Network`)

id	Privilegio
`2000`	`View Networks`
`2001`	`Edit Network`
`2002`	`Create Network`
`2003`	`Delete Network`
`2005`	`View Own Networks`
`2010`	`Edit Own Network`
`2011`	`Delete Own Network`
`2100`	`View IP Pool Usage`
`2101`	`View IP Pool Free Addresses`
`2102`	`View IP Pool Details`
`2103`	`Add IP Pool`
`2104`	`Delete IP Pool`
`2105`	`View Own Network IP Pool Usage`
`2106`	`View Own Network IP Pool Free`
`2107`	`Add Own Network IP Pool`
`2108`	`Delete Own Network IP Pool`
`2109`	`View Own Network IP Pool Details`

Routers edge (categoría `4`, `Edge`)

id	Privilegio
`3000`	`View Edge List`
`3001`	`View Edge Details`
`3002`	`Create Edge`
`3003`	`Remove Edge`
`3004`	`Add Edge NIC`
`3005`	`Remove Edge NIC`
`3006`	`Start Edge`
`3007`	`Stop Edge`
`3008`	`Restart Edge`
`3009`	`Rate Limit Edge`
`3010`	`View Edge Logs`
`3011`	`View Edge Admin Details`
`3013`	`View Own Edge List`
`3014`	`View Own Edge Details`
`3020`	`Remove Own Edge`
`3021`	`Add Own Edge NIC`
`3022`	`Remove Own Edge NIC`
`3023`	`Start Own Edge`
`3024`	`Stop Own Edge`
`3025`	`Restart Own Edge`
`3026`	`Rate Limit Own Edge`
`3027`	`View Own Edge Logs`
`3028`	`Deploy Own Edge Rules`
`3029`	`Add Own Edge NAT Rule`
`3030`	`Add Own Edge Firewall Rule`
`3031`	`Remove Own Edge NAT Rule`
`3032`	`Remove Own Edge Firewall Rule`
`3033`	`View Own Edge Rules`
`3100`	`View Edge Rules`
`3101`	`Add NAT Rule`
`3102`	`Add Firewall Rule`
`3103`	`Remove NAT Rule`
`3104`	`Remove Firewall Rule`
`3105`	`Deploy Edge Rules`

Almacenamiento (categoría `5`, `Storage`)

id	Privilegio
`4000`	`View Storage Pools`
`4001`	`View Storage Pool Details`
`4002`	`View Pool Map`
`4003`	`View Pool Map By GUID`
`4100`	`View Filesystem`
`4101`	`Edit Filesystem`

Nodos (categoría `6`, `Node`)

id	Privilegio
`5000`	`View Nodes`
`5001`	`View Node Performance`
`5002`	`View Node CPU Cores`
`5003`	`View Node Software`
`5004`	`View Software Inventory`
`5005`	`View Node Inventory`
`5006`	`View Host Inventory`
`5007`	`View Node Hardware`
`5008`	`View PD Status Map`
`5100`	`Get Node Config`
`5101`	`Set Node Config`
`5102`	`View Node Config Map`
`5200`	`View Physical Disks`
`5201`	`Control PD LED`
`5202`	`View Port Groups`
`5203`	`Spare Physical Disk`
`5204`	`Use Physical Disk`
`5205`	`Replace Physical Disk`
`5206`	`View Disk Info`

Clúster (categoría `7`, `Cluster`)

id	Privilegio
`6000`	`View Cluster Status Map`
`6001`	`View Cluster Overview`
`6002`	`View Cluster Totals`
`6003`	`View Cluster Status Map (full)`
`6004`	`View Cluster Status Map (dashboard)`
`6100`	`Enable Cluster Node`
`6101`	`Disable Cluster Node`
`6102`	`Enable Cluster Service`
`6103`	`Disable Cluster Service`
`6104`	`Start Cluster Service`
`6105`	`Stop Cluster Service`

Usuarios y roles (categoría `8`, `User`)

id	Privilegio
`7000`	`View Users`
`7001`	`View User Details`
`7002`	`Create User`
`7003`	`Delete User`
`7004`	`Set Own User Password`
`7005`	`Unlock User`
`7100`	`View Roles`
`7101`	`View User Role`
`7102`	`View Own User Roles`
`7103`	`View Roles Map`
`7104`	`Assign User Role`
`7105`	`Deassign User Role`
`7106`	`View Any User Roles`
`7107`	`View Privileges`
`7108`	`View Role Privileges`
`7109`	`View Privilege Categories`
`7110`	`View Privilege Scopes`
`7111`	`Create Role`
`7112`	`Edit Role`
`7113`	`Delete Role`
`7114`	`View Role Details`
`7115`	`View Role Scopes`
`7200`	`Get User Params`
`7201`	`Set User Params`
`7202`	`View User Remotes`
`7203`	`Add User Remote`
`7204`	`Delete User Remote`
`7205`	`View User VHosts`
`7206`	`Add User VHost`
`7207`	`Delete User VHost`
`7208`	`Set Any User Password`

Varios (categoría `9`, `Misc`)

id	Privilegio
`8000`	`View Own User Task`
`8001`	`View All Snapshots`
`8002`	`View Any Task`
`8003`	`View Own User Snapshots`

Autenticación (categoría `10`, `Auth`)

id	Privilegio
`9000`	`View Security Settings`
`9001`	`Edit Security Settings`

Registro de seguridad (categoría `11`, `Security`)

id	Privilegio
`10000`	`View Security Log`
`10001`	`Export Security Log`
`10002`	`Verify Security Log`
`10003`	`View Security Archive`
`10004`	`Export Security Archive`
`10005`	`View Security Archive Settings`
`10006`	`Edit Security Archive Settings`
`10007`	`Acknowledge Security Event`
`10008`	`View Security Notify Settings`
`10009`	`Edit Security Notify Settings`

Interfaz web (categoría `12`, `User Interface`)

id	Privilegio
`12000`	`Web UI`

Almacenamiento del VDC (Unified Storage) (categoría `13`, `Unified Storage`)

id	Privilegio
`13000`	`Enable vDC Storage`
`13004`	`iSCSI Create Portal Group`
`13005`	`iSCSI Delete Portal Group`
`13006`	`iSCSI View Portal Group`
`13007`	`iSCSI List Portal Groups`
`13009`	`Configure vDC Storage iSCSI`
`13010`	`View vDC Storage`
`13011`	`List vDC Storages`
`13012`	`Create vDC Volume`
`13013`	`View vDC Initiator Group List`
`13014`	`View vDC Initiator Group`
`13015`	`Create vDC Initiator Group`
`13016`	`Set vDC Initiator Group`
`13017`	`Delete vDC Initiator Group`
`13018`	`Map vDC Volume`
`13019`	`Unmap vDC Volume`
`13020`	`View vDC Volume Detail`
`13021`	`View vDC Auth Group List`
`13022`	`View vDC Auth Group`
`13023`	`Create vDC Auth Group`
`13024`	`Set vDC Auth Group`
`13025`	`Set vDC Target Auth`
`13026`	`View vDC Storage iSCSI Detail`
`13027`	`Delete vDC Auth Group`
`13028`	`Delete vDC Volume`
`13029`	`List All Volumes`
`13030`	`View Storage Overview`

Biblioteca de imágenes de SO (categoría `14`, `OS Image Library`)

id	Privilegio
`4200`	`Manage Image Library`
`4201`	`View Image Library`
`4202`	`Sync Image Library`
`4203`	`View Image Catalog`
`4204`	`Import Golden Image`
`4205`	`View Image Dependencies`
`4206`	`Remove OS Image`

Copia de seguridad (categoría `15`, `Backup`)

id	Privilegio
`14000`	`Backup VM Send`
`14001`	`Backup VM Restore`
`14002`	`Backup Dataset Ops`

Véase también

Comprender el modelo de acceso: privilegios, ámbitos y asignaciones de roles a usuarios.
Crear y asignar un rol: creación paso a paso de un rol personalizado.
Campos de acceso y códigos de error: estructura de las entradas del registro y errores de los métodos.

Métodos de la API

El registro lo devuelven privilege-list, privilege-categories, privilege-scopes, role-privilege-list y role-scopes; los roles se gestionan con role-list, role-get, role-create, role-set y role-delete; consulte la referencia de la API.

Roles​

Privilegios​

Ámbito​

Registro de privilegios​

VDC (categoría 1, vDC)​

Máquinas virtuales (categoría 2, VM)​

Redes (categoría 3, Network)​

Routers edge (categoría 4, Edge)​

Almacenamiento (categoría 5, Storage)​

Nodos (categoría 6, Node)​

Clúster (categoría 7, Cluster)​

Usuarios y roles (categoría 8, User)​

Varios (categoría 9, Misc)​

Autenticación (categoría 10, Auth)​

Registro de seguridad (categoría 11, Security)​

Interfaz web (categoría 12, User Interface)​

Almacenamiento del VDC (Unified Storage) (categoría 13, Unified Storage)​

Biblioteca de imágenes de SO (categoría 14, OS Image Library)​

Copia de seguridad (categoría 15, Backup)​

Véase también​

Métodos de la API​