# Role Based Access (RBAC)

The **Role Based Access** (RBAC) button under "Security" in the **Admin Dashboard** gives administrators granular control over permissions within PlexTrac, such as actions allowed for a specific user, permissions for customers, access to client data, and report access that restricts viewing sensitive data.

PlexTrac applies roles that consider the tenant (instance) and client. This enables teams to grant users the privileges required to accomplish tasks for specific clients.

A user’s tenant role governs what portions of the platform they can access, including the modules, tools, and UI elements presented for use. A user’s permissions can be further scoped in the context of individual clients. Users must have a role in the context of each client.

PlexTrac has three default roles: **Administrator**, **Standard User**, and **Analyst**.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2Fo1jFXF2koGeyFHGsngsB%2Fimage.png?alt=media&#x26;token=b91715d6-9b63-4895-b109-4426ced067a2" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FQ4zYlDOaHG3IvWs1yXSF%2Fimage.png?alt=media&#x26;token=6806a20c-c158-4329-b3e7-793668e80e4b" alt=""><figcaption></figcaption></figure></div>

## Licensed Permissions

An icon within the RBAC list identifies permissions that require a license.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F6tODL35of6RSlY7aB0LZ%2Fimage.png?alt=media&#x26;token=138a92f3-1a98-42a4-b4e1-1a89ee15461b" alt=""><figcaption></figcaption></figure></div>

For a tenancy, a license can be in different states:

1. &#x20;**A valid key**: In this scenario, no banner message will appear.
2. **An invalid license key:** In this scenario, a banner appears (when adding users or viewing a role within the Admin Dashboard), and the admin needs to contact <licensing@plextrac.com>. &#x20;

   <div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FMSzMOklECPD52zktXUR9%2Fimage.png?alt=media&#x26;token=74ed76ae-321e-4105-92c7-4049883ae764" alt=""><figcaption></figcaption></figure></div>
3. **More licenses needed:** This scenario applies to situations where the number of licenses remaining is three or fewer, and the admin should contact <licensing@plextrac.com>.  A banner appears when adding users or viewing a role within the Admin Dashboard.<br>

   <div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FHBmtGGb3NexnreRAckkv%2Fimage.png?alt=media&#x26;token=91de0e61-cb8f-469e-b79c-719f37fc38fd" alt=""><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FawZ2EPJL1BDaBVr5iTc6%2Fimage.png?alt=media&#x26;token=b1795b28-124e-458b-93eb-c5d93be3f59e" alt=""><figcaption></figcaption></figure></div>
4. **No license key:** This scenario could apply to a new instance, and the admin needs to contact <licensing@plextrac.com>.  No banner message is provided.

## Tenant Permissions

Platform-wide permissions include access to specific modules (WriteupsDB, Assessments, etc.), the Account Admin section, platform settings, and user management. These permissions are specific to platform access and assigned in the **Role Based Access** area of the **Admin Dashboard.**&#x20;

{% hint style="info" %}
Users may be assigned to more than one role. Tenant permissions are **additive**. Adding users to a less-privileged role does not remove other roles or restrict permissions.
{% endhint %}

Within a tenancy, the following business rules apply:

* **Administrator:** A tenant administrator can access all tools, modules, and UI elements on the platform (all aspects of the **Admin Dashboard)**.
* **Standard User:** A standard user can access all modules and UI elements outside the **Admin Dashboard**.
* **Analyst:** An analyst user cannot access the **Content Library** or **Runbooks** modules. Additionally, most UI elements that provide create or edit capabilities are unavailable.&#x20;

### Administrator

Admin user permissions can be viewed by clicking the **Administrator** box on the **Security:** **Role Based Access** page.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FrLcceewHl7YDZq7V5HRQ%2Fimage.png?alt=media&#x26;token=42a8cd3b-75c4-48fc-8848-4aeb3a5052f5" alt=""><figcaption></figcaption></figure></div>

An administrator is PlexTrac's highest permission role, and admins have complete control and access over every application part.&#x20;

### **Standard User**

Click the Standard User box on the Security: Role Based Access page to view standard user permissions.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2FxDSYAtJt3cKkoq8G0Kwc%2Fimage.png?alt=media&#x26;token=a2901cc8-f9c1-4811-bb28-2f74e4a46d4a" alt=""><figcaption></figcaption></figure></div>

### **Analyst User**

Analyst user permissions can be viewed by clicking the **Analyst** box on the **Security:** **Role Based Access** page.

<div align="left"><figure><img src="https://4252973360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LXA6EayCcg12qfDcfXd%2Fuploads%2F8k4ZuJGnhnOfayDcUXOB%2Fimage.png?alt=media&#x26;token=9a6b78ba-bd1c-4020-81f4-3e2aaa406e1c" alt=""><figcaption></figcaption></figure></div>

## Client Permissions

Client-based permissions are specific to using and accessing **Clients**, **Reports**, and **Findings**. These permissions are assigned on a client level, and more information can be found by visiting the [Clients module documentation](https://docs.plextrac.com/plextrac-documentation/product-documentation/clients/manage-client-users).&#x20;

The role assigned to a user at the client level sets the client, reports, and findings permissions for that client.&#x20;

In the context of a client, the following business rules apply:

* **Administrator:** A client administrator can edit any data associated with the client, such as the client record, assets, and reports, and manage access of client users.
* **Standard User:** A standard user can edit any data associated with the client, such as the client record, assets and reports.
* **Analyst:** An analyst user can view client assets and related data, reports in published status, upload and delete artifacts in reports, and change the remediation status of findings.
