Skip to main content

Role-based access control (RBAC)

Overview​

ECI uses RBAC (Role-Based Access Control) to govern what organization users can access. Instead of granting permissions directly to a user, you bundle them into roles and assign roles. That way, users doing the same job get a consistent set of permissions quickly.

┌────────┐ assign ┌────────┐ contains ┌────────────┐
│ User │ ────────▶ │ Role │ ─────────▶ │ Permissions │
└────────┘ └────────┘ └────────────┘

The four built-in roles​

ECI ships four preconfigured roles for common scenarios. Built-in roles cannot be edited or deleted.

RoleKorean nameBest fit
Owner소유자Whoever manages the whole organization. Keep this list small
Contributor기여자Researchers and developers who create and operate VM, storage, and network resources
Support서포터Ops support staff. Currently has the same permissions as Contributor
Reader뷰어Interns, auditors, external partners — anyone who only needs read access

Permission summary by role​

AreaOwnerContributorSupportReader
Read resources (VMs, Kubernetes, network, storage, metrics)✓✓✓✓
Create / update / delete resources✓✓✓✗
VM web console access, Kubernetes API access✓✓✓✗
Read alert rules and actions✓✓✓✓
Create / update / delete alert rules and actions✓✓✓✗
Read prices and usage✓✓✓✓
Issue / revoke access tokens✓✓✓✓
List roles✓✓✓✓
List users, change roles, delete users, invite users✓✗✗✗
Create / edit / delete custom roles✓✗✗✗
Read the audit log✓✗✗✗
See the portal for the exact permission list

For the exact permission list of each role, click the role under Members > User Roles and check the Permissions tab. An access token inherits the permissions of the user who issued it, so a token issued by a Reader can only read.


Permission code structure​

Permission codes are 4–5 segments long and start with ACL.:

ACL.{section}.{subsection}.{action} # non-Resource sections
ACL.Resource.{Compute|Network|Storage}.{resource}.{action} # Resource section

Examples

  • ACL.Resource.Compute.VirtualMachine.CREATE: create a VM
  • ACL.Resource.Storage.BlockStorage.UPDATE: edit block storage
  • ACL.Resource.Compute.VirtualMachineAllocation.ACCESS_WEB_CONSOLE: VM web console access
  • ACL.Billing.Billing.READ: read usage
  • ACL.User.UserInvite.CREATE: send user invitations
  • ACL.Alert.AlertRule.CREATE: create alert rules

The Resource section adds an intermediate Compute / Network / Storage grouping, making it 5 segments. A few items (like Resource.OrganizationResourceSummary) skip the intermediate grouping.

Actions​

ActionMeaning
CREATECreate a resource
READRead a resource
UPDATEUpdate a resource
DELETEDelete a resource
ACCESS_WEB_CONSOLEVM web console access (VM only)
ACCESS_APIKubernetes API access (Kubernetes clusters only)

Sections and subsections​

SectionSubsections / resources
GeneralNotice, Organization, Region
InfraBlockStorageImage, InstanceType, Zone
BillingBilling
PricingPricing
MetricMetric
AlertAlertRule, AlertActionTemplate, AlertEvent
UserACL, User, UserAudit, UserAccessToken, UserInvite, UserRole
Resource.ComputeVirtualMachine, VirtualMachineAllocation, VirtualCluster, VirtualClusterAllocation, KubernetesCluster, KubernetesNodePool
Resource.NetworkVirtualNetwork, Subnet, NetworkInterface, PublicIp, Vpn, LoadBalancer
Resource.StorageBlockStorage, BlockStorageSnapshot, BlockStorageSnapshotScheduler, ObjectStorage, ObjectStorageUser, ObjectStorageUserGrant, ParallelFileSystem, ParallelFileSystemMember
Resource (direct)OrganizationResourceSummary
READ is a prerequisite for other permissions

Granting CREATE/UPDATE/DELETE without READ means the user can't see the resource list, so they can't actually use the permission. When you grant create/update/delete on a resource, grant READ on the same resource too.


Creating a custom role​

You can define roles tailored to your organization's workflow.

Step 1: Create the role​

  1. Go to Members > User Roles.
  2. Click Create Role.
  3. Enter the Role Name and Description.
  4. Select the permissions you need under Permissions. You can switch the view mode (Chips / Matrix / Table) or search for permissions.
  5. Click Create.

The detail page of the role you created has Overview, Permissions, and Settings tabs. Edit the name, description, and permissions, or delete the role, on the Settings tab.

Role creation page

Step 2: Assign the role to a user​

  1. Click the user in Members > Users.
  2. On the Settings tab of the user detail page, add the role you created.
  3. Click Save.
A user can hold multiple roles

With multiple roles, the union of all roles' permissions is applied. Composing small-grained roles tends to be easier to manage.


Custom role examples​

RolePermissions (summary)Best fit
VM adminACL.Resource.Compute.VirtualMachine.*, ACL.Resource.Compute.VirtualMachineAllocation.* (including ACCESS_WEB_CONSOLE), ACL.Resource.Compute.VirtualCluster.*Dedicated VM operator
Kubernetes operatorACL.Resource.Compute.KubernetesCluster.* (including ACCESS_API), ACL.Resource.Compute.KubernetesNodePool.*Cluster operations
Network readerACL.Resource.Network.{VirtualNetwork,Subnet,NetworkInterface,PublicIp,Vpn}.READSecurity / audit
Billing operatorACL.Billing.Billing.READ + ACL.Pricing.Pricing.READ + ACL.Resource.OrganizationResourceSummary.READFinance
Storage adminACL.Resource.Storage.{BlockStorage,BlockStorageSnapshot,BlockStorageSnapshotScheduler,ObjectStorage,ObjectStorageUser,ParallelFileSystem}.*Data operations
Alerts operatorACL.Alert.{AlertRule,AlertActionTemplate,AlertEvent}.* + ACL.Metric.Metric.READSRE / on-call

Full permission code list​

The complete list of permission codes used in the API, CLI, and audit log. It maps 1:1 to the portal's permission-tree UI.

General / Infra / Billing / Pricing / Metric / Alert / User

General

CodeDescription
ACL.General.Notice.READRead notices
ACL.General.Organization.READRead organization
ACL.General.Region.READList regions

Infra

CodeDescription
ACL.Infra.BlockStorageImage.READList OS images
ACL.Infra.InstanceType.READList instance types
ACL.Infra.Zone.READList zones

Billing / Pricing / Metric

CodeDescription
ACL.Billing.Billing.READRead usage and invoices
ACL.Pricing.Pricing.READRead pricing
ACL.Metric.Metric.READRead metrics

Alert

CodeDescription
ACL.Alert.AlertRule.{CREATE,READ,UPDATE,DELETE}Alert rules
ACL.Alert.AlertActionTemplate.{CREATE,READ,UPDATE,DELETE}Alert action templates
ACL.Alert.AlertEvent.READRead alert event history

User

CodeDescription
ACL.User.ACL.READList permissions
ACL.User.User.{READ,UPDATE,DELETE}Manage users
ACL.User.UserAudit.READRead the audit log
ACL.User.UserAccessToken.{CREATE,READ,DELETE}Access tokens
ACL.User.UserInvite.{CREATE,READ,DELETE}User invitations
ACL.User.UserRole.{CREATE,READ,UPDATE,DELETE}Custom roles
Resource — Compute / Network / Storage

Resource.Compute

CodeDescription
ACL.Resource.Compute.VirtualMachine.{CREATE,READ,UPDATE,DELETE}VM
ACL.Resource.Compute.VirtualMachineAllocation.{CREATE,READ,UPDATE,DELETE}VM start/stop
ACL.Resource.Compute.VirtualMachineAllocation.ACCESS_WEB_CONSOLEVM web console access
ACL.Resource.Compute.VirtualCluster.{CREATE,READ,UPDATE,DELETE}Virtual cluster
ACL.Resource.Compute.VirtualClusterAllocation.{CREATE,READ,UPDATE,DELETE}Virtual cluster run
ACL.Resource.Compute.KubernetesCluster.{CREATE,READ,UPDATE,DELETE}Kubernetes cluster
ACL.Resource.Compute.KubernetesCluster.ACCESS_APIKubernetes API access (kubeconfig issuance)
ACL.Resource.Compute.KubernetesNodePool.{CREATE,READ,UPDATE,DELETE}Kubernetes node pool

Resource.Network

CodeDescription
ACL.Resource.Network.VirtualNetwork.{CREATE,READ,UPDATE,DELETE}Virtual network
ACL.Resource.Network.Subnet.{CREATE,READ,UPDATE,DELETE}Subnet
ACL.Resource.Network.NetworkInterface.{CREATE,READ,UPDATE,DELETE}Network interface
ACL.Resource.Network.PublicIp.{CREATE,READ,UPDATE,DELETE}Public IP
ACL.Resource.Network.Vpn.{CREATE,READ,UPDATE,DELETE}VPN
ACL.Resource.Network.LoadBalancer.{CREATE,READ,UPDATE,DELETE}Load balancer

Resource.Storage

CodeDescription
ACL.Resource.Storage.BlockStorage.{CREATE,READ,UPDATE,DELETE}Block storage
ACL.Resource.Storage.BlockStorageSnapshot.{CREATE,READ,UPDATE,DELETE}Snapshot
ACL.Resource.Storage.BlockStorageSnapshotScheduler.{CREATE,READ,UPDATE,DELETE}Snapshot scheduler
ACL.Resource.Storage.ObjectStorage.{CREATE,READ,UPDATE,DELETE}Object storage
ACL.Resource.Storage.ObjectStorageUser.{CREATE,READ,UPDATE,DELETE}Object storage user
ACL.Resource.Storage.ObjectStorageUserGrant.{CREATE,READ,UPDATE,DELETE}Object storage user grants
ACL.Resource.Storage.ParallelFileSystem.{CREATE,READ,UPDATE,DELETE}Parallel file system
ACL.Resource.Storage.ParallelFileSystemMember.{CREATE,READ,DELETE}Parallel file system member (VM attachment)

Resource (direct)

CodeDescription
ACL.Resource.OrganizationResourceSummary.READRead organization-wide summary

FAQ​

Can I edit a built-in role (Owner/Contributor/Support/Reader)?

No, built-in roles cannot be edited or deleted. Create a new custom role if you need similar but different permissions.

The role I want to delete won't delete.

If the role is assigned to one or more users, it cannot be deleted. Remove or replace the role on those users first, then delete it.

How are menus the user can't access shown?

Menus the user has no read permission for are hidden. Buttons are disabled and show the required permission on hover, and where the user lacks permission to view part of a screen, the required permission code is shown in its place.


Next steps​