K

Roles & Permissions

User Roles & Permissions determinw what actions users can perform and what features they can access within your MikroCloud portal. Managing roles ensures that each user has the correct level of access based on their responsibilities within the team.


Roles Overview

Each user in MikroCloud is assigned a role, and that role dictates the specific permissions they hold. Permissions define the level of control users have over the portal's different components, such as viewing, creating, updating or deleting resources.

In the Roles & Permissions section of the portal, administrators can manage the roles for the current team.

RoleOverview
System RolesThese are predefined roles that come with default permissions.
Custom RolesThese are roles that are created to fit the specific needs for your organization.

Permissions and their Impact on Portal Visibility

The specific permisions assigned to a role determine the features that are visible and accessible to users. For example, a role with the Teams View permission can only view the teams but cannot create, delete or update them.

Permisions Overview:

Teams
PermissionExplanation
Teams ViewAllows the user to view team-related information.
Teams DeleteGrants permission to delete teams.
Teams CreateGrants permission to create new teams.
Teams Invite UsersAllows the user to invite other users to a team.
Teams UpdateAllows the user to update existing team information.
Teams Remove UsersGrants permission to remove users from a team.
Organization
PermissionExplanation
Organization - UpdateAllows updates to general organizational settings.
Organization - Manage Payment MethodsAllows management of payment methods for the organization.
Organization - Update SubscriptionAllows the user to update organization subscriptions.
CVE
PermissionExplanation
Cve ViewAllows the user to view CVE-related information.
Cve DeleteGrants permission to delete CVEs.
Cve CreateGrants permission to create new CVEs.
Cve RunAllows users to run CVE assessments or reports.
Cve UpdateAllows users to update existing CVE records.
Content
PermissionExplanation
Content ViewAllows the user to view content.
Content CreateGrants permission to create new content.
Content UpdateAllows the user to update existing content.
Content DeleteGrants permission to delete content.
Security
PermissionExplanation
Security ViewAllows users to view security settings and data.
Security CreateGrants permission to create new security configurations.
Security UpdateAllows updates to existing security configurations.
Security DeleteGrants permission to delete security configurations.
Roles
PermissionExplanation
Role ViewAllows the user to view roles and their permissions.
Role CreateGrants permission to create new roles.
Role DeleteGrants permission to delete roles.
Role UpdateAllows the user to update roles and their permissions.
Users
PermissionExplanation
User ViewAllows the user to view information about other users.
User CreateGrants permission to create new users.
User UpdateAllows the user to update existing users’ information.
User DeleteGrants permission to delete users.
API
PermissionExplanation
API ViewAllows the user to view API credentials and configurations.
API CreateGrants permission to create new API credentials.
API DeleteGrants permission to delete API credentials.
Jobs
PermissionExplanation
Job ViewAllows the user to view jobs.
Job CreateGrants permission to create new jobs.
Job UpdateAllows updates to existing jobs.
Job DeleteGrants permission to delete jobs.
Sites
PermissionExplanation
Site ViewAllows the user to view site-related information.
Site CreateGrants permission to create new sites.
Site UpdateAllows updates to existing sites.
Site DeleteGrants permission to delete sites.
Site ActionGrants permission to perform actions on a site, such as restarting services.
WAN
PermissionExplanation
Wan ViewAllows the user to view WAN configurations.
Wan CreateGrants permission to create WAN configurations.
Wan UpdateAllows updates to WAN configurations.
Wan DeleteGrants permission to delete WAN configurations.
Transient Access
PermissionExplanation
TransientAccess ViewAllows the user to view transient access information.
TransientAccess CreateGrants permission to create new transient access configurations.
TransientAccess UpdateAllows updates to existing transient access configurations.
TransientAccess DeleteGrants permission to delete transient access configurations.
API Credentials
PermissionExplanation
ApiCredentials ViewAllows the user to view API credentials.
ApiCredentials CreateGrants permission to create new API credentials.
ApiCredentials UpdateAllows updates to existing API credentials.
ApiCredentials DeleteGrants permission to delete API credentials.
Inventory
PermissionExplanation
Inventory ViewAllows the user to view inventory data.
Inventory CreateGrants permission to add new inventory items.
Inventory UpdateAllows updates to existing inventory items.
Inventory DeleteGrants permission to delete inventory items.
Backup
PermissionExplanation
Backup ViewAllows the user to view backup information.
Backup CreateGrants permission to create new backups.
Fault
PermissionExplanation
Fault ViewAllows the user to view fault-related information.
Schedule
PermissionExplanation
Schedule ViewAllows the user to view scheduled tasks or events.
Schedule CreateGrants permission to create new schedules.
Schedule UpdateAllows updates to existing schedules.
Schedule DeleteGrants permission to delete schedules.
CPF (Content Protection Framework)
PermissionExplanation
CPF ViewAllows the user to view CPF settings or reports.
CPF CreateGrants permission to create CPF configurations.
CPF UpdateAllows updates to CPF configurations.
CPF DeleteGrants permission to delete CPF configurations.
Scripts
PermissionExplanation
Script ViewAllows the user to view scripts.
Script CreateGrants permission to create new scripts.
Script UpdateAllows updates to existing scripts.
Script DeleteGrants permission to delete scripts.
Script RunGrants permission to execute scripts.
Script AuthorizeAllows the user to authorize script execution.
SLA (Service Level Agreements)
PermissionExplanation
SLA ViewAllows the user to view SLA-related information.
SLA CreateGrants permission to create new SLAs.
SLA UpdateAllows updates to existing SLAs.
SLA DeleteGrants permission to delete SLAs.
SLA RunGrants permission to execute SLAs.
Notifications
PermissionExplanation
Notification ViewAllows the user to view notifications.
Notification CreateGrants permission to create new notifications.
Notification UpdateAllows updates to existing notifications.
Notification DeleteGrants permission to delete notifications.

Creating a New Role Group

Adding a new user role is easy, not only does MikroCloud provide an intuitive interface for creating users, but it also provides a plethora of ways to customize the user role, ensuring that the permissions that the user has aligns with their work.

Step 1: Navigate to the Roles & Permissions Overview Dashboard

  1. From your Dashboard, click on Settings -> Roles & Permissions in order to naviage to the user role & permissions page.

picture 0

  1. A new page will pop up, this is the Roles & Permissions Overview page, which you can use to manage all of your user permissions.

picture 1

Step 2: Create a New User Role

  1. At the top-right of your Roles & Permissions Overview page, you can click on the + Add button in order to create the new user role.

picture 2

  1. A new widget will pop up, which will allow you to enter the name for the new user role.
  • Create this user role with any name you would like, for instance, you can name it NOC Team for your NOC team to manage and access your sites.

picture 3

Step 3: Assign Permissions

  1. On the Create New Role page, you can assign specific permissions for your new user role.
  1. Assign the permissions for the user group by ticking the boxes next to the specefied permission.
    • See the permission outline as discussed above to get an understanding of what each permission's function is.

picture 4

  1. When you have reviewed the permissions, you can continue to click on the Add -> button at the bottom of the page, in order to create the new role.

picture 6


Editing a Role Group

Editing an existing role group in MikroCloud is similar to creating a new role, with the added advantage of being able to fine-tune existing permissions without starting from scratch. This allows you to adapte to changing organizational needs quickly and easily.

Step 1: Navigate to the Roles & Permissions Overview Dashboard

  1. From your Dashboard, click on Settings -> Roles & Permissions to open the Roles & Permissions Overview page.

picture 0

  1. On the Roles & Permissions Overview page, you will see a list of all existing user roles. Locate the role you wish to edit.

Step 2: Edit the Role

  1. Click on the role you want to modify, this will open the edit page.

picture 8

  1. A new widget will pop up, allowing you to update the role's name, and assigned permissions. You can modify the role's name if needed to reflect changes in responsibilities.

picture 9

Step 3: Update Permissions

  1. Scroll down to the permissions section of the Edit Role page. You will see all available permissions for this role, each with a checkbox next to it.
  • Uncheck or check the permissions you want to remove or add any additional permissions that need to be granted.

picture 10

  • In the example above, we added the inventory, backup and CPF permissions to this role group.
  1. Once you've made the necessary updates to permissions, click the Update -> button at the bottom of the page to apply the changes.

picture 11

  1. The system will confirm the chagnes, and the users assined to this role will have their access updated based on the new permissions.

Deleting a Role Group

If you need to remove a role group from your MikroCloud portal, follow these steps. deleting a role group will remove all associated permissionf from users who are assigned to that role.

Step 1: Navigate to the Roles & Permissions Overview Page

  1. From your Dashboard, click on Settings -> Roles & Permissions to access the roles & permissions overview page.

picture 0

  1. On the Roles & Permissions Overview page, you will see a list of all existing role groups.

picture 12

Step 2: Locate the Role Group

  1. Browse through the list of role groups to find the role group you wish to delete.
  2. Once you've located the role group, click on the 3 dots next to the role group.

picture 13

Step 3: Remove the Role Group

  1. A list of actions will be shown.

picture 14

  1. Click on the Remove button (represented with a Trashcan icon).

picture 15

  1. A confirmation page will pop up. If you are sure that you want to delete this role group, you can click on the Delete button to continue.
    • If you are unsure, you can click on the Cancel button to go back to the overview page.

picture 16

That's it, you have successfully removed the Role group from your MikroCloud Portal.


Was this page helpful?