Configure RBAC for application roles
Configure role-based access control (RBAC) for an application to verify which API endpoints each role can access. Every task on this page starts from the RBAC page of your application.
Open the application
-
Open your browser and go to https://<your-tenant>.apisecapps.com.
-
Click the application.

-
On the application details page, click RBAC in the left navigation.

Configure RBAC
-
Click Set Up User Access.

-
Enter the Credential Name, select the Credential Method, and enter the required values.

-
Click Save Credentials to create the authentication.

-
When prompted, enter a Role Name for the authentication you created.

-
Click Next.

-
Select the role by checking its checkbox in the Include In Access Test column.

-
Click Run Access Checks to discover permissions for the selected role.

-
Review the discovered permissions and make changes where necessary.

-
Click Save Access Mapping to include the configuration in the RBAC coverage categories for the next scan.

-
Select the role and click Save Selection.

-
Confirm that the RBAC pill in the App Model section is green, indicating that RBAC is configured.

Edit User Access
Edit User Access modifies the roles assigned to existing credentials and checks the access permissions for the updated role.
-
On the RBAC page, click Edit User Access.

-
You can add new roles, delete existing roles, or update user roles. To update an existing user role, first delete the current User Role.

-
Update the User role and click Next.

-
Select the Include in Access Test checkbox and click Run Access Checks.

-
Check the updated User Role.

-
Click Save Access Mapping.

-
Select the Role and click Save Selection.

Re-Run Access Checks
Re-Run Access Checks retests the access permissions for the selected role.
-
On the RBAC page, click Re-Run Access Checks.

-
Recheck the permissions for the selected user role.

Retest Permissions
Retest Permissions retests the access permissions for a selected endpoint.
-
On the RBAC page, switch off Consolidated View.

-
Click the options menu for the endpoint and select Retest Permissions.

RBAC Map
The RBAC (Role-Based Access Control) Map helps you verify which API endpoints are accessible for a selected role or roles.
Download RBAC Map
-
On the RBAC page, click RBAC Map, then Download RBAC Map. You can edit this CSV file and upload it to verify role-based access permissions.

Upload RBAC Map
-
On the RBAC page, click RBAC Map, then Upload RBAC Map.

-
Click Browse files and select the RBAC Map file.

-
Click Upload File.

-
Verify and confirm the access permissions for each endpoint.

Upload RBAC Map during configuration
You can also configure RBAC in a new application using an RBAC Map CSV file.
-
On the RBAC page, click Set Up User Access.

-
Enter the Credential Name, select the Credential Method, and enter the required values.

-
Click Save Credentials to create the authentication.

-
When prompted, enter a Role Name for the authentication you created.

-
Click Next.

-
Select the role by checking its checkbox in the Include In Access Test column.

-
Click Upload RBAC Map.

-
Click Browse files and select the RBAC Map file.

-
Click Upload File.

-
Verify and confirm the access permissions for each endpoint.

View RBAC endpoint logs
-
On the RBAC page, switch off Consolidated View to see logs per endpoint.

-
Check the logs.
noteThese logs are only visible after running access checks.
Skip Endpoints for RBAC
Session-sensitive endpoints — such as logout, token revocation, or session invalidation — can terminate active sessions when they run during RBAC testing. Exclude these endpoints from RBAC access checks to keep your session active and avoid false access failures.
Skip endpoints
-
On the RBAC page, click Skip Endpoints.

-
Click Select Endpoints to Skip.

-
Select the endpoint and click Skip Selected Endpoints.

-
View the skipped endpoints list.

Restore skipped endpoints
-
On the RBAC page, click Skip Endpoints.

-
Review the skipped endpoints list.

-
Select the endpoint to restore and click Restore Selected Endpoints.

-
The restored endpoints are available for RBAC access checks.