Skip to main content
Skip table of contents

Roles‎‎‎

Overview

In QueryPie, you can view, create, edit, and delete roles that control access to web applications managed by your organization. A Role represents a set of permissions that implements and enforces access control after policies have been defined. Roles act as a link between users/groups and the policies applied to web apps.

image-20250629-161837.png

Administrator > Web Apps > Web App Access Control > Roles

Viewing Roles

image-20250629-161857.png

Administrator > Web Apps > Web App Access Control > Roles > List Details

  1. Go to Administrator > Web Apps > Access Control > Roles.

  2. Use the search bar at the top left of the table to search for roles by name.

  3. Click the refresh button at the top right to update the role list.

  4. The table provides the following information for each role:

    • Name: Role name

    • Description: Detailed description of the role

    • Last Access At: Last time this role was used

    • Created At: Date and time the role was first created

    • Updated At: Date and time the role was last modified

    • Updated By: Name of the administrator who last updated the role

  5. Click any row to view detailed information about a role.

    1. Policies

      image-20250629-163153.png
      1. This is the default tab, showing the list of policies assigned to the role.

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

        • Name: Policy name

        • Description: Detailed policy description

        • Version: Policy version

        • Assigned At: Date and time the policy was assigned

        • Assigned By: Administrator who assigned the policy

      3. You can view policy details in a drawer on the left side of each row.

        image-20250629-163327.png
        • The top of the drawer displays:

          • Name : Policy name

            • With a link to open the policy page in a new tab

          • Description: Detailed description

          • Version: Version of the policy

          • Assigned At: Date and time assigned

          • Assigned By: Administrator who assigned it

        • The bottom section displays the policy’s code.

    2. Users/Groups

      image-20250629-163722.png
      1. This tab lists all users or groups assigned to the selected role.

      2. You can search by user or group name.

      3. The table shows the following details:

        • User Type: User or Group

        • Name: Name of the user or group

        • Last Access At: Last time the user or group used the role

        • Expiration Date: Expiration date for the role assignment

        • Granted At: Date and time the role was granted

    3. Web Apps

      image-20250629-163658.png
      1. This tab lists all web applications accessible through the selected role.

      2. You can search by web application name.

      3. The table shows the following details for each web app:

        • Name: Web application name

        • Base URL: Web app’s base URL

        • Description: Description of the web app

        • User Activity Recording: Whether user activity recording is enabled (On/Off)

        • Tags: Tags assigned to the web app

        • Created At: Date the web app was first created

        • Updated At: Date the web app was last updated

Creating a Role

  1. Go to Administrator > Web Apps > Access Control > Roles.

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

  3. Enter the following information:

    1. Name: A clear, identifiable role name (required)

    2. Description: Additional details about the role

  4. Click Save to create the role.

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

  6. Refer to the WAC Role & Policy Guide to configure policies for the role.

Editing a Role

image-20250629-163924.png
  1. Go to Administrator > Web Apps > Access Control > Roles.

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

  3. Click the Edit button in the top right and update the following information as needed:

    • Name: Role name (required)

    • Description: Role description

  4. Click Save to apply your changes.

Deleting a Role

image-20250629-163949.png
  1. Go to Administrator > Web Apps > Access Control > Roles.

  2. You can delete a role in two ways:

    1. From the list:

      • Check the box next to the role you want to delete.

      • Click the Delete button that appears in the table header.

    2. From the details page:

      • Click the Delete button in the top right corner.

  3. In the confirmation pop-up, click Delete to proceed.

When you delete a role, any permissions granted through that role will also be revoked from all assigned users and groups.

JavaScript errors detected

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

If this problem persists, please contact our support.