Skip to main content

How configure RBAC for Application Roles


Open your browser and visit: https://<your-tenant>.apisecapps.com


Visit the application.

  • Click on "See more" to open the application Click See More
  • On the Application details page click the "Configure RBAC" item on the app modal timeline Click configure RBAC

Configure RBAC

  • Click the "Add Authentication" button, enter the "Auth details" and click "Save Credentials" button to create an authentication Click Add Authentication Click Save Authentication
  • You will be prompted to enter a "Role Name" for the authentication that you have just created. Enter the role name and click next to go to the next step. Click start RBAC Click confirm RBAC
  • Enable the role created for RBAC by checking the checkbox for the corresponding role under the "Include for RBAC" column Enable for RBAC
  • Click the "Discover RBAC Permissions" button to discover permissions for the created role discover permissions
  • Review the discovered permissions, make changes where necessary and click the "Start RBAC" button to confirm that the configuration be included for testing RBAC coverage categories from the subsequent scan click Start RBAC click confirm RBAC
  • After successful configuration, you should be redirected back to the application details page where the "RBAC Configured" timeline item should be checked RBAC Confirmed

Edit User Access

The Edit User Access allows to modify the roles assigned to an existing credentials within the RBAC (Role-Based Access Control) and check the access permissions for the updated role.

  • Click on See more to open the application RBAC Confirmed

  • Click RBAC Configuration in Progress in App Model RBAC Confirmed

  • Click Edit User Access RBAC Confirmed

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

  • Update User role and Click Next RBAC Confirmed

  • Click on Include in Access Test check box and Click Run Access Checks RBAC Confirmed

  • Check updated User Role RBAC Confirmed

Re-Run Access Checks

The Re-Run Access Checks allows to re test the selected role access permissons

  • Click on See more to open the application RBAC Confirmed

  • Click RBAC Configuration in Progress in App Model RBAC Confirmed

  • Click Re-Run Access Checks RBAC Confirmed

  • Re check the permissions for the Selected user role. RBAC Confirmed

Re-Test Permissions

The Re-Test permissions allows you to re test the selected endpoint

  • Click on See more to open the application RBAC Confirmed

  • Click RBAC Configuration in Progress in App Model RBAC Confirmed

  • Disable the consolidated view RBAC Confirmed

  • Click on options of the endpoint and select Retest Permissions to perform re testing the permissions for the selected endpoint. RBAC Confirmed

RBAC Map

The RBAC (Role-Based Access Control) Map helps you quickly verify which API endpoints are accessible for a selected role or roles.

  • Download RBAC Map

    • Click on See more to open the application RBAC Confirmed

    • Click RBAC Configuration in Progress in App Model RBAC Confirmed

    • Click RBAC Map → Download RBAC Map. You can edit and update this CSV file and upload it to quickly verify role-based access permissions. RBAC Confirmed

  • Upload RBAC Map

    • Click on See more to open the application RBAC Confirmed

    • Click RBAC Configuration in Progress in App Model RBAC Confirmed

    • Click RBAC Map → Upload RBAC Map RBAC Confirmed

    • Click Browse files and upload the RBAC Map RBAC Confirmed

    • Click Upload File RBAC Confirmed

    • Verify and confirm the Access Permissions for each endpoint RBAC Confirmed

  • Upload RBAC Map During Configuration

    You can also configure RBAC in a new application using a RBAC Map CSV file.

    • Click on "See more" to open the application Click See More

    • On the Application details page click the "Configure RBAC" on the app modal timeline Click configure RBAC

    • Click the "Set Up User Access", enter the details and click "Save Credentials" to create an authentication Click configure RBAC Click configure RBAC

    • You will be prompted to enter a "Role Name" for the authentication that you have just created. Enter the role name and click next to go to the next step. Click configure RBAC

    • Enable the role created for RBAC by checking the checkbox for the corresponding role under the "Include for RBAC" column Click configure RBAC

    • Click Upload RBAC Map Click configure RBAC

    • Click Browse files and upload the RBAC Map Click configure RBAC

    • Click Upload File Click configure RBAC

    • Verify and confirm the Access Permissions for each endpoint Click configure RBAC

Viewing RBAC endpoint logs

To check logs for each endpoint, switch off Consolidated View.

  • Switch off Consolidate View Click configure RBAC

  • Check Logs Click configure RBAC

    note

    These logs are only visible after running access checks.