Skip to main content
Skip table of contents

Roles​​

Overview

This section provides support for viewing, creating, modifying, and deleting roles based on access permissions for Kubernetes clusters managed by your organization. A role represents a set of permissions and acts as a link between users, groups, and policies. Roles are implemented and applied after defining policies, serving as the connection that enforces those policies within Kubernetes.

image-20240721-070743.png

Administrator > Kubernetes > K8s Access Control > Roles

Viewing Roles

image-20240721-070912.png

Administrator > Kubernetes > K8s Access Control > Roles > List Details

  1. Navigate to the Administrator > Kubernetes > K8s Access Control > Roles menu.

  2. You can search for roles by name using the search bar at the top left of the table.

  3. Refresh the list of roles by clicking the refresh button at the top right of the table.

  4. The table provides the following column information:

    1. Name : Role name

    2. Description : Detailed description of the role

    3. Last Access At : The last time this role was accessed

    4. Created At : The date and time the role was created

    5. Updated At : The date and time the role was last updated

    6. Updated By : The name of the administrator who last updated the role

  5. Clicking on any row will display detailed information about that role.

    1. Policies

      image-20240721-070945.png
      1. It is a default tab that shows the list of assigned policies.

      2. The table includes the following information for each policy:

        1. Name : Policy name

        2. Description : Detailed description of the policy

        3. Version : Policy version

        4. Assigned At : The date and time the policy was assigned

        5. Assigned By : The name of the administrator who assigned the policy

      3. Clicking on any policy row will display detailed information about that policy in a drawer format.

        image-20240721-071031.png
        1. At the top, basic information is displayed as follows:

          1. Name : Policy name (with a link to open the policy details in a new window)

          2. Description : Detailed description of the policy

          3. Version : Policy version

          4. Assigned At : The date and time the policy was assigned

          5. Assigned By : The name of the administrator who assigned the policy

        2. At the bottom, the policy code is displayed.

    2. Users/Groups

      image-20240721-071134.png
      1. Lists the users or groups that have been assigned this role.

      2. You can search by user/group name.

      3. The list includes the following information for each user/group:

        1. User Type : User or group type

        2. Name : User or group name

        3. Last Access At : The last time the user or group accessed the system

        4. Expiration Date : Expiration date of the role assignment

        5. Granted At : The date and time the role was granted to the user/group

    3. Clusters

      image-20240721-071233.png
      1. Lists the Kubernetes clusters that can be accessed with this role.

      2. You can search by cluster name.

      3. The list includes the following information for each cluster:

        1. Name : Cluster name

        2. Version : Kubernetes version

        3. API URL : Cluster API URL

        4. Cloud Provider : Connected platform (hyphenated for manual clusters)

        5. Tags : List of tags associated with the cluster

        6. Created At : The date and time the cluster was created

        7. Updated At : The date and time the cluster was last updated

Creating a Role

image-20240721-071306.png
  1. Navigate to the Administrator > Kubernetes > K8s Access Control > Roles menu.

  2. Click the + Create Role button at the top right.

  3. Enter the following information for the new role (all of this information will be visible to users):

    1. Name : A unique and identifiable role name (required)

    2. Description : Additional description for the role

  4. Click the Save button to create the role.

  5. Click the newly created role at the top of the role list.

  6. Refer to the Configure Kubernetes Roles Guide to set up policies for the role.

Editing a Role

image-20240721-071337.png
  1. Navigate to the Administrator > Kubernetes > K8s Access Control > Roles menu.

  2. Click on the role you want to edit from the list to open its detail page.

  3. Click the Edit button at the top right of the screen to modify the following information:

    1. Name : A unique and identifiable role name (required)

    2. Description : Additional description for the role

  4. Click the Save button to apply the changes.

Deleting a Role

image-20240721-071429.png
  1. Navigate to the Administrator > Kubernetes > K8s Access Control > Roles menu.

  2. You can proceed with deletion in two ways:

    1. Delete from the List:

      1. Check the checkbox on the left of the role you want to delete in the table.

      2. Click the Delete button that appears on the table column line.

    2. Delete from the Detail Page:

      • Click the Delete button in the top right corner of the screen.

  3. When the popup appears, click the Delete button to confirm and proceed with deletion.

Deleting a role will revoke the permissions associated with that role from all users and groups.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.