Users and Roles Management on MTN Cloud
Overview
An individual user account represents a person who requires access to MTN Cloud resources within a specific, isolated Tenant. To manage this access, the system utilises Roles, which are a defined set of rights and privileges that determine what operations a user can perform.
Why it matters
- Building Blocks of Permissions: Roles act as the primary mechanism for managing access to features and services on the MTN Cloud.
- Permission Inheritance: When multiple roles are applied to a single user, the user automatically inherits the most permissive rights across them, ensuring the highest level of access granted by any assigned role.
- Ready-to-Use Baselines: Each newly created tenancy includes six predefined roles by default (e.g., Customer Admin User, Customer Audit Admin User, Customer Billing User, etc.) to immediately facilitate resource management.
Prerequisites
Before you begin, ensure you have:
- An MTN Cloud Console login with the appropriate role (full permissions) to the Administration (Users and Roles), i.e., have the Customer Admin User role assigned or a role with equivalent privileges.
- Identified who in your organisation needs MTN Cloud access so they can be created and assigned roles.
Tip: If you cannot see the Users and Roles features despite having the correct role, try refreshing the portal. If the issue persists, contact MTN Cloud Support.
Predefined Roles
A role is a defined set of rights and privileges — essentially a “personality” — that determines what operations a user can perform. Roles are the building blocks of permissions and the primary mechanism for managing access to features and services on the MTN Cloud. Each newly created tenancy includes six (6) predefined roles by default:
- Customer Admin User: Tenant Admin User Role for Customer. The Tenant Admin may branch off from this role to scale down permissions for other users.
- Customer Audit Admin User: Read-Only Access (view-only permissions for all resources).
- Customer Billing User: Can create and configure budgets, and generate invoices, cost reports, and related billing artifacts.
- Customer Cloud User: Can deploy, modify, and delete their own resources across MTN Cloud, but cannot create or modify IAM roles, users, or groups.
- Customer Power User: Can deploy, modify, and delete all resources across MTN Cloud, but cannot create or modify IAM roles, users, or groups.
- Customer Network Admin: Users can create, modify, and delete networks, routers, and subnets; manage security groups, firewall rules, load balancers, and VPNs, but have no access to compute, billing, or any other MTN Cloud resource.
IMPORTANT NOTE: It is strongly recommended not to delete the predefined MTN Cloud roles listed above. Once deleted, these roles cannot be recovered.
The Right Sequence
To efficiently manage role configurations, follow this established sequence:
- Accessing Roles: Go to Administration → Roles to begin managing role configurations.
- Create a New Role: Select + CREATE ROLE.
- Leverage Existing Configurations: Utilise the Copy From Role option to duplicate a proven setup for increased efficiency.
- [Optional] Configure Role Details: Adjust specific tabs, excluding features and permissions.
Phase 1 — Step 1: Navigate to Roles
- As a Customer Admin User — or any user with equivalent administrative privileges — navigate to the Administration tab.
- Select Roles.

Phase 1 — Step 2: Create Roles
- Click on + CREATE ROLE.

Set the key fields that establish the role's identity and permissions:
- NAME: Provide a unique and identifiable name for the role.
- DESCRIPTION: Optional summary of the role's purpose or access level.
- LANDING URL: Default is the Dashboard; you can specify a custom page.
- COPY FROM ROLE: Optional feature to duplicate an existing role as a template (if none is selected, all permissions default to NONE).
Select the Save Changes button to create the role.

Phase 1 — Step 3: Configure Role Details
- Select the newly created role from the list by clicking the entry highlighted in blue.

- Click the EDIT button to modify the role's name, description, and landing URL.

- On the same page, click a listed feature to display a dropdown of permissions.

Configure the permissions as Full, Read, User, or None. For certain features, only limited options are available.
Phase 1 — Step 4: Delete Roles
Roles can be deleted in two ways:
REMOVE Button: Select the role, then click the REMOVE button to delete it.

Trash Icon: From the roles list, click the trash icon next to the role you want to delete.

IMPORTANT NOTE: It is strongly recommended not to delete the predefined MTN Cloud roles. Once deleted, these roles cannot be recovered.
Phase 2 — Step 1: Navigate to Users
- Navigate to the Administration tab.
- Select Users.

Phase 2 — Step 2: Create Users
- Click on + CREATE USER.

- Define Identity: Input the FIRST NAME, LAST NAME, USERNAME, and EMAIL.

- Assign Role(s): Search and select one or more roles for the user.
- Assign Credentials: Enter a password and re-enter it to confirm the new user account.
User Creation Checkboxes:
- Enabled: Controls whether the account is active. If unchecked, the user is inactive (greyed out) and cannot log in.
- Account Locked: Indicates the account is blocked due to security failures. Admins must manually unlock it before the user can log in again.
- Password Expired: Forces the user to set a new password at their next login.

Configure Linux/Windows Settings (Optional): These settings define how user accounts are automatically created on new instances during provisioning.
- Linux: Requires a Username, Password, and/or SSH key pair. If password authentication is disabled, an SSH key must be specified.
- Windows: Manages the Administrator Password for Windows instances.

Select the Save Changes button to create the user.
Phase 2 — Step 3: Configure Users' Details
You can modify user permissions as job roles change or permanently remove access when it is no longer required.
- Locate the user in the list and select the pencil icon (Edit).

- Update Identity Details (names, emails, usernames) or Role Assignments (add/remove roles).
- Adjust Security Controls to manually lock/unlock accounts, enable/disable them, or trigger a mandatory password reset via the "Password Expired" checkbox.

- To conduct a Permission Review, click the user's Display Name to view a detailed breakdown of their "Effective Role Permissions".

IMPORTANT NOTE: It is strongly recommended not to edit the user assigned the Customer Admin User role. If this role is removed, the user will lose the ability to perform actions related to Users and Roles management on MTN Cloud.
Phase 2 — Step 4: Users Deactivation vs. Deletion
- Deactivation (Recommended): Uncheck the Enabled box when editing a user. This makes the account inactive, but all historical data and resource ownership remain intact.
- Removal (Permanent): Deleting a user completely removes their account and cannot be reversed. To delete, select the user and click the REMOVE button, or click the Trash Icon next to the user in the list.
Phase 2 — Step 5: Executing Permanent User Removal
Removing a user permanently revokes their access to MTN Cloud and should be performed with caution, as this action cannot be reversed. Users can be permanently deleted in one of two ways:
The REMOVE Button: Select the user from the interface, then click the REMOVE button to delete the account.

The Trash Icon: From the main users summary list, locate the target user and click the Trash Icon directly next to their entry.

Congratulations! Your User and Role configuration has been completed. You can now manage access across your tenancy on MTN Cloud by assigning roles, adjusting permissions, and ensuring users have the appropriate level of control for their responsibilities.